DiscordSRV

DiscordSRV - это, пожалуй, самый мощный и гибкий плагин для связи чата Minecraft и Discord. Если ты админ сервера и хочешь, чтобы игроки из Дискорда могли общаться с теми, кто в игре, или наоборот - это твой выбор. Работает на всех версиях Майнкрафт от 1.7.9 до 1.21.x, так что проблем с совместимостью не будет.

Что умеет DiscordSRV

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

• Мост между чатами - сообщения из Minecraft дублируются в Discord и обратно. Игроки могут общаться, даже если кто-то не зашел на сервер.
• Консоль в Discord - можно вывести вывод консоли в текстовый канал и даже выполнять команды прямо оттуда. Удобно, если нужно быстро что-то сделать, не заходя на сервер.
• Оповещения - настраиваемые алерты на разные события (заход игрока, смерть, достижения). Всё через alerts.yml.
• Голосовая близость - модуль voice.yml позволяет игрокам слышать друг друга в голосовом канале Discord в зависимости от расстояния в игре. Прикольная фича для ролевых серверов.
• Привязка аккаунтов - можно обязать игроков привязать Discord к Minecraft через linking.yml. Это дает кучу возможностей:
  • Синхронизация групп Minecraft и ролей Discord
  • Синхронизация ника (display name) и никнейма в Discord
  • Синхронизация банов между платформами
  • Награды за буст сервера или просто за присутствие в Discord
  • Проверка кто есть кто через команду /discord linked
• Мультиязычность - поддерживает кучу языков: русский, английский, немецкий, французский, испанский, китайский, японский и другие.
• Интеграция с популярными плагинами - работает с Herochat, LegendChat, TownyChat, VentureChat, Essentials, SuperVanish, Vault, LuckPerms, PlaceholderAPI и многими другими.

Как это работает на практике

По сути, DiscordSRV делает так, чтобы твой сервер Minecraft и Discord-сервер жили одной жизнью. Игроки могут общаться в чате игры, а их сообщения видны в Discord. Те, кто сидит в Дискорде, могут отвечать - и сообщения уходят обратно в Minecraft. Это особенно полезно, когда кто-то не может зайти на сервер (например, в дороге), но хочет быть на связи.

Еще одна крутая фича - удаленная консоль. Ты можешь настроить текстовый канал так, чтобы туда выводились все сообщения консоли. А если дать определенной роли права писать в этот канал - можно выполнять команды прямо из Discord. Но тут будь аккуратен: доступ к такому каналу лучше давать только доверенным админам.

Права бота

Чтобы всё работало как надо, боту нужны определенные права на сервере Discord:

Серверные права

• Manage Roles - для синхронизации ролей
• Manage Channels - для обновления топика канала и голосового модуля
• Ban Members - для синхронизации банов
• Manage Nicknames - для синхронизации ников
• Manage Webhooks - для экспериментальных вебхуков

Права в каналах

• Read Text Channels & See Voice Channels + Send Messages - база для работы
• Manage Messages - для удаления сообщений при очистке списка игроков
• Embed Links - для встраивания ссылок и embed-сообщений
• Mention @everyone - если нужно упоминать всех
• Add Reactions и Read Message History - для уведомлений о длинных сообщениях
• Move Members, Mute Members, Manage Permissions - для голосового модуля

Установка и настройка

С установкой всё стандартно: кидаешь jar-файл в папку plugins, запускаешь сервер, настраиваешь config.yml. После изменений можно перезагрузить плагин командой /discordsrv reload (нужна права discordsrv.reload).

DiscordSRV сам проверяет обновления через GitHub API. Если хочешь отключить эту фичу - поставь UpdateCheckDisabled: true в конфиге. Но лучше не выключать: так ты будешь знать о критических исправлениях безопасности.

Для разработчиков

Если хочешь интегрировать свой плагин с DiscordSRV - это делается через Maven или Gradle. Просто добавь зависимость:

<repository>
    <id>Scarsz-Nexus</id>
    <url>https://nexus.scarsz.me/content/groups/public/</url>
</repository>
<dependency>
    <groupId>com.discordsrv</groupId>
    <artifactId>discordsrv</artifactId>
    <version>1.29.0</version>
    <scope>provided</scope>
</dependency>

Или для Gradle:

repositories {
    maven { url 'https://nexus.scarsz.me/content/groups/public/' }
}
dependencies {
    compileOnly 'com.discordsrv:discordsrv:1.29.0'
}

Не забудь добавить "DiscordSRV" в depends/softdepends твоего plugin.yml.

Плагины, использующие API DiscordSRV

Список немаленький: ChatControlRed, CMI, Plan, AuctionHouse, Staff++, LiteBansBridge, ActivityRoles, EconomyShopGUI и еще куча других. Если у тебя есть популярный плагин - скорее всего, он уже дружит с DiscordSRV.

Важно знать про данные

DiscordSRV собирает статистику через bstats.org. Там видно только общую информацию о сервере - ничего личного. Если не хочешь участвовать - поставь MetricsDisabled: true в config.yml.

Скачать плагин DiscordSRV можно с официальных источников. Если собираешь сервер для друзей или комьюнити - это must-have инструмент для связи игроков.