Plugin Minecraft EssentialsDiscordLink

🔌 À propos de EssentialsX Discord Link

EssentialsX Discord Link est un module additionnel pour EssentialsX Discord qui fournit la liaison de compte et la synchronisation entre les comptes Minecraft et les rôles Discord. Il est conçu pour étendre l'intégration Discord d'EssentialsX avec des fonctionnalités centrées sur la liaison des identités des joueurs et le mappage des groupes Vault vers les rôles Discord (et inversement).

🎯 Objectif

Offrir un moyen simple et facile à maintenir permettant aux joueurs de lier leurs comptes Minecraft et Discord, tout en gardant synchronisés l'appartenance aux groupes du serveur et les rôles Discord. Il permet aussi de restreindre les joueurs non liés afin qu'ils ne puissent pas rejoindre le serveur ou interagir tant qu'ils n'ont pas terminé la liaison.

⚙️ Fonctionnalités

• Synchronisation groupe Vault -> rôle Discord (associer les noms de groupes Vault aux IDs de rôles Discord).
• Synchronisation rôle Discord -> groupe Vault (attribuer des groupes Vault selon les IDs de rôles Discord).
• Empêcher les joueurs non liés de rejoindre le serveur.
• Empêcher les joueurs non liés de se déplacer ou d'envoyer des messages dans le chat jusqu'à ce qu'ils soient liés.
• Flux de liaison de compte en jeu qui fournit un code court à utiliser dans Discord.
• Une petite API développeur pour vérifier l'état de liaison, lier/délier des joueurs et récupérer les données liées.

🧩 À qui cela s'adresse

• Les serveurs utilisant EssentialsX et le module EssentialsX Discord qui ont besoin de la liaison de comptes Discord.
• Les serveurs qui utilisent des groupes Vault et veulent que ces groupes soient reflétés sous forme de rôles Discord (ou l'inverse).
• Les serveurs Survival, SMP et communautaires qui nécessitent une appartenance Discord vérifiée ou une synchronisation des rôles.

🏗️ Exemples d'utilisation

• Accorder automatiquement un groupe de donateur basé sur Vault lorsqu'un joueur possède un rôle Discord correspondant.
• Bloquer les joueurs non liés pour qu'ils ne puissent pas discuter ou se déplacer jusqu'à ce qu'ils confirment leur compte Discord via le code de liaison en jeu.
• Utiliser un plugin ou un script backend pour vérifier si un joueur est lié via l'API fournie.

⌨️ Commandes

⚙️ Installation

📥 Configuration

• Téléchargez le jar officiel EssentialsX Discord Link et placez-le dans le répertoire plugins/ de votre serveur.
• Démarrez le serveur pour générer le dossier du plugin et la configuration par défaut.
• Modifiez la configuration du plugin dans plugins/EssentialsDiscordLink/config.yml pour définir groups (groupe Vault -> ID de rôle Discord) et roles (ID de rôle Discord -> groupe Vault).
• Après avoir enregistré la configuration, exécutez la commande de rechargement de la console EssentialsX (par exemple ess reload) ou redémarrez le serveur pour appliquer les paramètres de synchronisation des rôles.

📦 Dépendances

• EssentialsX (core) — requis (le module est un add-on pour EssentialsX Discord).
• EssentialsX Discord — requis (cet add-on étend ce module).
• Vault — utilisé pour les mappages groupe Vault ↔ rôle Discord (mentionné dans les fonctions de synchronisation des rôles).

🧠 Remarques techniques

• Le plugin expose une petite API développeur (service) qui permet à d'autres plugins de vérifier si un joueur est lié, de lier/délier des joueurs par programme et de récupérer les données liées.
• La configuration utilise plugins/EssentialsDiscordLink/config.yml pour les mappages entre les groupes Vault et les IDs de rôles Discord.

🤝 Quand ce plugin est utile

Si votre serveur utilise déjà EssentialsX et que vous avez besoin que les joueurs vérifient ou lient leurs comptes Discord (et/ou maintiennent synchronisés les groupes Vault et les rôles Discord), EssentialsX Discord Link offre une intégration directe et documentée qui fonctionne dans l'écosystème des modules EssentialsX.