DiscordSRV

Мощнейший и полностью настраиваемый плагин-мост между Discord и Minecraft с открытым исходным кодом.

Поддерживает все версии Minecraft от 1.7.9 до 1.21.x

Мы предоставляем поддержку только для последних релизов и dev-сборок; пожалуйста, обновите плагин перед обращением за помощью

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

Создавайте бесшовную связь между игровым сервером и Discord-сообществом:

• Двусторонний чат - общение между игроками в Minecraft и участниками Discord
• Пересылка консоли - отправка сообщений консоли сервера в текстовый канал Discord
• Голосовая близость - реалистичное голосовое общение с учетом расстояния между игроками (настраивается через voice.yml)
• Привязка аккаунтов - требование связывания Discord-аккаунтов для игры на сервере (настраивается через linking.yml)
• Автоматические уведомления - оповещения о различных игровых событиях
• Гибкая настройка - множество конфигурационных опций под любые нужды

Совместимость с другими плагинами

Системы чата

Интеграция с популярными чат-плагинами: Herochat, LegendChat, LunaChat, TownyChat, VentureChat

Системы невидимости

Поддержка плагинов скрытия игроков: Essentials, PhantomAdmin, SuperVanish, VanishNoPacket

Другие системы

• Multiverse - поддержка мультивселенных
• Vault - интеграция с экономическими системами
• LuckPerms - работа с системой разрешений
• PlaceholderAPI - использование плейсхолдеров

Применение на практике

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

Все функции чата и консоли можно включать/отключать через конфигурационные файлы. Некоторые настройки можно перезагружать командой /discordsrv reload.

Права для Discord-бота

Права на уровне сервера

• Управление ролями - синхронизация ролей и добавление ролей привязанным игрокам
• Управление каналами - обновление тем каналов и работа голосового модуля
• Блокировка участников - синхронизация банов между Discord и Minecraft
• Управление никнеймами - синхронизация игровых имен
• Управление вебхуками - использование экспериментальной функциональности вебхуков

Права на уровне каналов

• Чтение и отправка сообщений - базовые права для работы основных функций
• Управление сообщениями - удаление сообщений командами списка игроков и консоли
• Встраивание ссылок - для отображения ссылок и embed-сообщений
• Упоминания @everyone - для массовых уведомлений
• Добавление реакций - для уведомлений об обрезанных сообщениях
• Управление участниками - для работы голосового модуля

Установка

Подробные инструкции по установке и настройке DiscordSRV доступны в официальной документации.

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

Для интеграции с DiscordSRV добавьте Maven-зависимость или jar-файл плагина (версия 1.18.0+) в свой проект. Пример использования можно найти в репозитории DiscordSRV-ApiTest. Не забудьте добавить "DiscordSRV" в список зависимостей вашего плагина в plugin.yml.

Maven

<repository>
    <id>Scarsz-Nexus</id>
    <url>https://nexus.scarsz.me/content/groups/public/&lt;/url&gt;
</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 собирает анонимную статистику использования, которая отображается на bstats.org. Эта информация используется только для аналитики и не содержит приватных данных сервера. Отключить сбор статистики можно установкой параметра MetricsDisabled в true в файле config.yml.

Проверка обновлений

Плагин автоматически проверяет наличие обновлений через GitHub API и обеспечивает безопасность через систему минимальных версий. Отключить проверку обновлений можно установкой UpdateCheckDisabled в true, однако это может оставить сервер уязвимым при обнаружении проблем безопасности.