Плагін Minecraft EssentialsDiscord

🔌 Про EssentialsX Discord

EssentialsX Discord (розповсюджується як модуль EssentialsDiscord) — це офіційний модуль EssentialsX, який інтегрує сервер Minecraft із сервером Discord. Він працює як plugin jar поруч із основним модулем EssentialsX і підключається до Discord через налаштований bot token, щоб передавати чат, події та забезпечувати взаємодії на боці Discord, підкріплені невеликим API.

🎯 Призначення

Основне призначення модуля двоєдине: передавати вибрані чат/події Minecraft у канали Discord і передавати вибрані повідомлення/команди Discord на сервер Minecraft. Він призначений для адміністраторів серверів, яким потрібен прямий, налаштовуваний зв’язок і обмежене дистанційне керування між Discord і сервером Minecraft на базі EssentialsX.

⚙️ Функції

• Налаштовуване зіставлення каналів для різних типів повідомлень (чат, приєднання/вихід, staff тощо).
• Передача чату Minecraft у Discord і, за бажанням, передача повідомлень Discord у чат Minecraft.
• slash-команди на боці Discord, які можуть виконувати консольні команди, надсилати повідомлення гравцям і показувати список гравців (налаштовуються та обмежуються ролями).
• Тонка система типів повідомлень і форматування для кожного типу, визначена в конфігурації плагіна.
• API для розробників, щоб реєструвати власні типи повідомлень і команди взаємодії Discord через наданий API DiscordService.

🧩 Для кого це

• Власники серверів на EssentialsX, які хочуть синхронізацію чату Discord ↔ Minecraft.
• Команди staff, яким потрібні приватні канали staff, пов’язані з staff у грі.
• Розробники плагінів, які хочуть надати прості взаємодії з Discord або власні hooks для повідомлень.

🏗️ Приклади використання

• Пересилати глобальний чат у окремий канал Discord, а повідомлення Discord лише для staff — staff у грі.
• Дозволити перевіреним ролям Discord виконувати налаштовані запити або команди сервера через slash-команди без публічного доступу до них.
• Дати іншому плагіну змогу надсилати структуровані сповіщення в Discord, зареєструвавши власний тип повідомлень через API EssentialsX Discord.

⌨️ Команди

EssentialsX Discord надає налаштовувані slash-команди на боці Discord (зареєстровані в Discord), а не звичні команди чату Minecraft. Ці команди (приклади наведено в офіційній документації) запускаються з Discord і можуть виконувати консольні команди, надсилати повідомлення гравцям або показувати список гравців. Доступність команд і розширені можливості керуються налаштуваннями ролей/ID у конфігурації плагіна.

🔐 Дозволи

⚙️ Встановлення

📥 Налаштування

• Завантажте jar-модуль EssentialsX Discord і помістіть його в каталог plugins/ вашого сервера поруч із основним jar EssentialsX.
• Запустіть сервер, щоб згенерувати конфігурацію модуля, потім зупиніть сервер.
• Налаштуйте bot token, ID каналів, message-types і параметри ролей команд у plugins/EssentialsDiscord/config.yml згідно з документацією, а потім перезапустіть сервер.

📦 Залежності

• EssentialsX (основний) — модуль працює як доповнення до набору плагінів EssentialsX.

🧠 Технічні примітки

• Модуль надає сервісний API (DiscordService), щоб інші плагіни могли реєструвати власні типи повідомлень і надсилати повідомлення в налаштовані канали Discord.
• Команди на боці Discord керуються ролями/ID, налаштованими у файлі конфігурації плагіна, а не стандартними permission nodes Minecraft.
• Адміністративні налаштування (bot token, ID каналів, форматування повідомлень, ID ролей команд) виконуються у файлі конфігурації модуля, який створюється під час першого запуску.

🤝 Коли цей плагін корисний

Коли вам потрібен керований, налаштовуваний двосторонній зв’язок між спільнотою Discord і сервером Minecraft на базі EssentialsX (включно з обмеженими ролями командами Discord і hooks для розробників), EssentialsX Discord пропонує зосереджений модуль, який обробляє зіставлення повідомлень і невеликий API для інтеграцій.