🔧 Инструкция для администраторов SomnexBot
Полное руководство по администрированию бота вайт-листа Minecraft сервера.
👥 Роли и права доступа
В боте существует три роли пользователей:
| Роль | Права | Кто назначает |
|---|---|---|
| User | Подача заявок, проверка статуса | Автоматически |
| Admin | + Управление вайт-листом, обработка заявок, RCON (ограниченно) | Суперадмин |
| Superadmin | + Управление админами, все RCON команды, редактирование текстов | Через .env |
Первоначальная настройка ролей
Суперадмины и админы указываются в файле .env при первом запуске:
env
INITIAL_SUPERADMINS=123456789,987654321
INITIAL_ADMINS=111222333,444555666💡 Telegram ID можно узнать через @userinfobot
🛠 Доступ к админ-панели
Как открыть
- Отправьте
/startботу (если ещё не делали) - В главном меню нажмите 🛠 Админ-панель
Меню админ-панели (Admin)
📋 Вайт-лист 🔍 Поиск заявки 📜 Необработанные
📊 Мониторинг 🖥 RCON Консоль
📢 Отправить сообщение в группу
⬅️ Выход в главное менюДополнительные кнопки (Superadmin)
👥 Управление админами ⚙️ Настройка RCON
✏️ Ред. ТекстовНавигация
| Кнопка | Действие |
|---|---|
| ⬅️ Назад в админ-меню | Вернуться в админ-панель |
| ⬅️ Выход в главное меню | Вернуться в главное меню пользователя |
📝 Обработка заявок
Способ 1: Уведомление в группе
При подаче новой заявки в админ-группу приходит уведомление:
🔔 Новая заявка #42 🕒 Pending
👤 Имя: Александр
🎮 Ник: CoolPlayer123
👤 TG Username: @alex_player
📅 Подана: Только что
[👀 Рассмотреть]Нажмите "Рассмотреть" — откроется личный чат с ботом с полной информацией.
Способ 2: Кнопка "Необработанные"
- Откройте 🛠 Админ-панель
- Нажмите 📜 Необработанные
- Бот покажет все заявки со статусом
Pending
Способ 3: Поиск заявки
- Нажмите 🔍 Поиск заявки
- Введите параметр поиска:
123— ID заявкиCoolPlayer123— никнейм@username— Telegram username12345678— Telegram ID
Карточка заявки
📋 Заявка #42 🕒 Pending
👤 Имя: Александр
🎮 Ник: CoolPlayer123
📅 Возраст: 20
💬 Причина: Хочу играть с друзьями
🆔 TG ID: 123456789
👤 TG Username: @alex_player
📅 Подана: 10.12.2024 15:30
✅ Обработана: -
🔁 Повторная заявка (всего заявок: 3)
[✅ Одобрить] [❌ Отклонить]
[📋 История заявок]Одобрение заявки
- Нажмите ✅ Одобрить
- Бот автоматически:
- Добавит пользователя в вайт-лист
- Отправит уведомление пользователю
- Удалит уведомление из админ-группы
- Пометит заявку как обработанную
Отклонение заявки
- Нажмите ❌ Отклонить
- Введите причину отклонения
- Бот:
- Отправит пользователю отказ с указанной причиной
- Удалит уведомление из админ-группы
- Пометит заявку как отклонённую
Примеры причин:
- "Недостаточно информации о себе"
- "Некорректный никнейм"
- "Возрастное ограничение"
- "Подозрение на мультиаккаунт"
Просмотр истории заявок
Если пользователь подавал заявки ранее, появится кнопка 📋 История заявок.
Нажмите её, чтобы увидеть все предыдущие заявки этого пользователя с пагинацией.
📋 Управление вайт-листом
Открытие меню
- 🛠 Админ-панель → 📋 Вайт-лист
Меню вайт-листа
📜 Список (Пагинация)
➕ Добавить игрока ➖ Выключить игрока
✅ Включить игрока ❌ Удалить навсегда
⬅️ Назад в админ-меню📜 Просмотр списка
Нажмите 📜 Список (Пагинация).
Бот покажет вайт-лист по 10 записей на странице:
📋 Вайт-лист (Стр. 1)
👤 Имя на сервере: CoolPlayer123 🟢 Активен
├ 🆔 UUID: a1b2c3d4...
├ 🔗 TG: 123456789 (@alex_player)
├ 📋 Последняя заявка #42: Александр (10.12.2024)
👤 Имя на сервере: BadPlayer666 🔴 Заблокирован
├ 🆔 UUID: e5f6g7h8...
├ 🔗 TG: 987654321 (@bad_guy)
[⬅️ Назад] [Вперед ➡️]Статусы:
- 🟢 Активен — игрок может заходить на сервер
- 🔴 Заблокирован — доступ запрещён
➕ Добавить игрока
Добавление игрока в вайт-лист вручную (без заявки).
- Нажмите ➕ Добавить игрока
- Введите Telegram ID игрока
- Введите желаемый никнейм
⚠️ Если пользователь не запускал бота, будет создан пустой профиль.
➖ Выключить игрока
Временная деактивация (Whitelisted = 0). Игрок не сможет зайти на сервер, но данные сохраняются.
- Нажмите ➖ Выключить игрока
- Введите никнейм игрока
- Игроку придёт уведомление о блокировке
Когда использовать:
- Временный бан
- Подозрение на нарушение правил
- Пауза доступа
✅ Включить игрока
Повторная активация ранее заблокированного игрока (Whitelisted = 1).
- Нажмите ✅ Включить игрока
- Введите никнейм игрока
❌ Удалить навсегда
НЕОБРАТИМОЕ удаление игрока из базы данных.
- Нажмите ❌ Удалить навсегда
- Введите никнейм игрока
Что происходит:
- Запись удаляется из
noble_whitelist - Связь с Telegram ID разрывается
- Игроку приходит уведомление
- Пользователь может подать новую заявку
⚠️ Внимание: Используйте только при полном удалении игрока! Для временной блокировки используйте "Выключить игрока".
🖥 RCON консоль
Открытие консоли
- 🛠 Админ-панель → 🖥 RCON Консоль
- Бот покажет список разрешённых команд
- Вводите команды в чат
Разница прав
| Роль | Доступные команды |
|---|---|
| Admin | Только команды из списка разрешённых |
| Superadmin | Любые команды без ограничений |
Примеры команд
| Команда | Описание |
|---|---|
list | Список онлайн игроков |
tps | Показать TPS сервера |
gc | Информация о памяти |
say <сообщение> | Отправить сообщение в чат сервера |
tell <ник> <сообщение> | Личное сообщение игроку |
whitelist list | Список вайт-листа (плагин) |
kick <ник> | Кикнуть игрока |
ban <ник> | Забанить игрока |
pardon <ник> | Разбанить игрока |
Выход из консоли
- Отправьте
exit - Или нажмите ⬅️ Назад в админ-меню
📊 Мониторинг сервера
Ручной мониторинг
- 🛠 Админ-панель → 📊 Мониторинг
- Бот покажет текущий статус:
📊 Статус Сервера:
🔹 TPS: 20.0, 20.0, 20.0
🔸 RAM: Used: 2048MB / Free: 4096MBАвтоматический мониторинг
Бот каждый час автоматически проверяет сервер:
| Событие | Действие |
|---|---|
| RCON недоступен | Алерт в админ-группу: "🚨 CRITICAL: Сервер RCON недоступен!" |
| TPS < 15 | Предупреждение с информацией о TPS и памяти |
📢 Отправка сообщений в группу
- 🛠 Админ-панель → 📢 Отправить сообщение в группу
- Напишите сообщение (поддерживается HTML-форматирование)
- Сообщение будет отправлено в админ-группу с подписью отправителя
Пример:
📣 Сообщение от Иван Администратор:
Сегодня в 20:00 будет рестарт сервера!👑 Функции суперадмина
Эти функции доступны только пользователям с ролью Superadmin.
👥 Управление админами
- 🛠 Админ-панель → 👥 Управление админами
- Бот покажет список текущих админов:
👥 Администраторы:
• ID: 123456789 | Иван | Role: Superadmin
• ID: 987654321 | Мария | Role: Admin
[➕ Добавить] [➖ Удалить]Добавить админа
- Нажмите ➕ Добавить
- Введите Telegram ID пользователя
- Пользователь получит роль Admin
Удалить админа
- Нажмите ➖ Удалить
- Введите Telegram ID пользователя
- Роль станет User
⚙️ Настройка RCON
Управление списком разрешённых команд для обычных админов.
- 🛠 Админ-панель → ⚙️ Настройка RCON
- Бот покажет текущий список:
⚙️ Разрешенные команды RCON:
list, tps, gc, whitelist
[➕ Добавить] [➖ Удалить]Добавить команду
- Нажмите ➕ Добавить
- Введите название команды (например:
say) - Теперь все админы смогут использовать эту команду
Удалить команду
- Нажмите ➖ Удалить
- Введите название команды
- Команда станет недоступна для обычных админов
💡 Совет: Добавляйте только безопасные команды. Например,
kick— рискованно,list— безопасно.
✏️ Редактирование текстов
Изменение системных текстов бота.
- 🛠 Админ-панель → ✏️ Ред. Текстов
- Выберите текст для редактирования:
| Текст | Где отображается |
|---|---|
| Приветствие (/start) | Сообщение при запуске бота |
| Правила (Rules) | Кнопка "📜 Правила" |
| Информация (Info) | Кнопка "ℹ️ Информация" |
- Бот покажет текущий текст
- Отправьте новый текст (поддерживается HTML)
Пример HTML-форматирования:
html
<b>Жирный текст</b>
<i>Курсив</i>
<code>Код</code>
<a href="https://example.com">Ссылка</a>📚 Справочник команд
Кнопки главного меню (Admin+)
| Кнопка | Описание |
|---|---|
| 📝 Подать заявку | Перенаправляет пользователя |
| 📊 Статус заявки | Перенаправляет пользователя |
| ℹ️ Информация | Показывает информацию |
| 📜 Правила | Показывает правила |
| 🛠 Админ-панель | Открывает админ-меню |
Кнопки админ-панели
| Кнопка | Роль | Описание |
|---|---|---|
| 📋 Вайт-лист | Admin+ | Управление вайт-листом |
| 🔍 Поиск заявки | Admin+ | Поиск по любому параметру |
| 📜 Необработанные | Admin+ | Список Pending заявок |
| 📊 Мониторинг | Admin+ | TPS и RAM сервера |
| 🖥 RCON Консоль | Admin+ | Выполнение команд на сервере |
| 📢 Сообщение в группу | Admin+ | Отправка в админ-чат |
| 👥 Управление админами | Superadmin | Добавить/удалить админов |
| ⚙️ Настройка RCON | Superadmin | Разрешённые команды |
| ✏️ Ред. Текстов | Superadmin | Приветствие, правила, инфо |
| ⬅️ Выход | Admin+ | Вернуться в главное меню |
Кнопки вайт-листа
| Кнопка | Описание |
|---|---|
| 📜 Список (Пагинация) | Весь вайт-лист с пагинацией |
| ➕ Добавить игрока | Ручное добавление |
| ➖ Выключить игрока | Деактивация (Whitelisted=0) |
| ✅ Включить игрока | Активация (Whitelisted=1) |
| ❌ Удалить навсегда | Полное удаление из БД |
| ⬅️ Назад | Вернуться в админ-меню |
📋 Сценарии использования
Сценарий 1: Полный цикл обработки заявки
- Пользователь подаёт заявку через бота
- В админ-группу приходит уведомление с кнопкой "Рассмотреть"
- Админ нажимает "Рассмотреть" — открывается ЛС с карточкой заявки
- Админ проверяет данные:
- Имя и возраст
- Корректность никнейма
- Причину вступления
- Историю предыдущих заявок (если есть)
- Админ принимает решение:
- ✅ Одобрить — игрок автоматически добавляется в вайт-лист
- ❌ Отклонить — требуется указать причину
- Пользователь получает уведомление о решении
- Уведомление в группе автоматически удаляется
Сценарий 2: Блокировка игрока за нарушение
- 🛠 Админ-панель → 📋 Вайт-лист → ➖ Выключить игрока
- Введите никнейм нарушителя
- Игрок получает уведомление о блокировке
- Игрок больше не может зайти на сервер
- При попытке подать новую заявку — игрок увидит сообщение о блокировке
Сценарий 3: Разблокировка игрока
- 📋 Вайт-лист → ✅ Включить игрока
- Введите никнейм
- Доступ восстановлен
Сценарий 4: Полное удаление игрока
- 📋 Вайт-лист → ❌ Удалить навсегда
- Введите никнейм
- Игрок удалён из базы
- Игрок получает уведомление, что может подать новую заявку
Сценарий 5: Добавление VIP-игрока без заявки
- 📋 Вайт-лист → ➕ Добавить игрока
- Введите Telegram ID игрока
- Введите желаемый никнейм
- Игрок сразу в вайт-листе
Сценарий 6: Экстренная проверка сервера
- 🛠 Админ-панель → 📊 Мониторинг
- Если TPS низкий — откройте 🖥 RCON Консоль
- Выполните
gcдля проверки памяти - При необходимости:
kick <ник>для кика проблемных игроков
Сценарий 7: Объявление в админ-группу
- 📢 Отправить сообщение в группу
- Напишите объявление:html
<b>🔧 Технические работы</b> Сегодня в 22:00 будет рестарт сервера. Примерное время простоя: 10 минут. - Сообщение отправится в группу с вашей подписью
❓ Устранение проблем
Бот не отвечает
- Проверьте что бот запущен:
docker-compose logs bot - Проверьте токен бота в
.env - Убедитесь что у вас есть роль Admin/Superadmin
RCON ошибка
Симптом: "Ошибка RCON: Connection refused"
Решение:
- Проверьте
RCON_HOSTиRCON_PORTв.env - Убедитесь что в
server.properties:enable-rcon=true rcon.port=25575 rcon.password=ваш_пароль - Проверьте что сервер запущен
- Проверьте файрвол
Команда запрещена
Симптом: "⛔ Вам запрещено выполнять эту команду"
Решение: Попросите суперадмина:
- Открыть ⚙️ Настройка RCON
- Добавить нужную команду в список разрешённых
Заявка не приходит в группу
- Проверьте
ADMIN_CHAT_IDв.env - Убедитесь что бот — администратор группы
- ID группы должен начинаться с
-100
Нет кнопки "Админ-панель"
- Убедитесь что ваш TG ID в
.env(INITIAL_ADMINSилиINITIAL_SUPERADMINS) - Перезапустите бота
- Отправьте
/start
Игрок не может зайти после одобрения
- Проверьте что плагин NobleWhitelist установлен и работает
- Проверьте таблицу
noble_whitelistв базе данных - Убедитесь что никнейм совпадает (с учётом регистра)
📞 Контакты разработчика
При технических проблемах обращайтесь к Telegram