NeveTimePanel/DEBUG_GUIDE.md

Руководство по отладке проблем

Проблема: После запуска сервера пропадают файлы/настройки/статистика

Причина

Процесс сервера блокирует выполнение или завершается с ошибкой.

Диагностика

1. Проверьте логи бэкенда (терминал где запущен python main.py):

   Сервер test_server запущен с PID 12345
   Начало чтения вывода для сервера test_server
   

2. Проверьте консоль браузера (F12):

   // Должны быть логи:
   Сервер запущен: {message: "Сервер запущен", pid: 12345}
   

3. Проверьте, запустился ли Java процесс:

   # Windows
   tasklist | findstr java
   
   # Должен показать процесс java.exe
   

4. Проверьте наличие server.jar:

   • Откройте папку backend/servers/ИМЯ_СЕРВЕРА/
   • Убедитесь, что там есть файл server.jar или другой .jar файл
   • Проверьте команду запуска в настройках сервера

Решение

Если server.jar отсутствует:

1. Скачайте server.jar для Minecraft
2. Загрузите через менеджер файлов в панели
3. Убедитесь, что команда запуска правильная

Если Java не установлена:

1. Установите Java 17 или новее
2. Проверьте установку:

   java -version
   

Если процесс запускается но сразу завершается:

1. Проверьте логи в консоли панели
2. Возможно нужно принять EULA:
   • Откройте файл eula.txt через редактор в панели
   • Измените eula=false на eula=true
   • Сохраните и перезапустите сервер

Если команда запуска неправильная:

1. Перейдите в Настройки сервера
2. Измените команду запуска, например:

   java -Xmx2G -Xms1G -jar server.jar nogui
   

3. Сохраните настройки
4. Запустите сервер

Проблема: Сервер не останавливается

Причина

Процесс не отвечает на команду stop.

Решение

1. Через панель: Подождите 30 секунд, процесс будет принудительно завершен

2. Вручную через Task Manager:

   • Откройте Диспетчер задач (Ctrl+Shift+Esc)
   • Найдите процесс java.exe
   • Завершите процесс
   • Обновите страницу панели

Проблема: Консоль не показывает логи

Причина

WebSocket не подключается или процесс не выводит логи.

Диагностика

1. Проверьте консоль браузера:

   WebSocket подключен
   

2. Проверьте логи бэкенда:

   WebSocket подключен для сервера: test_server
   Отправка X существующих логов
   

Решение

1. Перезапустите сервер
2. Обновите страницу панели (F5)
3. Проверьте, что сервер действительно запущен

Проблема: Статистика показывает неправильный статус

Причина

Процесс завершился, но панель не обновилась.

Решение

1. Обновите страницу (F5)
2. Статус обновляется автоматически каждые 5 секунд
3. Проверьте логи бэкенда на наличие ошибок

Полезные команды для отладки

Проверка портов

# Windows
netstat -ano | findstr :8000
netstat -ano | findstr :3000

Проверка процессов Java

# Windows
tasklist | findstr java

# Убить все процессы Java (ОСТОРОЖНО!)
taskkill /F /IM java.exe

Очистка и перезапуск

1. Остановите все серверы в панели
2. Закройте бэкенд (Ctrl+C)
3. Закройте фронтенд (Ctrl+C)
4. Убейте все процессы Java если нужно
5. Запустите бэкенд заново
6. Запустите фронтенд заново
7. Обновите страницу в браузере

Логи для отправки при обращении за помощью

Если проблема не решается, соберите следующую информацию:

1. Логи бэкенда (последние 50 строк из терминала)
2. Консоль браузера (F12 → Console, скриншот или текст)
3. Network вкладка (F12 → Network, покажите неудачные запросы)
4. Содержимое папки сервера (список файлов)
5. Команда запуска из настроек сервера