Описание

Описание DiscordSRV

серверный плагин Scarsz, который связывает Minecraft-сервер с Discord и превращает отдельный чат сообщества в рабочую часть серверной инфраструктуры. Его ставят не ради косметики, а ради связи между игроками, модераторами и администрацией: сообщения из Minecraft попадают в Discord, сообщения из выбранных каналов могут уходить обратно в игру, а служебные события и права можно синхронизировать с Discord-ролями. Проект открыт, распространяется по лицензии GPL-3.0-or-later и рассчитан на Bukkit-совместимые серверные платформы: Bukkit, Folia, Paper, Purpur и Spigot. На клиент игрока он не ставится и не поддерживается; серверная сторона обязательна. По заявленной совместимости DiscordSRV покрывает широкий диапазон Minecraft от 1.7.10 до 1.21.x, что делает его полезным и для старых сетей, и для современных Paper/Purpur-серверов. Главная особенность DiscordSRV — глубина интеграции. Это не только пересылка чата. Плагин умеет выводить консоль в канал Discord, принимать удаленные команды, отправлять события через alerts.yml, связывать аккаунты Minecraft и Discord, синхронизировать группы с ролями, ники с отображаемыми именами, баны и награды. Именно поэтому его нужно настраивать аккуратно: канал удаленной консоли должен быть закрыт для всех, кроме действительно доверенных ролей. > Remote console в DiscordSRV — административный инструмент, а не общий чат. Если дать право писать в такой канал всем участникам, они фактически получат возможность отправлять команды от имени серверной консоли.

Что делает ресурс DiscordSRV создает мост между двумя средами, которые обычно живут отдельно. В Minecraft игроки пишут в игровой чат, видят входы, смерти и события сервера. В Discord сообщество обсуждает игру, зовет друзей, модерирует конфликты и получает объявления. Плагин позволяет связать эти потоки так, чтобы игрок без доступа к клиенту Minecraft мог участвовать в разговоре из Discord, а игрок в игре видел важные сообщения сообщества. Вторая важная часть — администрирование. DiscordSRV может пересылать серверную консоль в отдельный текстовый канал и выполнять команды, отправленные туда. Это удобно для дежурных администраторов, но опасно без ограничения прав. Правильная настройка обычно разделяет чтение и запись: часть staff-ролей может видеть консоль, но писать и запускать команды могут только владельцы, разработчики или старшая администрация. Безопасный принцип настройки можно описать так: `yaml discordsrv-console-channel: visible_to: trusted_staff send_messages: owners_and_senior_admins_only bot_token: never_post_in_chat public_access: false` Это не готовый фрагмент конфигурации DiscordSRV, а схема прав, которую стоит держать в голове. Токен бота, канал консоли и роли с правом отправки команд нельзя публиковать в общих каналах, выдавать новичкам или оставлять доступными всем участникам Discord-сервера.

Особенности DiscordSRV ценен тем, что закрывает сразу несколько типичных задач серверного сообщества. Он помогает не терять чат между игрой и Discord, дает staff-команде удаленный обзор происходящего, связывает идентичность игрока между платформами и интегрируется с популярными плагинами прав, экономики и плейсхолдеров.

Двусторонний мост чата между Minecraft и Discord.
Пересылка консоли в Discord-канал и удаленное выполнение команд при правильной настройке доступа.
Событийные оповещения через alerts.yml.
Voice proximity через Discord Voice Chat и настройки voice.yml.
Привязка аккаунтов Minecraft и Discord, включая требования по ролям.
Синхронизация Minecraft-групп с Discord-ролями.
Синхронизация отображаемого имени Minecraft с никнеймом в Discord.
Синхронизация банов и выдача наград за участие в Discord-сервере или бусты.
Хуки для популярных чат-плагинов, а также интеграции с Vault, LuckPerms и PAPI для подстановок. Административные функции стоит включать поэтапно. Сначала обычно настраивают чат-канал и проверяют формат сообщений. Затем добавляют привязку аккаунтов, если серверу нужно понимать, кто есть кто в Discord. После этого можно подключать синхронизацию ролей и никнеймов. Удаленную консоль лучше оставлять последней: она дает максимум пользы старшей команде, но требует самой строгой модели доступа. | Зона | Возможность | Риск при плохой настройке | |---|---|---| | Чат | Сообщения между Minecraft и Discord | Спам или путаница каналов | | Консоль | Просмотр логов и команды из Discord | Команды от имени консоли у лишних ролей | | Аккаунты | Привязка Minecraft к Discord | Ошибочные требования ролей могут не пустить игроков | | Роли и ники | Синхронизация групп, ролей и отображаемых имен | Неверные права у бота ломают синхронизацию | | Баны и награды | Единые санкции и поощрения | Нужна проверка правил сообщества | При работе с ролями важно помнить, что DiscordSRV действует через бота Discord. Боту нужны только те разрешения, которые соответствуют включенным функциям: управление ролями для синхронизации ролей, управление никнеймами для синхронизации ников, права на бан для синхронизации банов, доступ к нужным каналам для чата, консоли и voice-модуля. Чем шире права бота, тем внимательнее нужно следить за каналами, ролями и токеном.

Совместимость и установка DiscordSRV устанавливается на сервер, а не на клиент. Он поддерживает Bukkit, Folia, Paper, Purpur и Spigot; клиентская сторона указана как unsupported, серверная — required. По версиям Minecraft ресурс ориентирован на широкий диапазон от 1.7.10 до 1.21.x. Для поддержки авторы рекомендуют пользоваться актуальными релизами или dev-сборками, а перед обращением за помощью обновляться до свежего доступного варианта. Базовая установка обычно сводится к добавлению jar-файла плагина в папку plugins, запуску сервера для генерации конфигов и настройке Discord-бота. После этого администратор связывает нужные каналы Discord с функциями плагина: основной чат, консоль, оповещения, voice-модуль и прочие разделы. Подробные шаги зависят от выбранной версии и структуры Discord-сервера, поэтому лучше сверяться с официальной документацией, а не копировать чужой конфиг целиком. Минимальный порядок внедрения:

Создайте отдельного Discord-бота и храните его токен вне публичных каналов.
Установите DiscordSRV только на сервер Minecraft.
Настройте чатовый канал и проверьте сообщения в обе стороны.
Ограничьте канал консоли ролями до включения удаленных команд.
Проверьте права бота: роли, никнеймы, баны, webhooks и каналы нужны только для включенных функций.
После изменений используйте перезагрузку DiscordSRV только там, где документация разрешает обновление настроек без полного рестарта. Если сервер использует LuckPerms, Vault или PAPI-подстановки, DiscordSRV может стать частью более широкой системы прав и отображения данных. Это удобно, но повышает цену ошибки. Перед включением синхронизации групп и ролей стоит протестировать ее на отдельной роли без административных полномочий, а затем постепенно переносить правила на реальные группы игроков. Отдельно стоит учитывать сбор статистики и проверку обновлений. В документации указано, что публичная статистика через bStats может быть отключена параметром MetricsDisabled, а проверку обновлений можно отключить через UpdateCheckDisabled. Но отключение update checking снижает шанс вовремя заметить безопасностное обновление, поэтому для публичных серверов это решение нужно принимать осознанно.

Вопросы и ответы

DiscordSRV нужно ставить игрокам на клиент?

Нет. Это серверный плагин для Bukkit/Folia/Paper/Purpur/Spigot. Клиентская сторона не поддерживается, поэтому игрокам не нужно устанавливать DiscordSRV в свой лаунчер.

Можно ли дать всем доступ к каналу удаленной консоли?

Нет. Канал remote console должен быть закрыт для обычных участников. Право отправлять сообщения в него следует оставлять только владельцам, разработчикам или старшей администрации, потому что сообщения могут выполняться как команды серверной консоли.

Что делать с токеном Discord-бота?

Хранить как секрет. Его нельзя публиковать в Discord, отправлять игрокам, вставлять в общедоступные инструкции или показывать на стримах. Если токен утек, его нужно перевыпустить и проверить права бота.

Подойдет ли DiscordSRV для синхронизации ролей LuckPerms и Discord?

Да, плагин поддерживает связку Minecraft-групп и Discord-ролей, а также интеграции с LuckPerms и Vault. Но такую синхронизацию нужно тестировать постепенно, чтобы ошибка в правилах не выдала лишние права.

Можно ли использовать DiscordSRV только как чат-мост?

Да. Чат и консоль настраиваются отдельно, а многие функции можно включать по мере необходимости. Для небольшого сервера разумно начать с чата, затем добавить привязку аккаунтов и только после проверки прав переходить к административным возможностям.