Plugin:DiscordBridge

DiscordBridge

Type

Utilitaire

Développeur

incredibleplugins

Statut

Installé

Ressources

Documentation

Documentation

Compatibilité

Compatible avec

Lands, LuckPerms

DiscordBridge est un plugin d'intégration entre le serveur Minecraft et le serveur Discord. Il relie les deux plateformes en offrant la synchronisation du chat, la liaison de comptes, la gestion de tickets, les notifications d'événements et l'intégration avec le plugin Lands.

Pour tous les joueurs

Commandes en jeu

Commande	Description	Permission
/discordbridge account link	Lier son compte Discord à son compte Minecraft	discordbridge.command.account.link
/discordbridge account unlink	Délier son compte Discord	discordbridge.command.account.unlink
/discordbridge invite	Obtenir le lien d'invitation du serveur Discord	discordbridge.command.invite
/discordbridge help [page]	Afficher l'aide des commandes disponibles	discordbridge.command.help

Lier son compte Discord

La liaison entre votre compte Minecraft et Discord permet une synchronisation automatique des rôles. Sur Nefald, la synchronisation se fait dans le sens Discord → Minecraft : les rôles Discord déterminent les groupes attribués en jeu.

En cas de changement de pseudo ou de rôle sur Discord, la synchronisation n'est pas immédiate — elle s'effectue automatiquement de façon planifiée.

Étapes

1. Connectez-vous au serveur Minecraft.
2. Exécutez la commande /discordbridge account link en jeu.
3. Suivez les instructions affichées dans le chat : un code et une commande Discord vous seront fournis.
4. Sur Nefald›#account-linking, envoyez la commande indiquée au bot pour finaliser la liaison.
5. Vos rôles Discord et groupes en jeu sont alors attribués automatiquement.

Lands

Créer un salon Discord pour sa Land

Les propriétaires d'une Land ou d'une Nation peuvent créer un salon textuel et vocal dédié directement dans le serveur Discord.

Conditions requises

• Être propriétaire ou disposer des droits sur une Land / Nation.
• Avoir son compte Minecraft lié à son compte Discord — voir Lier son compte Discord.
• Se rendre dans Nefald›#lands et exécutez les commandes ci-dessous.

Commandes Discord

Commande Discord	Description
/lands channel create	Crée un salon Discord pour la Land
/nations channel create	Crée un salon Discord pour la Nation

Les salons sont créés dans la catégorie définie par les administrateurs, Lands. Seuls les membres du Land qui ont liés leur compte Minecraft > Discord, peuvent y accéder. Les Ops du serveur Discord ont accès à tous les salons.

Pour les administrateurs

Installation et configuration du bot

Prérequis

1. Créer une application Discord sur le Portail Développeur Discord.
2. Activer les Intents suivants dans l'onglet Bot :
   • Server Members Intent
   • Message Content Intent
3. Lors de l'invitation du bot, les scopes requis sont :
   • applications.commands
   • bot
4. Le bot doit disposer des permissions Discord suivantes :
   • Gérer les salons
   • Gérer les webhooks
   • Lire les messages / Voir les salons
   • Envoyer des messages
   • Gérer les messages
   • Intégrer des liens
   • Joindre des fichiers
   • Voir l'historique des messages
   • Ajouter des réactions
5. Copier le token du bot et le coller dans DiscordBridge/Modules/bot.yml à l'option token.

Configuration des modules

Module Chat

Synchronise le chat in-game vers Discord et inversement.

Commande Discord	Description
/config set CHAT_CHANNEL	Définit le salon Discord recevant les messages du chat in-game

Le compte Minecraft doit être lié à Discord pour que les messages se synchronisent.

Module Events

Envoie des messages dans Discord lors d'événements sur le serveur (connexion, déconnexion, mort, etc.).

• La configuration se fait dans : DiscordBridge/Modules/events.yml
• Chaque événement peut être désactivé individuellement dans ce fichier.

Module Lands

Intègre DiscordBridge avec le plugin Lands pour les annonces et les salons de Land/Nation.

Commande Discord	Description
/config set LANDS_CHAT_CATEGORY	(Optionnel) Catégorie Discord où seront créés les salons de Land/Nation
/config set LANDS_BROADCAST_CHANNEL	(Optionnel) Salon Discord pour les annonces Lands (guerres, suppressions, etc.)
/config set LANDS_NOTIFY_<broadcast_category>	Configure les rôles notifiés pour chaque catégorie d'annonce

Le compte Minecraft doit être lié à Discord pour pouvoir créer un salon Lands.

Remplacer <broadcast_category> par la catégorie souhaitée (ex : WAR, DELETE…).

Module Linking

Gère la liaison entre comptes Minecraft et Discord.

Les synchronisations ne fonctionnent que dans un seul sens selon le paramètre configuré.

Sens de synchronisation

Paramètre	Sens	Effet
linking_roles add	Minecraft → Discord	Le joueur reçoit un rôle Discord automatiquement lorsqu'il lie son compte
linking_groups add	Discord → Minecraft	Le joueur reçoit un groupe LuckPerms in-game selon son rôle Discord au moment de la liaison

Ces deux paramètres sont indépendants. Les configurer simultanément peut créer des boucles logiques involontaires ou des attributions redondantes. Il est recommandé de n'en utiliser qu'un seul selon l'architecture choisie.

Architecture recommandée

Cas d'usage	Paramètre à utiliser	Paramètre à éviter
Gérer les grades depuis Discord	linking_groups add	linking_roles add
Donner un badge Discord aux joueurs liés	linking_roles add	linking_groups add
Synchronisation complète bidirectionnelle	Non supporté nativement	—

DiscordBridge ne supporte pas la synchronisation bidirectionnelle native. Utiliser les deux paramètres simultanément est possible mais doit être fait consciemment pour éviter les conflits de permissions.

Commande in-game (administration)

Commande	Description	Permission
/discordbridge account admin migrate	Migre les liaisons existantes depuis un autre plugin	discordbridge.admin.command.account.admin.migrate

Lors de l'ajout d'un rôle ou d'un groupe, les joueurs déjà liés le reçoivent automatiquement. La mise à jour est planifiée pour éviter toute surcharge sur les grands serveurs.

Module Tickets

Permet aux membres Discord de créer des tickets de support directement depuis le serveur Discord.

Configuration requise

Commande Discord	Description
/config set tickets_category_closed	Catégorie où sont déplacés les tickets fermés avant suppression
/config set tickets_member_max_tickets	Nombre maximum de tickets simultanés par utilisateur
/config set tickets_role_support	Rôle Discord pouvant voir et gérer tous les tickets
/config set tickets_deletion_time	Délai avant suppression d'un ticket fermé (ex : 1d, 12h)
/config set tickets_remind_submitter	Active ou désactive le rappel automatique au créateur (true / false)
/config set tickets_staff_unavailable	Message affiché si aucun staff n'est disponible (nécessite tickets_role_support)
/config set tickets_creation_channel	Salon Discord où le message de création de ticket sera posté
/config type upsert	Créer ou mettre à jour un type de ticket
/config field upsert	Créer ou mettre à jour les champs d'un type de ticket
/config info create	(Optionnel) Prédéfinir des informations demandées après création du ticket
/config reason create	(Optionnel) Prédéfinir des raisons de fermeture de ticket

Pour effacer une valeur de configuration, exécuter /config set <option> sans préciser de valeur.

Commandes d'administration générales

Commande	Description	Permission
/discordbridge admin	Accès aux commandes d'administration	discordbridge.admin.command
/discordbridge admin reload	Recharge la configuration du plugin	discordbridge.admin.command.reload

Toutes les sous-commandes de /discordbridge admin suivent le format de permission : discordbridge.admin.command.<souscommande>

Placeholders PlaceholderAPI

Ces placeholders nécessitent l'installation de PlaceholderAPI.

Placeholder	Description
%discordbridge_module_linking_amount%	Nombre de joueurs ayant lié leur compte
%discordbridge_module_linking_user_state_bool%	true si le joueur a lié son compte, sinon false
%discordbridge_module_linking_user_state%	État de liaison (texte traduit depuis le fichier de locale)
%discordbridge_module_linking_user_id%	ID Discord de l'utilisateur lié
%discordbridge_module_linking_user_name%	Pseudo Discord de l'utilisateur lié
%discordbridge_module_linking_user_booster%	Indique si le joueur booste un serveur Discord du bot (texte)
%discordbridge_module_linking_user_booster_bool%	true si le joueur booste un serveur Discord du bot

Fichiers de configuration

Fichier	Rôle
DiscordBridge/Modules/bot.yml	Configuration principale du bot (token, URL d'invitation, etc.)
DiscordBridge/Modules/events.yml	Activation et désactivation des événements envoyés sur Discord
DiscordBridge/Modules/chat.yml	Configuration du module chat
DiscordBridge/Modules/linking.yml	Configuration du module de liaison de comptes
DiscordBridge/Modules/lands.yml	Configuration du module Lands
DiscordBridge/Modules/tickets.yml	Configuration du module Tickets

Voir aussi

• Lands — Plugin de gestion de territoires
• LuckPerms — Gestion des permissions et groupes
• PlaceholderAPI — Placeholders dynamiques
• Documentation officielle DiscordBridge