Guide LuckPerms : groupes, grades et commandes

Installer LuckPerms et vous donner l'accès

1. Téléchargez le bon build sur luckperms.net : Bukkit pour Paper et Spigot, ou le build Fabric, NeoForge ou Velocity pour ces plateformes. Il nécessite Java 11 ou plus récent, ce que tout serveur actuel possède.
2. Placez le jar dans plugins (ou mods sous Fabric et NeoForge), supprimez tout autre plugin de permissions et redémarrez complètement le serveur.
3. Donnez-vous l'accès depuis la console. Au départ, personne ne peut utiliser les commandes LuckPerms, pas même vous :

lp user YourName permission set luckperms.* true

Ensuite, vous pouvez utiliser /lp en jeu. Au premier démarrage, LuckPerms télécharge quelques bibliothèques : le serveur a donc besoin d'un accès à Internet.

Groupes, héritage, poids et tracks

• Les nœuds de permission sont les clés, comme essentials.home ou minecraft.command.gamemode. Chacun peut valoir true, false ou ne pas être défini.
• Les groupes contiennent les permissions. Chaque joueur fait partie de default ; c'est vous qui ajoutez les autres.
• L'héritage : un groupe peut avoir des groupes parents et reçoit tout ce qu'ils ont. Si admin hérite de mod et mod hérite de default, les admins ont les trois.
• Le poids décide quel groupe l'emporte quand deux se contredisent : le nombre le plus élevé gagne. Des paliers de 100 laissent de la place pour les groupes ajoutés plus tard.
• Les tracks sont des échelles de promotion, comme default → helper → mod → admin, utilisées avec promote et demote. À eux seuls, ils ne modifient pas l'héritage.
• Les contextes limitent une permission à un serveur ou à un monde, par exemple world=survival à la fin d'une commande.

Une configuration prête à l'emploi : joueur, modérateur et admin

Créez les groupes, enchaînez-les et donnez à chacun les permissions dont il a besoin. Les nœuds ci-dessous correspondent aux commandes EssentialsX ; remplacez-les par ceux des plugins que vous utilisez.

lp creategroup mod
lp creategroup admin
lp group mod parent add default
lp group admin parent add mod
lp group mod setweight 100
lp group admin setweight 200

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.msg true

lp group mod permission set essentials.kick true
lp group mod permission set essentials.mute true
lp group mod permission set essentials.tempban true

lp group admin permission set essentials.* true
lp group admin permission set luckperms.* true

lp user Steve parent add mod

Puis un track pour les promotions :

lp createtrack staff
lp track staff append default
lp track staff append mod
lp track staff append admin

lp user Steve promote staff fait monter Steve d'un échelon. La liste complète des commandes et nœuds EssentialsX se trouve dans le guide EssentialsX.

Préfixes et grades dans le chat

Définissez un préfixe pour un groupe :

lp group admin meta setprefix "&c[Admin] "

LuckPerms stocke le préfixe ; c'est un plugin de chat qui doit l'afficher. Installez Vault et un plugin de chat qui s'appuie dessus, comme EssentialsX Chat. Si un joueur a plusieurs groupes, c'est le préfixe de plus haute priorité qui est utilisé ; définissez-la avec meta setprefix 100 "...".

L'éditeur web de LuckPerms

Pour les gros changements, l'éditeur est plus simple que les commandes. Lancez /lp editor, ouvrez le lien affiché et modifiez groupes, utilisateurs et tracks dans votre navigateur. À l'enregistrement, l'éditeur affiche une commande : exécutez-la en jeu ou dans la console, et les changements s'appliquent. Rien ne change sur le serveur tant que vous n'avez pas exécuté cette commande.

Les commandes LuckPerms que vous utiliserez

Vous ne savez pas quel nœud une commande demande ? Lancez /lp verbose record, utilisez la commande en tant que joueur, puis /lp verbose upload : le rapport montre chaque permission vérifiée.

LuckPerms sur un serveur ou un réseau HytHost

• Installez-le en envoyant le jar dans plugins via le gestionnaire de fichiers ou en SFTP, puis redémarrez depuis le panel. Lancez la première commande lp user ... luckperms.* dans l'onglet Console.
• Un seul serveur : le stockage H2 par défaut suffit.
• Un réseau : installez LuckPerms sur le proxy et sur chaque backend, et reliez-les tous à la même base MySQL avec storage-method: mysql dans config.yml. Chaque offre Minecraft HytHost inclut des bases de données MySQL ; la configuration du proxy lui-même est expliquée dans comment configurer un proxy Velocity.