Serveurs Minecraft avec le plugin DiscordSRV

## 🔌 À propos de DiscordSRV DiscordSRV est un plugin Minecraft qui relie un serveur Minecraft et un serveur Discord. Il transfère le chat en jeu vers Discord (et les messages Discord vers le jeu), prend en charge la liaison des comptes Minecraft et Discord, et fournit des points d’intégration pour la synchronisation des rôles/groupes ainsi que plusieurs événements du serveur. ## 🎯 Objectif L’objectif principal de DiscordSRV est de fournir un pont fiable et configurable entre un serveur Minecraft et Discord afin que les communautés puissent communiquer sur les deux plateformes, tenir le staff informé et synchroniser les informations de membres/rôles lorsqu’elle est configurée. ## ⚙️ Fonctionnalités - Synchronisation bidirectionnelle du chat entre les canaux Minecraft et Discord (configurable par canal). - Liaison des comptes Minecraft <-> Discord pour les joueurs. - Points d’intégration pour la synchronisation des rôles/groupes (pour des plugins de permissions comme LuckPerms). - Messages de broadcast et du staff de Minecraft vers Discord. - Commandes pour lier, vérifier l’état de la liaison et effectuer des actions administratives (reload, resync, debug). - Plusieurs fichiers de configuration pour le mappage des canaux, la langue/les messages, la synchronisation et les fonctions vocales. - Code open source avec un suivi public des issues et des releases. ## 🧩 À qui s’adresse-t-il ? - Les propriétaires et administrateurs de serveurs qui veulent unifier le chat de la communauté entre Minecraft et Discord. - Les équipes de modération qui ont besoin de voir les événements du serveur dans Discord. - Les réseaux utilisant des plugins de permissions et souhaitant synchroniser des rôles ou des groupes avec Discord. ## 🏗️ Exemples d’utilisation - Transmettre le chat Minecraft global ou par canal vers des canaux Discord spécifiques afin que les utilisateurs hors serveur puissent suivre les conversations. - Lier les comptes des joueurs à des IDs Discord pour attribuer des rôles Discord ou vérifier les utilisateurs entre plateformes. - Envoyer les journaux de connexion/déconnexion/console du serveur vers un canal de modération Discord. ## ⌨️ Commandes | **Commande** | **Description** | **Permission** | **Accès** | |---|---:|---|---:| | `/discord` `/discordsrv` | Affiche le message DiscordSRV configuré (selon messages.yml). | `discordsrv.discord` | Admin | Sous-commandes joueur : | **Commande** | **Description** | **Permission** | **Accès** | |---|---:|---|---:| | `help` / `?` | Affiche la liste des options pour lesquelles l’utilisateur a les permissions. | `discordsrv.help` | Joueur | | `linked` | Indique si votre compte Minecraft est lié à un compte Discord. | `discordsrv.linked` | Joueur | | `link` | Envoie des instructions pour lier votre compte Minecraft à un compte Discord. | `discordsrv.link` | Joueur | | `unlink` / `clearlinked` | Dissocie votre compte Discord de votre compte Minecraft. | `discordsrv.unlink` | Joueur | Commandes du staff : | **Commande** | **Arguments** | **Description** | **Permission** | **Accès** | |---|---|---:|---|---:| | `broadcast` / `bcast` | `<#ChannelID/#ChannelName> <Message>` | Diffuse un message vers un canal Discord configuré. | `discordsrv.bcast` | Admin | | `linked` | `<Name/UUID/DiscordID/DiscordTag>` | Vérifie l’état de liaison d’un autre utilisateur. | `discordsrv.linked.others` | Admin | | `link` | `<Name/UUID> <DiscordID/DiscordTag>` | Envoie des instructions de liaison pour un autre utilisateur. | `discordsrv.link.others` | Admin | | `unlink` / `clearlinked` | `<Name/UUID/DiscordID/DiscordTag>` | Dissocie le compte Discord d’un autre utilisateur. | `discordsrv.unlink.others` | Admin | | `resync` | | Déclenche la synchronisation des groupes (nécessite une configuration de synchronisation). | `discordsrv.resync` | Admin | | `reload` | | Recharge la configuration du plugin. | `discordsrv.reload` | Admin | | `language` / `lang` | `<Language> [-confirm]` | Modifie la langue du plugin. | `discordsrv.language` | Admin | | `debugger` | `<start [categories...]/stop/upload>` | Extrait les informations de débogage et téléverse éventuellement une trace de debug. | `discordsrv.debug` | Admin | (Les commandes obsolètes liées à l’ancien système d’abonnement sont documentées dans l’historique, mais ont été retirées du fonctionnement actuel.) ## 🔐 Permissions | **Permission** | **Description** | **Par défaut** | |---|---:|---:| | `discordsrv.discord` | Permet d’utiliser `/discord` et `/discordsrv`. | true | | `discordsrv.help` | Accès à la sous-commande d’aide. | non précisé | | `discordsrv.link` | Utiliser la sous-commande de liaison. | non précisé | | `discordsrv.unlink` | Utiliser la sous-commande de dissociation. | non précisé | | `discordsrv.linked` | Vérifier son propre état de liaison. | non précisé | | `discordsrv.bcast` | Envoyer des messages de broadcast vers les canaux Discord. | non précisé | | `discordsrv.linked.others` | Voir l’état de liaison d’autres joueurs. | non précisé | | `discordsrv.link.others` | Envoyer des instructions de liaison à d’autres joueurs. | non précisé | | `discordsrv.unlink.others` | Dissocier d’autres joueurs. | non précisé | | `discordsrv.resync` | Déclencher la synchronisation des groupes/rôles. | non précisé | | `discordsrv.reload` | Recharger le plugin. | non précisé | | `discordsrv.language` | Changer la langue du plugin. | non précisé | | `discordsrv.debug` | Exécuter le débogueur/téléverser des traces de debug. | non précisé | ## ⚙️ Installation ### 📥 Mise en place - Télécharge le `.jar` officiel de DiscordSRV depuis une distribution officielle (page du projet / catalogue / releases). - Place le jar dans le dossier `plugins/` de votre serveur, pour un serveur compatible avec Bukkit/Spigot. - Redémarre le serveur et vérifie les logs de la console pour confirmer que DiscordSRV a bien été chargé. - Termine la configuration initiale (token du bot, mappage des canaux, options de liaison) à l’aide des fichiers de configuration générés. ### 📦 Fichiers de configuration DiscordSRV utilise plusieurs fichiers de configuration ; les noms confirmés incluent : - `config.yml` - `messages.yml` - `linking.yml` - `synchronization.yml` - `voice.yml` - `alerts.yml` Modifie les fichiers appropriés pour définir le token du bot Discord, le mappage des canaux et les paramètres de synchronisation. Certaines fonctionnalités (synchronisation rôles/groupes, intégration vocale) nécessitent une configuration supplémentaire. ## 🧠 Notes techniques - Le code source et les releases sont maintenus dans un dépôt public. - Le projet est publié sous GPL-3.0. - Les intégrations optionnelles confirmées incluent LuckPerms (contexts/synchronisation de groupes) et PlaceholderAPI (placeholders). - Les commandes et permissions sont documentées dans la documentation officielle ; des opérations administratives comme resync et reload existent et peuvent nécessiter des privilèges d’opérateur. ## 🤝 Quand ce plugin est utile Si vous avez besoin d’un chat bidirectionnel cohérent et configurable, ainsi que de la liaison de comptes entre un serveur Minecraft et une communauté Discord, DiscordSRV fournit le pont, les points d’intégration et les fichiers de configuration nécessaires pour faire fonctionner ces fonctionnalités tout en s’intégrant aux plugins courants du serveur.

Plugins