DiscordWhitelist

Плагин связывает Discord-сервер с игровым сервером Minecraft, позволяя игрокам самостоятельно добавляться в вайтлист через текстовые сообщения.

WhitelistBot автоматизирует процесс входа игроков на сервер, избавляя администраторов от необходимости вручную прописывать каждый никнейм. Система работает по принципу «отправил сообщение — получил доступ»: игрок пишет свой никнейм в выделенный канал Discord, а бот мгновенно добавляет его в игровой белый список.

✨ Основные возможности

Плагин обеспечивает полную автоматизацию взаимодействия между платформами:

• 📨 Связка Discord → Minecraft: игроки отправляют никнеймы в канал, бот обрабатывает данные и выполняет команду добавления.
• 🔒 Уникальность аккаунтов: система гарантирует регистрацию только одного никнейма на один аккаунт Discord, используя базу данных SQLite.
• ✅ Интеллектуальная валидация: бот автоматически проверяет сообщения на наличие недопустимых символов, наличие игрока в текущем вайтлисте и занятость никнейма.
• 🎨 Цветовая индикация: бот отправляет в Discord информативные эмбеды с разным оформлением в зависимости от результата операции.

📋 Ответы бота в Discord

⚙️ Настройка и конфигурация

Для начала работы необходимо создать приложение на портале разработчиков Discord, получить токен бота и включить привилегированные интенты (Message Content Intent). Также потребуется скопировать ID сервера и ID целевого канала.

⚠️ Важное требование к Java:

• Для версий 1.18–1.19 требуется Java 17 или выше.
• Для версий 1.20+ требуется Java 21 или выше.

Этапы запуска

1. Создайте бота на discord.com/developers/applications и получите токен.
2. Включите Message Content Intent в настройках бота.
3. Сгенерируйте ссылку для приглашения с правами Read Messages и Send Messages.
4. Скопируйте ID сервера и ID канала (требуется Developer Mode в Discord).
5. Отредактируйте config.yml, указав токен бота, ID гильдии и ID канала.
6. При первом запуске откройте веб-панель по адресу http://ваш_ip:8080, используя пароль из файла webpage.yml.

🌐 Веб-панель управления

Встроенная веб-панель позволяет администраторам управлять записями без использования консоли сервера. Интерфейс поддерживает поиск по Discord ID или никнейму, добавление записей напрямую и удаление пользователей (автоматически выполняет команду /whitelist remove). Доступ защищен паролем, который хранится в файле webpage.yml.

🔧 Команды и права доступа

discord:
  bot-token: "YOUR_BOT_TOKEN_HERE"
  guild-id: "YOUR_GUILD_ID_HERE"
  channel-id: "YOUR_CHANNEL_ID_HERE"

🗄️ База данных

Все данные о пользователях хранятся в файле plugins/WhitelistBot/whitelist.db в формате SQLite. Администратор может открыть этот файл через стороннее приложение (например, DB Browser for SQLite) для ручного просмотра или редактирования записей. В базе сохраняются Discord ID, никнейм игрока и метка времени добавления.