DiscordSRV - мост между Discord и Minecraft

DiscordSRV - это, по сути, главный мост между вашим сервером Minecraft и вашим сообществом в Discord. Любой админ рано или поздно сталкивается с проблемой: игроки общаются в игре, а остальное комьюнити сидит в Дискорде. И вот чтобы не было разделения, этот плагин для Майнкрафт объединяет оба чата. Сообщения из игры летят в Дискорд и наоборот. Но это не просто ретранслятор текста, функционал тут реально огромный. Плагин поддерживает версии с 1.7.9 вплоть до самых свежих 1.20+ (и даже выше).

Хотите запустить сервер и играть с друзьями онлайн? Этот плагин отлично работает на любом хостинге, а на BungeeHost (https://bungee.host) он устанавливается буквально в один клик. Создать сервер Майнкрафт с такой интеграцией - правильное решение для растущего проекта.

Основные возможности

• Общий чат - синхронизация сообщений между Minecraft и Discord.
• Удаленная консоль - вывод логов консоли в отдельный текстовый канал Дискорда. Туда же можно вписывать команды, и сервер их исполнит. Удобно для админов, которые хотят контролировать сервер с телефона.
• Система оповещений - бродкасты на основе внутриигровых ивентов (настраивается в alerts.yml).
• Голосовой чат по близости - использует голосовые каналы Discord для создания эффекта пространственного звука (voice.yml).
• Обязательная привязка аккаунтов - можно заставить игроков привязать Discord к игровому аккаунту, чтобы пускать только своих (или только с определенными ролями).
• Глубокая синхронизация - роли в Minecraft синхронизируются с ролями Discord (и наоборот), ники переносятся, баны тоже. Можно выдавать награды за буст сервера или просто за нахождение в гильдии.
• Мультиязычность - поддержка кучи языков, включая русский, английский, испанский, китайский и другие.
• Совместимость с популярными плагинами - интегрируется с кучей чат-плагинов и систем управления.

Интеграция с другими плагинами

DiscordSRV умело цепляется за другие плагины на вашем сервере:

Чат:

• Herochat, LegendChat, LunaChat, TownyChat, VentureChat

Ваниш (невидимость):

• Essentials, PhantomAdmin, SuperVanish, VanishNoPacket

Прочее:

• Multiverse, Vault, LuckPerms, PlaceholderAPI (через специальные плейсхолдеры)

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

Огромное количество проектов работает с API этого моста. Вот лишь некоторые из них:

• DiscordSRV StaffChat, ChatControlRed, CMI, Plan, EmojiChat, PurpleIRC, ChatReplay, AuctionHouse, Staff Facilities, Staff++, LiteBansBridge, MCSF, MZP-VoteParty, InteractiveChat DiscordSRV Addon, DiscordSRVUtils, ActivityRoles, EconomyShopGUI, DiscordSchematicUploader, KiaiMC, SlashAdditions, Custom Bans Plus, DiscordSRVOAuth, Villager Announcer, DiscordNickSync.

Настройка прав для бота

Чтобы плагин корректно отработал, боту в Дискорде нужны определенные права. Вот табличка для серверных прав:

Право (Server Permissions)	Для чего нужно
Manage Roles	Синхронизация ролей и их выдача привязанным игрокам
Manage Channels	Обновление тем каналов и работа голосового модуля
Ban Members	Синхронизация блокировок
Manage Nicknames	Синхронизация никнеймов
Manage Webhooks	Экспериментальные вебхуки (для продвинутых фич)

И права для конкретных каналов:

Право (Channel Permissions)	Для чего нужно
Read Text Channels & See Voice Channels и Send Messages	Базовая работа плагина (чаты, консоль, лобби)
Manage Messages	Удаление сообщений через команды в чате
Embed Links	Встраивание ссылок и embed-сообщений для смертей/входа-выхода
Mention @everyone, @here and All Roles	Упоминание ролей если это разрешено в config.yml
Add Reactions и Read Message History	Реакции бота на обрезанные сообщения
Move Members, Mute Members и Manage Permissions	Работа голосового лобби

Важный нюанс: удаленная консоль

Консоль в Discord - крутая штука. Выделите под нее отдельный текстовый канал и направьте туда логи. Плагин будет не только слать туда текст, но и исполнять команды, которые вы туда напишете. Но! Из-за особенностей прав Discord, вы можете дать определенным ролям доступ на чтение канала, но запретить отправку сообщений. Так вы сделаете read-only консоль для младших админов и модераторов. Писать туда смогут только разработчики или главы проекта. И чат, и консоль можно гибко отключить в конфиге. Перезагрузить настройки на лету можно командой /discordsrv reload (нужны права OP или discordsrv.reload).

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

Если вы пишете свой плагин и хотите прикрутить его к DiscordSRV, добавьте Maven-зависимость или подключите jar-ник (версии 1.18.0 и выше). Не забудьте репозиторий JDA. В plugin.yml вашего плагина пропишите DiscordSRV в depends или softdepends.

Maven

<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'
}

Сбор статистики и обновления

Плагин собирает анонимную статистику через bStats. Никаких приватных данных не уходит. Если вас это напрягает, просто впишите MetricsDisabled: true в config.yml.

Также DiscordSRV сам проверяет обновления через API GitHub. Это нужно не только для свежих фиксов, но и для безопасности - плагин знает, какие версии уязвимы. Отключить проверку можно параметром UpdateCheckDisabled: true, но я бы не советовал так делать, если сервер стоит на публичном хостинге серверов Майнкрафт. Лучше обновляться и спать спокойно.

Скачайте плагин DiscordSRV, если хотите объединить свою игровую базу с Дискорд-комьюнити. Это мастхэв для любого крупного проекта.