RaphHosting
TutorielsIntermédiaire

Configurer le bridge Discord

Reliez votre serveur Minecraft à votre Discord avec DiscordSRV : chat, statut et notifications.

RRaphHostingMis à jour le 26 juillet 20262 min de lecture450 mots
0 vue
Partager :
Sommaire

DiscordSRV synchronise le chat de votre serveur Minecraft avec votre Discord. Les messages s'échangent dans les deux sens.

Prérequis

  • Un serveur Paper/Purpur (installation).
  • Un bot Discord (via le portail développeur Discord) avec l'invitation.

1. Créer le bot Discord

  1. Rendez-vous sur discord.com/developersApplicationsNew Application.
  2. Onglet BotAdd Bot.
  3. Copiez le jeton du bot (bouton Reset Token puis copie).
  4. Activez l'option Privileged Gateway Intents → Message Content Intent.
Ne partagez jamais le jeton

Le jeton du bot donne un accès total à votre serveur Discord. Ne le partagez pas, ne le publiez jamais (GitHub, forums…).

2. Inviter le bot

  1. Onglet OAuth2 → URL Generator.
  2. Scopes :
    text
    bot
    +
    text
    applications.commands
    .
  3. Permissions : Send Messages, Manage Messages, Read Message History.
  4. Générez l'URL et invitez le bot sur votre serveur Discord.

3. Installer et configurer DiscordSRV

  1. Téléchargez DiscordSRV (SpigotMC / Modrinth).
  2. Déposez le
    text
    .jar
    dans
    text
    plugins/
    — voir installer des plugins.
  3. Redémarrez, puis ouvrez
    text
    plugins/DiscordSRV/config.yml
    via la gestion des fichiers.
  4. Renseignez le champ
    text
    BotToken
    .

4. Lier le canal

  1. Dans Discord, créez un salon #chat-minecraft.
  2. Copiez son ID (clic droit sur le salon → Copier l'identifiant).
  3. Dans
    text
    config.yml
    , section Channels, remplacez
    text
    global
    par votre ID :
YAML
Channels:
  global: "1234567890123456789"
  1. Sauvegardez et exécutez dans la console :
Commande
discordsrv reload

5. Vérifier la liaison

  • Écrivez dans le chat Minecraft → le message apparaît sur Discord.
  • Écrivez dans Discord → le message apparaît dans Minecraft.
Astuce

Ajoutez la watch console de DiscordSRV (

text
# console
) pour relayer aussi les logs serveur sur Discord — très pratique pour surveiller les erreurs à distance.

6. Bonus : lien des comptes

Activez la liaison de comptes (

text
UseWebserver: true
) pour que les joueurs puissent lier leur compte Minecraft et Discord, et recevoir automatiquement leurs rôles.

Sécurité du bot
  • Utilisez un rôle Discord dédié, sans permissions d'administration.
  • Ne mettez le bot que sur vos serveurs Discord.
  • Surveillez les permissions : Manage Messages suffit pour l'édition.

Dépannage

ProblèmeSolution
Le bot ne répond pasVérifier le
text
BotToken
et
text
discordsrv reload
Messages non relayésVérifier l'ID du canal et l'invitation du bot
text
Message Content Intent
Réactiver et redémarrer le bot (Developer Portal)
Le bot ne voit pas le salonVérifier les permissions et la position du rôle
En résumé

Bot + jeton + config.yml + ID du canal : quatre étapes pour un chat synchronisé. Gardez le jeton secret et reload via

text
discordsrv reload
.

Dernière mise à jour de cet article : 26 juillet 2026 · Auteur : RaphHosting · · RaphHosting