Введение: мост между двумя мирами

DiscordSRV — это плагин, который связывает чат Minecraft с Discord-каналом. Игроки в игре общаются с игроками в Discord, и наоборот. Но DiscordSRV умеет гораздо больше: синхронизация ролей (VIP в игре = VIP-роль в Discord), уведомления о заходах/смертях/донатах, выполнение команд Minecraft из Discord, голосовая связь (через Simple Voice Chat). В этом гайде я покажу, как настроить DiscordSRV на 100%.

Установка

1. Создайте Discord-бота на Discord Developer Portal (см. статью «Как создать Discord-бота»).
2. Скачайте DiscordSRV с официальной страницы на SpigotMC (бесплатный).
3. Поместите JAR-файл в папку plugins.
4. Перезапустите сервер. DiscordSRV создаст папку plugins/DiscordSRV.

Базовая настройка (синхронизация чата)

В файле config.yml:

BotToken: "ТОКЕН_ВАШЕГО_БОТА"

Channels:
  global: "000000000000000000"  # ID Discord-канала для общего чата

DiscordChatChannelMinecraftChatChannel:
  enabled: true
  discord-to-minecraft: true
  minecraft-to-discord: true

MinecraftChatToDiscordMessageFormat: "&7[&9Discord&7] &b%username%&f: %message%"
DiscordToMinecraftChatMessageFormat: "&7[&9Discord&7] &b%username%&f: %message%"

Где взять ID канала: в Discord включите «Режим разработчика» (Настройки → Расширенные → Режим разработчика). Затем ПКМ по каналу → «Копировать ID».

Синхронизация ролей (VIP в игре = VIP в Discord)

DiscordSRV может автоматически выдавать роли в Discord в зависимости от группы игрока в LuckPerms.

GroupRoleSynchronization:
  enabled: true
  groups:
    - minecraft: "vip"
      discord: "000000000000000000"  # ID роли VIP в Discord
    - minecraft: "premium"
      discord: "000000000000000000"  # ID роли Premium в Discord

Когда игрок получает группу VIP в LuckPerms, бот автоматически выдаёт ему VIP-роль в Discord. При снятии группы — роль убирается.

Уведомления о событиях сервера

DiscordGameEventNotifications:
  enabled: true
  channel: "000000000000000000"  # ID канала для уведомлений
  events:
    player-join: true
    player-leave: true
    player-death: true
    server-start: true
    server-stop: true

Выполнение команд Minecraft из Discord

Создайте отдельный канал в Discord (например, #консоль), где администраторы могут выполнять команды сервера:

DiscordConsoleChannel:
  enabled: true
  channel: "000000000000000000"  # ID канала для консоли
  filter: ".*"                   # Разрешить все команды (ОПАСНО!)
  # Лучше: filter: "^(broadcast|say|tps|spark).*" (только безопасные команды)

Голосовая связь (Simple Voice Chat)

DiscordSRV интегрируется с плагином Simple Voice Chat для передачи голоса между Discord и Minecraft.

1. Установите Simple Voice Chat на сервер.
2. В конфиге DiscordSRV включите:

VoiceChatIntegration:
  enabled: true
  discord-category: "000000000000000000"  # ID категории голосовых каналов

Теперь игроки в Discord и игроки в Minecraft могут общаться голосом, находясь рядом в игре (proximity chat).

Типичные ошибки

• Бот не подключается. Проверьте, что токен скопирован БЕЗ лишних символов. Проверьте, что бот приглашён на сервер с правами Administrator.
• Чат не синхронизируется. Проверьте, что ID канала указан верно (это число, а не имя канала).
• Роли не синхронизируются. Проверьте, что роль бота ВЫШЕ выдаваемых ролей в иерархии Discord (Настройки сервера → Роли → перетащите роль бота выше VIP-роли).

💡 Совет профи

Настройте отдельные каналы Discord для разных миров Minecraft. Например, #чат-survival для игроков выживания и #чат-creative для креатива. В конфиге DiscordSRV можно указать несколько каналов с привязкой к мирам через плагин MultiChat. Это разделит аудиторию и сделает общение более организованным.