Discord Role Sync

Discord Role Sync - плагин для Майнкрафт, который решает извечную проблему админов: ручную выдачу прав. Больше не нужно добавлять каждого игрока в LuckPerms руками. Выдали роль в Дискорде? Плагин сам прочитает её и применит нужную группу в игре. Это односторонняя синхронизация: из Discord в Minecraft. Идеально для серверов с донатом, где привилегии покупаются через сайты, завязанные на боте, или просто для удобного управления составом.

Главные фишки

• Синхронизация групп - выдал роль VIP в Дискорде, игрок получил группу VIP на сервере.
• Вайтлист по ролям - на сервер пускает только тех, у кого есть нужная роль.
• Обновление ников - плагин может менять ники в Дискорде на майнкрафт-ники.
• Поддержка PlaceholderAPI - выводи инфу о линке в скорборд.
• Поддержка Geyser - игроки с Bedrock (ник с точкой) тоже могут линковаться.

Как установить и настроить

Тут не обойтись без Vault и плагина на права. Лучше всего брать LuckPerms. Нет Vault - плагин просто не запустится. Java 11 минимум, хотя на 8-й тоже работает, но без поддержки.

Кидаем .jar в папку plugins, запускаем сервер. Он ругнется на пустой конфиг, это норма. Дальше идем в config.yml и вставляем токен бота.

Важный нюанс: обязательно включите Server Members Intent в настройках бота на сайте разработчиков. Без этого бот не увидит участников сервера и ничего работать не будет. В конфиге используем ID ролей (циферки), а не названия. Включите режим разработчика в Дискорде, чтобы копировать ID.

Как пользоваться

Игрокам нужно написать в Дискорде /link мойНикВМайне. Пока они на сервере, роли будут синхронизироваться. Админы могут принудительно привязать аккаунт через /admlink discordID ник. Есть и /unlink для отвязки. Если чел выходит из Дискорда - его выкидывает из вайтлиста и снимают все права.

База данных и хостинг

Плагин юзает SQLite из коробки, но для больших проектов строго рекомендую MySQL. Если захотите поиграть с друзьями онлайн, плагин легко встанет на BungeeHost (https://bungee.host) - установка там в один клик, а стабильность MySQL базы не даст базе полететь при онлайне.

Совместимость и плагины на права

Плагин тестировался на версиях Minecraft 1.8.8 - 1.21. Работает с:

• LuckPerms (топ выбор)
• Ultra Permissions
• PermissionsEx (устарел, не советую, будут лаги на больших серверах)
• PowerRanks

Известные проблемы и советы

• В оффлайн-режиме (пиратка) ники чувствительны к регистру. Ivan и ivan - разные игроки.
• Если юзаете плагины на авторизацию (типа AuthMe), могут быть конфликты с UUID. В конфиге попробуйте userUUIDMode FALLBACK или MANUAL.
• При переходе с пиратки на лицуху (или наоборот) нужно снести базу. Для SQLite сносим database.db, для MySQL выполняем DROP TABLE syncbot_discordmcusers;.

Пермишены и команды

• /drs reload - перезагрузка конфига (нужен discordrolesync.reload)
• /drs botrestart - рестарт бота (discordrolesync.botrestart)
• /drs verify - команда для верификации (доступна всем)
• discordrolesync.bypasswhitelist - обход вайтлиста для админов.

Плагин переведен на кучу языков, включая русский. Пишите в конфиге ru_RU и пользуйтесь.