Skip to content
Hébergement · Guides des plugins

Synchronisation des rôles Discord et des groupes du serveur

Attribution automatique d'un rôle donateur dans Discord selon le groupe LuckPerms et lien inverse : configuration, vérification et erreurs courantes.

Mis à jour le 13 août 2026

La liaison des rôles est le principal avantage pratique de DiscordSRV : achetez un grade et obtenez automatiquement un rôle Discord.

Configuration

plugins/DiscordSRV/synchronization.yml :

GroupRoleSynchronizationGroupsAndRolesToSync:
  'vip': '123456789012345678'
  'premium': '234567890123456789'
GroupRoleSynchronizationOneWay: false
GroupRoleSynchronizationCycleTime: 5

À gauche se trouve le groupe LuckPerms, à droite l'ID du rôle Discord (faites un clic droit sur le rôle avec le mode développeur activé).

Liaison du compte

/discord link

Le joueur reçoit un code et l'envoie au bot en message privé. La synchronisation est impossible sans liaison.

Mode bidirectionnel

OneWay: false signifie qu'un rôle Discord accorde aussi un groupe sur le serveur. Pratique, mais dangereux : celui qui distribue les rôles dans Discord distribue de fait les grades sur le serveur. Pour les groupes de donateurs, le mode unidirectionnel (serveur → Discord) est plus sûr.

Permissions du bot

Le rôle du bot doit être plus haut que les rôles qu'il gère dans la liste des rôles Discord, sinon il ne pourra pas les attribuer. C'est la cause de 90 % des cas de « la synchronisation ne fonctionne pas ».

Vérification

/discordsrv link Nick
/discordsrv debug

Le journal indique quels rôles le bot tente d'attribuer et pourquoi il a échoué.

Hébergement MinecraftVotre serveur tourne même hors ligneCréer le serveur