Minecraft plugin EssentialsDiscord

🔌 O EssentialsX Discord

EssentialsX Discord (distribuovaný jako modul EssentialsDiscord) je oficiální modul EssentialsX, který propojuje server Minecraftu se serverem Discord. Funguje jako plugin jar vedle hlavního modulu EssentialsX a připojuje se k Discordu přes nakonfigurovaný bot token, aby přeposílal chat, události a poskytoval interakce na straně Discordu podporované malým API.

🎯 Účel

Hlavní účel modulu je dvojí: přeposílat vybrané chaty/události Minecraftu do kanálů Discordu a přeposílat vybrané zprávy/příkazy z Discordu na server Minecraftu. Je určen pro správce serverů, kteří chtějí přímou, konfigurovatelnou komunikaci a omezené vzdálené ovládání mezi Discordem a serverem Minecraftu postaveným na EssentialsX.

⚙️ Funkce

• Konfigurovatelné mapování kanálů pro různé typy zpráv (chat, join/leave, staff atd.).
• Přeposílání chatu Minecraftu do Discordu a volitelné přeposílání zpráv z Discordu do chatu Minecraftu.
• slash příkazy na straně Discordu, které mohou spouštět konzolové příkazy, posílat zprávy hráčům a zobrazovat seznam hráčů (konfigurovatelné a omezené rolemi).
• Detailní systém typů zpráv a formátování pro jednotlivé typy definovaný v konfiguraci pluginu.
• API pro vývojáře pro registraci vlastních typů zpráv a interakčních příkazů Discordu pomocí poskytnutého API DiscordService.

🧩 Pro koho je to určeno

• Pro majitele serverů s EssentialsX, kteří chtějí synchronizaci chatu Discord ↔ Minecraft.
• Pro staff týmy, které chtějí propojit soukromé staff kanály s členy staffu ve hře.
• Pro vývojáře pluginů, kteří chtějí zpřístupnit jednoduché interakce s Discordem nebo vlastní message hooky do Discordu.

🏗️ Příklady použití

• Přeposílání globálního chatu do vyhrazeného Discord kanálu a zároveň posílání staff-only zpráv z Discordu na in-game staff.
• Umožnit ověřeným rolím Discordu spouštět nakonfigurované serverové dotazy nebo příkazy přes slash příkazy bez veřejného zpřístupnění.
• Nechat jiný plugin posílat strukturovaná oznámení do Discordu registrací vlastního typu zprávy přes EssentialsX Discord API.

⌨️ Příkazy

EssentialsX Discord nabízí konfigurovatelné slash příkazy na straně Discordu (registrované u Discordu) namísto běžných chat příkazů Minecraftu. Tyto příkazy (příklady jsou uvedeny v oficiální dokumentaci) se spouštějí z Discordu a mohou vykonávat konzolové příkazy, posílat zprávy hráčům nebo zobrazovat seznam hráčů. Dostupnost příkazů a rozšířené funkce jsou řízeny nastavením rolí/ID v konfiguraci pluginu.

🔐 Oprávnění

⚙️ Instalace

📥 Nastavení

• Stáhněte jar modul EssentialsX Discord a umístěte jej do adresáře plugins/ vašeho serveru vedle hlavního jaru EssentialsX.
• Spusťte server, aby se vygenerovala konfigurace modulu, poté server vypněte.
• Nakonfigurujte bot token, ID kanálů, message-types a nastavení rolí příkazů v plugins/EssentialsDiscord/config.yml podle dokumentace a poté server restartujte.

📦 Závislosti

• EssentialsX (core) — modul běží jako doplněk k sadě pluginů EssentialsX.

🧠 Technické poznámky

• Modul poskytuje service API (DiscordService), aby jiné pluginy mohly registrovat vlastní typy zpráv a posílat zprávy do nakonfigurovaných kanálů Discordu.
• Příkazy na straně Discordu jsou řízeny rolemi/ID nastavenými v konfiguraci pluginu, nikoli standardními Minecraft permission nodes.
• Administrátorské nastavení (bot token, ID kanálů, formátování zpráv, ID rolí příkazů) se provádí v konfiguračním souboru modulu vytvořeném při prvním spuštění.

🤝 Kdy je tento plugin užitečný

Když potřebujete řízenou, konfigurovatelnou obousměrnou komunikaci mezi komunitou na Discordu a serverem Minecraftu postaveným na EssentialsX (včetně příkazů Discordu omezených rolemi a vývojářských hooků), EssentialsX Discord nabízí zaměřený modul, který řeší mapování zpráv a malé API pro integrace.