WhiteListe Bot
Что такое WhiteListe Bot?
WhiteListe Bot — это плагин для серверов Minecraft, который объединяет внутриигровой вайтлист с полноценным Discord-ботом. Больше не нужно вручную прописывать команды в консоли или следить за заявками в чате. Игроки подают запросы прямо в Discord, а администраторы управляют ими через удобные кнопки и модальные окна. Плагин работает на Paper, Spigot и Purpur, начиная с версии 1.20.1, и требует Java 17 или новее. Вся логика выполняется внутри одного JAR-файла — никаких внешних приложений или скриптов.
Основные возможности
WhiteListe Bot для Minecraft предлагает не просто автоматизацию, а целый набор инструментов для комфортного администрирования. Вот что вы получаете сразу после установки:
Discord-интеграция с интерактивными элементами
Бот использует современный интерфейс Discord: встроенные сообщения (embed), кнопки для одобрения или отказа, модальные окна для ввода никнейма. Игроку достаточно нажать одну кнопку, чтобы отправить заявку. Администраторы видят все запросы в специальном канале и могут обрабатывать их парой кликов. Никаких путаниц с командами — всё визуально и понятно.
Тикет-система и защита от спама
Когда заявка требует уточнений, WhiteListe Bot создаёт приватный тикет-канал. Там модератор и игрок обсуждают детали, не засоряя общие чаты. После решения вопроса канал автоматически удаляется или архивируется. Встроенная защита от дубликатов не даёт одному пользователю подать несколько заявок, а проверка через NameMC подтверждает подлинность аккаунта. Все действия логируются — вы всегда знаете, кто и когда изменил статус запроса.
Поддерживаемые версии и загрузчики
Плагин официально протестирован на Paper 1.20.1, 1.20.4, 1.20.6 и полностью совместим с веткой 1.21.x. Вы можете использовать Spigot или Purpur — разницы в работе нет. Главное требование — JDK 17, поскольку JDA (библиотека для Discord) и Paper API ориентированы на современную Java. Дополнительная оперативная память для бота минимальна: около 50 МБ, что незаметно даже на небольших хостингах.
Как установить WhiteListe Bot
Процесс установки прост, но требует внимания к Discord-части. Ниже пошаговая инструкция, которая поможет быстро запустить плагин.
Скачать WhiteListe Bot
Самый надёжный способ — скачать WhiteListe Bot с официальной страницы релизов на GitHub. Найдите последнюю версию JAR-файла (обычно около 50–60 МБ, так как внутри уже упакованы все зависимости). Если вы предпочитаете собирать из исходников, клонируйте репозиторий и выполните mvn clean package — готовый файл появится в папке target. Для быстрой установки на сервер просто поместите JAR в директорию plugins/ и перезапустите сервер. После первого запуска создадутся конфигурационные файлы, которые нужно будет заполнить.
Кстати, если вы пользуетесь лаунчером foxygame.net, установка WhiteListe Bot становится ещё проще — каталог дополнений лаунчера позволяет добавить плагин в один клик, а автообновление гарантирует, что вы всегда будете на актуальной версии. Это особенно удобно для тех, кто не хочет вручную отслеживать релизы.
Настройка Discord-бота
Чтобы WhiteListe Bot заработал, нужно создать приложение на Discord Developer Portal. Зайдите в раздел «Bot», скопируйте токен и включите необходимые интенты: MESSAGE_CONTENT_INTENT, GUILD_MESSAGES и GUILD_MEMBERS. Затем пригласите бота на сервер с правами: управление каналами, управление разрешениями, просмотр каналов, отправка сообщений, встраивание ссылок и использование слеш-команд. Ссылка для приглашения формируется автоматически — достаточно подставить ID вашего бота.
Настройка конфигурации
После первого запуска плагина откройте файл plugins/WhiteListBot/config.yml. Обязательные поля: токен бота, ID канала для запросов, ID админского канала, ID категории для тикетов и список ролей, которым разрешено управлять заявками. Если оставить список ролей пустым, любой пользователь сможет одобрять запросы — так делать не стоит. Дополнительно можно настроить тексты уведомлений, префикс логов и даже включить отладку SQL-запросов для поиска проблем.
Использование и команды
Когда всё настроено, игроки видят в Discord канал с кнопкой «Подать заявку». После ввода Minecraft-никнейма запрос появляется в админском канале со статусом «Pending». Администратор нажимает «Approve» — и плагин автоматически добавляет игрока в вайтлист сервера, а также отправляет личное сообщение в Discord. Отказ работает аналогично. Если нужно уточнить данные, кнопка «Ticket» создаёт приватный канал, где можно попросить скриншоты или ссылку на NameMC.
Для администраторов доступна слеш-команда /lookup, которая ищет связанные Discord-аккаунты по никнейму Minecraft. Это удобно, когда нужно быстро проверить, кто стоит за определённым запросом. Все действия логируются в консоли с префиксом [WhitelistBot], а база данных SQLite хранит историю заявок локально в файле whitelist.db.
Заключение
WhiteListe Bot — это не просто плагин, а полноценный мост между вашим сервером Minecraft и сообществом в Discord. Он убирает рутину, защищает от спама и делает процесс приёма игроков прозрачным. Благодаря поддержке современных версий Paper и Spigot, а также удобной интеграции с лаунчерами вроде foxygame.net, вы получаете готовое решение, которое работает «из коробки». Скачайте WhiteListe Bot, настройте роли и забудьте о головной боли с вайтлистом — теперь всё под контролем.