Plugin Minecraft EssentialsDiscord

🔌 À propos d’EssentialsX Discord

EssentialsX Discord (distribué sous le nom de module EssentialsDiscord) est un module officiel d’EssentialsX qui intègre un serveur Minecraft à un serveur Discord. Il fonctionne comme un JAR de plugin aux côtés du module principal EssentialsX et se connecte à Discord via un jeton de bot configuré pour relayer le chat, les événements et fournir des interactions côté Discord appuyées par une petite API.

🎯 Objectif

L’objectif principal du module est double : relayer certains chats/événements Minecraft vers des salons Discord et relayer certains messages/commandes Discord vers le serveur Minecraft. Il est destiné aux administrateurs de serveur qui veulent une communication directe et configurable, ainsi qu’un contrôle à distance limité, entre Discord et un serveur Minecraft basé sur EssentialsX.

⚙️ Fonctionnalités

• Affectation de salons configurable pour différents types de messages (chat, arrivée/départ, staff, etc.).
• Relais du chat Minecraft vers Discord et, en option, des messages Discord vers le chat Minecraft.
• Commandes slash côté Discord pouvant exécuter des commandes de console, envoyer des messages aux joueurs et afficher des listes de joueurs (configurables et limitées par des rôles).
• Système granulaire de types de messages et formatage par type définis dans la configuration du plugin.
• API développeur pour enregistrer des types de messages personnalisés et des commandes d’interaction Discord via l’API DiscordService fournie.

🧩 À qui cela s’adresse

• Aux propriétaires de serveurs utilisant EssentialsX et souhaitant synchroniser le chat Discord ↔ Minecraft.
• Aux équipes de staff qui veulent relier des salons privés de staff à des membres du staff en jeu.
• Aux développeurs de plugins qui veulent exposer des interactions Discord simples ou des hooks de messages personnalisés à Discord.

🏗️ Exemples d’utilisation

• Rediriger le chat global vers un salon Discord dédié tout en envoyant les messages réservés au staff aux membres du staff en jeu.
• Permettre à des rôles Discord vérifiés d’exécuter des requêtes ou commandes serveur configurées via des commandes slash sans les rendre publiques.
• Faire envoyer à un autre plugin des notifications structurées vers Discord en enregistrant un type de message personnalisé avec l’API EssentialsX Discord.

⌨️ Commandes

EssentialsX Discord expose des commandes slash configurables côté Discord (enregistrées dans Discord) plutôt que les commandes de chat Minecraft classiques. Ces commandes (dont des exemples sont présentés dans la documentation officielle) s’exécutent depuis Discord et peuvent exécuter des commandes de console, envoyer des messages aux joueurs ou afficher des listes de joueurs. La disponibilité des commandes et les fonctionnalités avancées sont contrôlées par la configuration des rôles/ID dans le fichier de configuration du plugin.

🔐 Permissions

⚙️ Installation

📥 Configuration

• Téléchargez le JAR du module EssentialsX Discord et placez-le dans le dossier plugins/ de votre serveur à côté du JAR principal d’EssentialsX.
• Démarrez le serveur pour générer la configuration du module, puis arrêtez-le.
• Configurez le jeton du bot, les IDs de salons, les types de messages et les paramètres des rôles des commandes dans plugins/EssentialsDiscord/config.yml comme indiqué dans la documentation, puis redémarrez.

📦 Dépendances

• EssentialsX (core) — le module fonctionne comme un module complémentaire de la suite de plugins EssentialsX.

🧠 Notes techniques

• Le module fournit une API de service (DiscordService) permettant à d’autres plugins d’enregistrer des types de messages personnalisés et d’envoyer des messages vers des salons Discord configurés.
• Les commandes côté Discord sont contrôlées par des rôles/ID configurés dans le fichier du plugin plutôt que par les nœuds de permission Minecraft standards.
• La configuration de type administrateur (jeton du bot, IDs de salons, formatage des messages, IDs des rôles de commande) se fait dans le fichier de configuration du module créé au premier lancement.

🤝 Quand ce plugin est utile

Lorsque vous avez besoin d’une communication bidirectionnelle, gérée et configurable entre une communauté Discord et un serveur Minecraft basé sur EssentialsX — y compris des commandes Discord limitées par rôle et des hooks pour développeurs — EssentialsX Discord fournit un module ciblé qui gère le mappage des messages et une petite API pour les intégrations.