MailboxGUI-DiscBridge

Плагин для серверов Майнкрафт, который связывает почту MailboxGUI с DiscordSRV. Он отправляет игрокам уведомления в Discord о доставленных письмах и посылках, а администраторам помогает оповещать сервер о массовой рассылке. Есть русский язык для сообщений команд и шаблонов уведомлений Discord.

Возможности

• Уведомления о обычных и книжных письмах, посылках, посылках с оплатой при получении, возвратах, денежных письмах, а также письмах от сервера, администратора и других плагинов.
• Личные сообщения Discord для привязанного игрока, включившего уведомления. Для игроков в сети их можно разрешить отдельно.
• Одно сообщение в канале Discord при массовой рассылке от администратора или API; при необходимости можно включить очередь личных сообщений получателям и ограничить их число.
• Игрок может выбрать язык своих личных уведомлений. Язык сообщений для массовой рассылки задаётся отдельно в конфиге.
• Режим LOCAL подходит для одного сервера, где MailboxGUI, DiscordSRV и мост установлены вместе. В режиме NETWORK_NODE MailboxGUI работает на нескольких серверах сети, а DiscordSRV и мост размещаются на одном сервере-узле.
• Игроки могут игнорировать письма от выбранного отправителя или от администрации.

Команды

Команды игроков:

• /mbdiscord help — справка.
• /mbdiscord status — состояние уведомлений.
• /mbdiscord enable и /mbdiscord disable — включить или выключить уведомления.
• /mbdiscord online on, /mbdiscord online off, /mbdiscord online toggle — управлять личными сообщениями при нахождении в сети.
• /mbdiscord language <language> — выбрать язык личных уведомлений Discord.
• /mbdiscord ignore <player>, /mbdiscord unignore <player>, /mbdiscord ignorelist — управлять игнорируемыми отправителями.
• /mbdiscord ignoreadmin и /mbdiscord unignoreadmin — игнорировать или снова принимать письма администрации.

Команды администрации:

• /mbdiscord admin status — подробная диагностика подключений, режима работы и параметров уведомлений.
• /mbdiscord admin mode — показать активный режим LOCAL или NETWORK_NODE.
• /mbdiscord admin reload — перезагрузить конфиг, языковые файлы и данные игроков.
• /mbdiscord admin testdm <player> — проверить личное сообщение.
• /mbdiscord admin testchannel — проверить уведомление в канале.

Для получения личных уведомлений игрок привязывает аккаунт через DiscordSRV командой /discord link, затем использует /mbdiscord enable. Уведомления отправляются, если личные сообщения разрешены в конфиге, аккаунт привязан, игрок не игнорирует отправителя и выполняются правила для игроков онлайн.

Права

• mailboxguidiscbridge.use — основные команды игрока.
• mailboxguidiscbridge.online — настройки уведомлений для игрока в сети.
• mailboxguidiscbridge.ignore — игнорирование отправителей.
• mailboxguidiscbridge.ignoreadmin — игнорирование писем администрации.
• mailboxguidiscbridge.admin — административный доступ.
• mailboxguidiscbridge.admin.reload — перезагрузка.
• mailboxguidiscbridge.admin.status — диагностика.
• mailboxguidiscbridge.admin.test — тестовые уведомления.

Настройка

Основной файл — plugins/MailboxGUI-DiscBridge/config.yml. В нём задаются режим работы mode, название сервера, язык уведомлений по умолчанию, правила личных сообщений, канал массовой рассылки и очередь сообщений для неё.

Шаблоны личных сообщений и уведомлений канала находятся в plugins/MailboxGUI-DiscBridge/disclanguage/messages_*.yml. Для русского языка используется файл messages_ru.yml; язык по умолчанию задаётся ключом discord-messages.default-language.

Требования

Нужны MailboxGUI, DiscordSRV и Java 17 или новее. Плагин размещается на сервере Paper, Spigot или Purpur; для сетевого режима MailboxGUI требуется настроенная сетевая работа, включая Redis.