Discord Role Sync

Плагин обеспечивает одностороннюю синхронизацию ролей из Discord в группы прав Minecraft. Пользователи получают права автоматически при получении роли в Discord.

Discord Role Sync — это плагин для Minecraft, предназначенный для автоматической синхронизации ролей Discord с группами прав и белым списком сервера. Синхронизация работает исключительно в одну сторону: данные передаются из Discord в Minecraft, что позволяет мгновенно обновлять права пользователя при изменении его статуса в Discord-сообществе.

Плагин управляет списком ролей Discord, которые можно связать с конкретными группами прав. Если пользователю добавляется роль, он автоматически включается в соответствующую группу в игре; при удалении роли из Discord он также исключается из группы прав.

Для хранения данных плагин поддерживает две системы: SQLite, которая создается автоматически и не требует предварительной настройки, и MySQL, которая рекомендуется для обеспечения стабильности на крупных серверах с высокой нагрузкой.

Основной функционал проекта включает в себя несколько ключевых возможностей, которые можно активировать или отключить в конфигурационном файле:

• Синхронизация ролей из Discord с группами прав Minecraft.
• Управление доступом к серверу через белый список (whitelist), привязанный к ролям Discord.
• Автоматическое обновление Discord-никнеймов пользователей на основе их игровых имен.
• Интеграция с PlaceholderAPI для расширенного отображения данных.
• Экспериментальная поддержка игроков с Bedrock Edition через Geyser.

Процесс привязки аккаунтов максимально упрощен для конечных пользователей. Игрокам необходимо использовать команду в Discord:

/link myMCusername

Как только связь установлена, роли пользователя будут синхронизироваться в реальном времени. Администраторы имеют инструменты для ручного управления связями:

• Команда /admlink discordID mcUsername позволяет принудительно связать аккаунт пользователя.
• Команды /info и /unlink доступны для проверки статуса связи или её удаления.
• По умолчанию эти административные команды доступны всем пользователям, обладающим правом MANAGE ROLES в Discord.

Для обеспечения безопасности и подтверждения владения аккаунтом предусмотрена система верификации. Если в конфигурации установлено requireVerification: true, пользователи должны пройти процедуру подтверждения:

• Код подтверждения выдается либо при попытке входа (если включено управление белым списком), либо через команду /drs verify в чате Minecraft.
• Полученный код необходимо отправить в Discord с помощью команды /verify <code_>.

Плагин предлагает глубокую интеграцию с популярными инструментами:

• PlaceholderAPI: при включении (integrations.plugins.PlaceholderAPI: true) бот может использовать плейсхолдеры в статусе, а также становится доступен специальный расширитель с плейсхолдерами %drs_linked_users% (количество привязанных пользователей), %drs_link_status% (статус привязки), %drs_discord_username% и %drs_discord_display_name%.
• Geyser: экспериментальная поддержка для игроков Bedrock Edition. При активации (experimental.geyser.enableGeyserSupport: true) пользователи, чьи имена начинаются с точки (например, .exampleuser), автоматически распознаются как игроки Geyser.

Для корректной работы плагина необходимо предварительно установить Vault, так как Discord Role Sync напрямую зависит от него. Также требуется любой плагин прав доступа, совместимый с Vault (рекомендуется LuckPerms).

Список доступных узлов прав (Permission Nodes):

Важные технические нюансы и ограничения:

В режиме офлайн-сервера (Offline Mode) привязка имен пользователей чувствительна к регистру. Если вы используете плагины авторизации, которые меняют UUID пользователя после входа, рекомендуется использовать режимы userUUIDMode: FALLBACK или MANUAL. При переключении между режимами онлайн/офлайн необходимо удалить базу данных (файл .db для SQLite или выполнить SQL-запрос DROP TABLE для MySQL).

Плагин поддерживает широкий спектр языков, включая русский, английский, немецкий, французский, испанский, итальянский, португальский, турецкий и японский. Если ваш язык отсутствует, вы можете создать его самостоятельно на основе файла en_US.yml.