NeveTimePanel/DEBUG_GUIDE.md

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

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

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

### Диагностика

1. **Проверьте логи бэкенда** (терминал где запущен `python main.py`):
   ```
   Сервер test_server запущен с PID 12345
   Начало чтения вывода для сервера test_server
   ```

2. **Проверьте консоль браузера** (F12):
   ```javascript
   // Должны быть логи:
   Сервер запущен: {message: "Сервер запущен", pid: 12345}
   ```

3. **Проверьте, запустился ли Java процесс**:
   ```bash
   # 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. Проверьте установку:
   ```bash
   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. Проверьте логи бэкенда на наличие ошибок

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

### Проверка портов
```bash
# Windows
netstat -ano | findstr :8000
netstat -ano | findstr :3000
```

### Проверка процессов Java
```bash
# 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. **Команда запуска** из настроек сервера