# 🚀 Быстрый старт MC Panel

## Первый запуск

### Вариант 1: Автоматический запуск (Windows)

Просто запустите файл:
```
START_PANEL.bat
```

Откроются два окна:
- **MC Panel Backend** - бэкенд сервер
- **MC Panel Frontend** - фронтенд сервер

Подождите 10-15 секунд и откройте в браузере:
```
http://localhost:3000
```

### Вариант 2: Ручной запуск

**Терминал 1 - Бэкенд:**
```bash
cd backend
python main.py
```

**Терминал 2 - Фронтенд:**
```bash
cd frontend
npm run dev
```

## Создание первого сервера

1. Нажмите кнопку **"+"** в левой панели
2. Заполните форму:
   - **Имя папки**: `my_server` (только латиница)
   - **Отображаемое имя**: `Мой сервер`
   - **Команда запуска**: `java -Xmx2G -Xms1G -jar server.jar nogui`
3. Нажмите **"Создать"**

## Загрузка файлов сервера

1. Выберите созданный сервер в списке
2. Перейдите на вкладку **"Файлы"**
3. Нажмите **"Загрузить"**
4. Выберите `server.jar` (скачайте с официального сайта Minecraft)
5. Если нужно, создайте файл `eula.txt`:
   - Нажмите **"Загрузить"**
   - Создайте текстовый файл с содержимым: `eula=true`
   - Загрузите его

## Запуск сервера

1. Нажмите кнопку **"Старт"** на карточке сервера
2. Перейдите на вкладку **"Консоль"** чтобы видеть логи
3. Дождитесь сообщения `Done!` в консоли
4. Сервер готов к подключению!

## Управление сервером

### Консоль
- Просмотр логов в реальном времени
- Отправка команд серверу
- Примеры команд: `list`, `say Hello`, `stop`

### Файлы
- Просмотр и редактирование конфигов
- Загрузка плагинов/модов
- Скачивание файлов
- Переименование и удаление

### Статистика
- Использование CPU
- Потребление ОЗУ
- Размер на диске
- Статус сервера

### Настройки
- Изменение отображаемого имени
- Настройка команды запуска
- Удаление сервера

## Доступ через сеть (Radmin VPN)

### На вашем компьютере:

1. Узнайте ваш IP в Radmin VPN:
   ```bash
   ipconfig
   ```
   Ищите адаптер Radmin VPN (обычно `26.x.x.x`)

2. Запустите панель как обычно

3. Откройте в браузере:
   ```
   http://localhost:3000
   ```

### На компьютере друга:

1. Откройте в браузере:
   ```
   http://ВАШ_RADMIN_IP:3000
   ```
   Например: `http://26.62.117.104:3000`

2. Панель автоматически подключится к вашему бэкенду

### Если не работает:

Откройте порты в брандмауэре Windows (от имени администратора):
```powershell
netsh advfirewall firewall add rule name="MC Panel Backend" dir=in action=allow protocol=TCP localport=8000
netsh advfirewall firewall add rule name="MC Panel Frontend" dir=in action=allow protocol=TCP localport=3000
```

## Типичные проблемы

### Java не найдена

**Ошибка:** `'java' is not recognized...`

**Решение:**
1. Установите Java 17+: https://adoptium.net/
2. Перезапустите терминал
3. Проверьте: `java -version`

### Сервер не запускается

**Причины:**
- Отсутствует `server.jar`
- Не принят EULA
- Неправильная команда запуска

**Решение:**
1. Проверьте наличие `server.jar` в файлах
2. Создайте `eula.txt` с содержимым `eula=true`
3. Проверьте команду запуска в настройках

### Порт уже занят

**Ошибка:** `Address already in use`

**Решение:**
```bash
# Найти процесс на порту 8000
netstat -ano | findstr :8000

# Убить процесс (замените PID)
taskkill /F /PID <PID>
```

### Не видно файлов/настроек

**Решение:**
1. Откройте консоль браузера (F12)
2. Проверьте вкладку Network на ошибки
3. Обновите страницу (F5)
4. Перезапустите бэкенд

## Полезные ссылки

- **Скачать Minecraft Server**: https://www.minecraft.net/en-us/download/server
- **Документация Minecraft**: https://minecraft.fandom.com/wiki/Server
- **Java Download**: https://adoptium.net/
- **Radmin VPN**: https://www.radmin-vpn.com/

## Команды Minecraft

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

```
list                    # Список игроков
say <message>          # Сообщение всем
kick <player>          # Кикнуть игрока
ban <player>           # Забанить игрока
op <player>            # Дать права оператора
deop <player>          # Забрать права оператора
whitelist add <player> # Добавить в белый список
stop                   # Остановить сервер
```

## Конфигурационные файлы

Основные файлы для редактирования:

- **server.properties** - основные настройки сервера
- **eula.txt** - принятие лицензии
- **ops.json** - список операторов
- **whitelist.json** - белый список игроков
- **banned-players.json** - забаненные игроки

Редактируйте их через вкладку "Файлы" в панели!

---

**Готово!** Теперь у вас есть полноценная панель управления Minecraft серверами! 🎮