Comment relier mon serveur Minecraft à Discord avec DiscordSRV ?

DiscordSRV relie le chat de votre serveur Minecraft à un salon Discord : les messages circulent dans les deux sens, et les connexions, déconnexions et annonces de mort apparaissent automatiquement dans Discord. Pour un SMP ou une saison hardcore, c'est le moyen le plus simple de garder tout le groupe impliqué dans le jeu, même hors ligne.

Étape 1 : créez un bot Discord

1. Rendez-vous sur le Discord Developer Portal et créez une nouvelle application.
2. Ouvrez l'onglet Bot et copiez le token. Ne partagez ce token avec personne ; quiconque le possède contrôle votre bot.
3. Dans le même onglet, activez le Message Content Intent et le Server Members Intent. Sans le premier, le bot ne voit aucun message.
4. Allez dans OAuth2, choisissez le scope bot avec les permissions de lire et d'envoyer des messages, puis ouvrez le lien généré pour inviter le bot sur votre serveur Discord.

Étape 2 : installez le plugin

Installez DiscordSRV via la bibliothèque de plugins de votre panel ou uploadez le fichier jar dans plugins. Voir installer un plugin. Redémarrez le serveur ; le dossier plugins/DiscordSRV apparaît avec les fichiers de configuration.

Étape 3 : renseignez le token et le salon

Activez le mode développeur dans Discord (Paramètres, Avancés) et faites un clic droit sur le salon de chat pour copier l'ID du salon. Ouvrez plugins/DiscordSRV/config.yml et renseignez :

BotToken: "votre-token-bot"
Channels: {"global": "123456789012345678"}

Redémarrez le serveur ou tapez /discordsrv reload. Dans la console, vous voyez si le bot se connecte. Testez avec un message dans Minecraft : il doit apparaître dans Discord en moins d'une seconde, et inversement.

Annonces de mort et connexions

Par défaut, les annonces de mort et les messages de connexion et de déconnexion sont activés. Pour les modifier ou les désactiver, ouvrez plugins/DiscordSRV/messages.yml. Pour une saison hardcore, il est sympa de placer les annonces de mort dans un salon séparé ; ajoutez alors un salon supplémentaire à Channels et faites-y référence dans messages.yml.

Lier les comptes (facultatif)

Avec /discord link, un joueur reçoit un code qu'il envoie au bot. DiscordSRV peut ensuite, par exemple, attribuer automatiquement un rôle Discord aux joueurs figurant sur la whitelist. Pour un groupe d'amis, ce n'est pas nécessaire.

Problèmes fréquents

• Le bot est en ligne mais rien ne se passe : vérifiez l'ID du salon et que le bot a bien les permissions dans ce salon.
• Erreur concernant les intents dans la console : le Message Content Intent est désactivé dans le Developer Portal.
• Les messages arrivent en double : un autre plugin de chat qui fait la même liaison tourne encore ; désactivez-en un.
• Token divulgué : générez un nouveau token dans le Developer Portal et remplacez-le dans config.yml.