Plugin Minecraft EssentialsDiscord

🔌 Despre EssentialsX Discord

EssentialsX Discord (distribuit ca modulul EssentialsDiscord) este un modul oficial EssentialsX care integrează un server Minecraft cu un server Discord. Rulează ca un plugin jar alături de modulul de bază EssentialsX și se conectează la Discord printr-un bot token configurat pentru a transmite chatul, evenimentele și pentru a oferi interacțiuni pe partea Discord, susținute de un API mic.

🎯 Scop

Scopul principal al modulului este dublu: să trimită chat/evenimente Minecraft selectate către canalele Discord și să trimită mesaje/comenzi Discord selectate către serverul Minecraft. Este destinat administratorilor de server care vor o comunicare directă, configurabilă și un control de la distanță limitat între Discord și un server Minecraft bazat pe EssentialsX.

⚙️ Funcții

• Mapare configurabilă a canalelor pentru diferite tipuri de mesaje (chat, join/leave, staff etc.).
• Transmiterea chatului Minecraft către Discord și, opțional, a mesajelor Discord către chatul Minecraft.
• slash commands pe partea Discord care pot executa comenzi de consolă, pot trimite mesaje jucătorilor și pot afișa listele de jucători (configurabile și restricționate prin roluri).
• Sistem granular de tipuri de mesaje și formatare pe tip definit în configurația pluginului.
• API pentru dezvoltatori pentru înregistrarea de tipuri de mesaje personalizate și comenzi de interacțiune Discord prin API-ul DiscordService furnizat.

🧩 Pentru cine este

• Proprietari de servere care rulează EssentialsX și doresc sincronizarea chatului Discord ↔ Minecraft.
• Echipe staff care vor canale private de staff conectate la membrii staff din joc.
• Dezvoltatori de pluginuri care vor să expună interacțiuni simple cu Discord sau hook-uri personalizate de mesaje către Discord.

🏗️ Exemple de utilizare

• Redirecționarea chatului global către un canal Discord dedicat, trimițând în același timp mesajele Discord doar pentru staff către staff-ul din joc.
• Permiterea rolurilor Discord verificate să ruleze interogări sau comenzi de server configurate prin slash commands, fără a le expune public.
• Un alt plugin poate trimite notificări structurate către Discord prin înregistrarea unui tip de mesaj personalizat cu API-ul EssentialsX Discord.

⌨️ Comenzi

EssentialsX Discord oferă slash commands configurabile pe partea Discord (înregistrate în Discord), nu comenzi obișnuite de chat Minecraft. Acele comenzi (exemplele sunt prezentate în documentația oficială) rulează din Discord și pot executa comenzi de consolă, pot trimite mesaje jucătorilor sau pot afișa listele de jucători. Disponibilitatea comenzilor și funcțiile avansate sunt controlate de configurarea rolurilor/ID-urilor din fișierul de configurare al pluginului.

🔐 Permisiuni

⚙️ Instalare

📥 Setare

• Descărcați modulul EssentialsX Discord jar și puneți-l în directorul plugins/ al serverului, alături de jar-ul de bază EssentialsX.
• Porniți serverul pentru a genera configurația modulului, apoi opriți serverul.
• Configurați bot token, ID-urile canalelor, message-types și setările rolurilor pentru comenzi în plugins/EssentialsDiscord/config.yml conform documentației, apoi reporniți.

📦 Dependențe

• EssentialsX (core) — modulul rulează ca un add-on la pachetul de pluginuri EssentialsX.

🧠 Note tehnice

• Modulul oferă un service API (DiscordService) pentru ca alte pluginuri să poată înregistra tipuri de mesaje personalizate și să trimită mesaje către canalele Discord configurate.
• Comenzile de pe partea Discord sunt controlate de roluri/ID-uri configurate în fișierul de configurare al pluginului, nu de standardele Minecraft permission nodes.
• Configurarea de tip admin (bot token, ID-uri de canale, formatarea mesajelor, ID-uri ale rolurilor de comenzi) se face în fișierul de configurare al modulului creat la prima rulare.

🤝 Când este util acest plugin

Când aveți nevoie de o comunicare bidirecțională, gestionată și configurabilă între o comunitate Discord și un server Minecraft bazat pe EssentialsX (inclusiv comenzi Discord restricționate pe roluri și hook-uri pentru dezvoltatori), EssentialsX Discord oferă un modul concentrat care se ocupă de maparea mesajelor și de un API mic pentru integrări.