Plugin:DiscordBridge

DiscordBridge

Type

Utilitaire

Développeur

incredibleplugins

Statut

Installé

Ressources

Documentation

Documentation

Compatibilité

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 les joueurs

Lier son compte Discord

La liaison de compte associe un compte Minecraft à un compte Discord. Elle peut débloquer des rôles Discord automatiques, des groupes in-game et d'autres avantages selon la configuration du serveur.

Commandes in-game

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

Étapes pour lier son compte

1. Se connecter au serveur Minecraft.
2. Exécuter /discordbridge account link en jeu.
3. Suivre les instructions affichées dans le chat (un code ou un lien sera fourni).
4. Sur Discord, compléter la liaison en suivant les instructions du bot.
5. Une fois le compte lié, les rôles Discord et groupes in-game configurés par les administrateurs sont attribués automatiquement.

En cas de changement de pseudo Discord, la synchronisation du nom peut être automatique selon la configuration du serveur.

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.
• Le plugin Lands doit être installé sur le serveur.

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. Si aucune catégorie n'est configurée, ils apparaissent à la racine du serveur Discord.

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.

Commande Discord	Description
/config linking_allowed_roles add <role>	Restreint la liaison aux joueurs ayant ce rôle Discord
/config linking_roles add	Ajoute un rôle Discord attribué automatiquement aux joueurs liés
/config linking_groups add	Ajoute un groupe LuckPerms attribué automatiquement aux joueurs liés
/config linking_name_sync_ignore_roles add <role>	Exclut les utilisateurs ayant ce rôle de la synchronisation de nom

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

Voir aussi

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