Plugin Minecraft EssentialsDiscord

🔌 Informazioni su EssentialsX Discord

EssentialsX Discord (distribuito come modulo EssentialsDiscord) è un modulo ufficiale di EssentialsX che integra un server Minecraft con un server Discord. Funziona come file JAR del plugin insieme al modulo principale di EssentialsX e si connette a Discord tramite un token del bot configurato per inoltrare chat, eventi e offrire interazioni lato Discord supportate da una piccola API.

🎯 Scopo

Lo scopo principale del modulo è doppio: inoltrare chat/eventi selezionati di Minecraft ai canali Discord e inoltrare messaggi/comandi selezionati di Discord al server Minecraft. È pensato per gli amministratori di server che desiderano una comunicazione diretta e configurabile, oltre a un controllo remoto limitato, tra Discord e un server Minecraft basato su EssentialsX.

⚙️ Funzionalità

• Mappatura dei canali configurabile per diversi tipi di messaggio (chat, entrata/uscita, staff, ecc.).
• Inoltro della chat di Minecraft a Discord e, facoltativamente, dei messaggi di Discord alla chat di Minecraft.
• Comandi slash lato Discord che possono eseguire comandi della console, inviare messaggi ai giocatori e mostrare elenchi di giocatori (configurabili e limitati dai ruoli).
• Sistema granulare di tipi di messaggio e formattazione per tipo definiti nella configurazione del plugin.
• API per sviluppatori per registrare tipi di messaggio personalizzati e comandi di interazione Discord tramite l’API DiscordService fornita.

🧩 Per chi è

• Proprietari di server che usano EssentialsX e vogliono la sincronizzazione della chat tra Discord ↔ Minecraft.
• Team di staff che vogliono collegare canali privati dello staff ai membri dello staff nel gioco.
• Sviluppatori di plugin che vogliono esporre semplici interazioni Discord o hook di messaggi personalizzati verso Discord.

🏗️ Casi d’uso di esempio

• Inoltrare la chat globale a un canale Discord dedicato inviando al contempo i messaggi riservati allo staff ai membri dello staff nel gioco.
• Consentire ai ruoli Discord verificati di eseguire query o comandi del server configurati tramite comandi slash senza renderli pubblici.
• Far inviare a un altro plugin notifiche strutturate a Discord registrando un tipo di messaggio personalizzato con l’API di EssentialsX Discord.

⌨️ Comandi

EssentialsX Discord espone comandi slash configurabili lato Discord (registrati su Discord) invece dei tipici comandi chat di Minecraft. Questi comandi (con esempi mostrati nella documentazione ufficiale) vengono eseguiti da Discord e possono eseguire comandi della console, inviare messaggi ai giocatori o mostrare elenchi di giocatori. La disponibilità dei comandi e le funzioni avanzate sono controllate dalla configurazione di ruoli/ID nel file di configurazione del plugin.

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Scarica il file JAR del modulo EssentialsX Discord e posizionalo nella directory plugins/ del tuo server insieme al JAR principale di EssentialsX.
• Avvia il server per generare la configurazione del modulo, quindi arresta il server.
• Configura il token del bot, gli ID dei canali, i tipi di messaggio e le impostazioni dei ruoli dei comandi in plugins/EssentialsDiscord/config.yml come documentato, quindi riavvia.

📦 Dipendenze

• EssentialsX (core) — il modulo funziona come componente aggiuntivo della suite di plugin EssentialsX.

🧠 Note tecniche

• Il modulo fornisce un’API di servizio (DiscordService) per consentire ad altri plugin di registrare tipi di messaggio personalizzati e inviare messaggi ai canali Discord configurati.
• I comandi lato Discord sono controllati da ruoli/ID configurati nel file del plugin anziché dai normali nodi di permesso di Minecraft.
• La configurazione in stile amministrativo (token del bot, ID dei canali, formattazione dei messaggi, ID dei ruoli dei comandi) viene effettuata nel file di configurazione del modulo creato al primo avvio.

🤝 Quando questo plugin è utile

Quando hai bisogno di una comunicazione bidirezionale gestita e configurabile tra una community Discord e un server Minecraft basato su EssentialsX (inclusi comandi Discord limitati dai ruoli e hook per sviluppatori), EssentialsX Discord offre un modulo mirato che gestisce il mapping dei messaggi e una piccola API per le integrazioni.