Плагин для серверов Майнкрафт, связывающий сервер с Discord. Он передаёт чат в обе стороны, привязывает игровые аккаунты к Discord и помогает администрации управлять уведомлениями, банами и доступом игроков.
Возможности
- Сообщения из Майнкрафт и Discord передаются в реальном времени; для привязанных игроков в Discord используются их имя и аватар.
- Один аккаунт Discord можно привязать к нескольким игровым аккаунтам. Код для привязки создаётся в игре и отправляется в канал проверки Discord.
- Цвет роли Discord можно показывать в чате, над головой игрока и в списке игроков; каждое место включается отдельно.
- В Discord отправляются сообщения о входе, выходе, первом входе, получении достижения и смерти. Их текст и оформление меняются в
messages.yml. - Логи консоли можно пересылать в Discord, а участникам с разрешёнными ролями — выполнять серверные команды из Discord.
- Баны между Майнкрафт и Discord синхронизируются при подключении AdvancedBan.
- Если привязанный игрок выйдет с Discord-сервера, следующий вход в Майнкрафт блокируется до повторного входа и проверки.
- Режим обслуживания кикает игроков с заданной причиной; для него предусмотрены обходное право и отключение отдельных типов уведомлений.
- Данные хранятся в SQLite, в файле
data.db.
Команды
/discordbridgejp reload— перечитать конфиги и перезапустить бота./discordbridgejp status— проверить подключение бота./discordbridgejp language <code>— сменить язык сообщений./discordbridgejp namecolor <on|off> <player>— включить или выключить перенос цвета роли для игрока./discordbridgejp silentlogin <add|remove|list> [player]— управлять списком игроков без сообщений о входе и выходе./discordbridgejp maintenance <on|off> [reason]— включить либо выключить режим обслуживания./discordbridgejp timeout <player>и/discordbridgejp removetimeout <player>— заблокировать либо разрешить вход игроку./discordbridgejp unlink <player>— принудительно отвязать чужой аккаунт./discordbridgejp link— получить код привязки своего Discord-аккаунта./discordbridgejp unlink— отвязать свой Discord-аккаунт.
В канале проверки Discord команда !XXXXXXXX завершает привязку по коду, !list выводит список связанных аккаунтов для администратора, а !auth <player> <DiscordID> привязывает аккаунт принудительно. В канале чата !list показывает игроков онлайн.
Права
discordbridgejp.admin— все административные команды.discordbridgejp.command.reload,discordbridgejp.command.status,discordbridgejp.command.language,discordbridgejp.command.namecolor,discordbridgejp.command.silentlogin,discordbridgejp.command.maintenance— доступ к одноимённым командам.discordbridgejp.command.timeout— команды блокировки и снятия блокировки входа.discordbridgejp.command.forceunlink— принудительная отвязка чужого аккаунта.discordbridgejp.linkиdiscordbridgejp.unlink— привязка и отвязка собственного аккаунта.discordbridgejp.silentjoinиdiscordbridgejp.silentquit— скрыть соответственно уведомление о входе или выходе в Discord.
Права на отдельные административные команды можно выдавать через LuckPerms.
Настройка
Токен Discord-бота и идентификаторы каналов задаются в bot.yml. Основные параметры находятся в config.yml, а тексты уведомлений — в messages.yml; дополнительные языковые файлы размещаются в lang/.
Требования
Нужен сервер Paper или Purpur, Java 21 и Discord-бот с включёнными разрешениями MESSAGE CONTENT INTENT и SERVER MEMBERS INTENT. Для синхронизации банов используется AdvancedBan, для проверки групп прав — LuckPerms, для тихих входов и выходов — SuperVanishJP.
