Synchro des rôles

La synchro des rôles relie des rôles Discord à des rangs sur ton serveur Minecraft. Quand quelqu'un reçoit un rôle sur Discord, le serveur exécute une commande. Quand quelqu'un a un rang LuckPerms en jeu, le bot lui donne le rôle Discord correspondant. Les deux ne fonctionnent que pour les joueurs qui ont lié leurs comptes.

Configurer

De Discord vers le jeu

1. Crée une règle pour le rôle :

2. Autorise les commandes dans la config du serveur Minecraft. Avec la valeur par défaut whitelist, le serveur les refuse.

# Spigot, Paper, Folia : plugins/mc-sync/config.yml
commands:
  mode: allow
  allow: ["lp user * parent add", "lp user * parent remove"]

# Fabric, Quilt, Forge, NeoForge : config/mc-sync.properties
commands.mode=allow
commands.allow=lp user * parent add,lp user * parent remove

3. Lance /mcsync reload. Sur Forge avant Minecraft 1.19, redémarre le serveur.
4. Donne le rôle à un membre lié. La commande s'exécute sur chaque serveur Minecraft connecté à ce serveur Discord.

Plus de détails sur commands.mode dans Commandes depuis Discord.

Du jeu vers Discord

LuckPerms doit tourner sur le serveur Minecraft. Ce sens n'est disponible que dans le tableau de bord.

1. Dans le tableau de bord, ouvre « Synchro des rôles » et va à « Rangs de Minecraft ».
2. Choisis le rang sous « Rang en jeu » et le rôle sous « Rôle Discord ».
3. Clique sur « Ajouter ».
4. Si plusieurs serveurs Minecraft sont connectés, choisis-en un sous « Quel serveur décide des rangs ? ».

Le bot met les rôles à jour quand un joueur rejoint le serveur et quand son rang change. Il n'ajoute et ne retire que les rôles listés ici.

Réglages

• {player} est remplacé par le nom Minecraft. Sans lui, tout le monde reçoit la même commande.
• Les commandes s'écrivent sans la barre oblique, 300 caractères au maximum. L'une des deux commandes peut rester vide.
• Les commandes s'exécutent avec les droits de la console.
• /role-sync list affiche toutes les règles, /role-sync remove role: @VIP en supprime une.

Problèmes

La commande ne s'exécute pas en jeu

• La personne doit être liée sur ce serveur Discord. Elle peut le vérifier avec /link show.
• Le serveur Minecraft doit accepter la commande via commands.mode et commands.allow, voir Configurer.
• Les commandes refusées apparaissent dans le journal des commandes. Définis son salon avec /notices channel purpose: commands.

Les personnes qui avaient déjà le rôle n'ont pas le rang

La commande ne s'exécute que quand le rôle est ajouté ou retiré. Qui l'avait avant de lier son compte ou avant la création de la règle ne reçoit rien. Retire le rôle et redonne-le.

Le rôle Discord n'est pas donné

• Le rôle du bot doit se trouver au-dessus du rôle qu'il doit donner, dans les paramètres du serveur Discord. Sinon, le tableau de bord affiche « Rôle du bot trop bas ».
• Le joueur doit être lié et rejoindre le serveur après la création de la correspondance.

« Rang en jeu » est vide

Le serveur n'a encore signalé aucun rang. Vérifie que LuckPerms tourne et que le plugin est à jour (téléchargement). Les rangs apparaissent dès qu'un joueur rejoint le serveur ou qu'un rang change.

Tu ne peux pas associer un rôle

Tu ne peux associer que des rôles situés sous ton propre rôle le plus haut. Les rôles avec des droits de modération comme expulser, bannir ou gérer les rôles ne peuvent être associés que par un administrateur.

Le rôle apparaît et disparaît sans arrêt

Deux serveurs Minecraft signalent des rangs différents pour le même joueur. Choisis-en un sous « Quel serveur décide des rangs ? ».