Tutoriel LuckPerms : configurer rangs et permissions pas à pas
LuckPerms est le plugin de permissions de référence sur les serveurs Minecraft Spigot, Paper et Purpur, mais ses commandes déroutent souvent au premier essai. Ce tutoriel vous guide de l'installation jusqu'à une hiérarchie complète Joueur, VIP, Modérateur et Admin, avec des modèles de rangs à copier-coller, l'éditeur web et les solutions aux pannes les plus fréquentes.
Ce que fait LuckPerms, et ce qu'il ne fait pas
LuckPerms décide qui a le droit d'utiliser quoi. Chaque commande ou fonction d'un plugin est protégée par une permission, une simple chaîne comme essentials.fly. Une permission peut valoir true (accordée), false (refusée explicitement) ou ne pas être définie, ce qui revient presque toujours à un refus.
Quatre notions suffisent pour tout comprendre :
- Groupe : un ensemble de permissions que l'on attribue à des joueurs. Un rang = un groupe.
- Héritage (parent) : un groupe peut hériter d'un autre. Si « admin » hérite de « moderateur », il récupère toutes ses permissions.
- Poids (weight) : un nombre qui classe les groupes. Plus il est élevé, plus le groupe est prioritaire.
- Contexte : une condition d'application, par exemple
world=world_netherpour une permission valable uniquement dans le Nether.
Point essentiel que beaucoup de guides oublient : LuckPerms stocke les préfixes, mais ne les affiche pas. Pour voir « [Admin] » devant un pseudo dans le chat, il faut en plus Vault et un plugin de mise en forme du chat, comme EssentialsX Chat. Nous y revenons plus bas.
Installer LuckPerms sur Spigot, Paper ou Purpur
En octobre 2026, la version actuelle est la 5.5.87 (série 5.5), compatible de Minecraft 1.8.9 jusqu'à 26.3 d'après les métadonnées officielles du projet.
- Téléchargez la version Bukkit sur la page de téléchargement officielle de LuckPerms. C'est elle qui fonctionne sur Spigot, Paper et Purpur.
- Démarrez votre serveur une première fois pour que le dossier
pluginsexiste, puis déposez-y le fichier.jarvia le gestionnaire de fichiers de votre panel. - Faites un redémarrage complet (commande
stoppuis démarrage). Évitez/reload, qui laisse souvent les plugins dans un état instable.
Par défaut, LuckPerms enregistre ses données dans une base H2 (le fichier luckperms-h2-v2.mv.db, à ne pas supprimer). Si vous préférez des fichiers lisibles, passez storage-method à yaml dans plugins/LuckPerms/config.yml avant de créer vos rangs. Pour un réseau de plusieurs serveurs, choisissez plutôt MySQL.
Étape 1 : vous donner l'accès complet
Juste après l'installation, personne n'a accès aux commandes LuckPerms, pas même vous. Ouvrez la console du serveur (dans la console, on tape les commandes sans la barre oblique) :
lp user VotrePseudo permission set luckperms.* true
Le joker * donne toutes les permissions qui commencent par luckperms.. Vous pouvez ensuite continuer en jeu avec /lp.
Étape 2 : planifier votre hiérarchie de rangs
Avant de taper la moindre commande, posez votre structure. Voici celle que nous allons construire :
| Rang | Groupe | Poids | Hérite de | Préfixe |
|---|---|---|---|---|
| Joueur | default | 0 | aucun | &7[Joueur] |
| VIP | vip | 10 | default | &6[VIP] |
| Modérateur | moderateur | 50 | vip | &9[Modo] |
| Admin | admin | 100 | moderateur | &c[Admin] |
Le groupe default existe déjà : tous les joueurs y sont automatiquement. La documentation officielle déconseille de le remplacer par un autre groupe ; si le nom vous gêne, changez seulement son nom affiché avec /lp group default setdisplayname Joueur.
Étape 3 : créer les groupes et l'héritage
La commande creategroup accepte directement un poids en deuxième argument :
/lp creategroup vip 10
/lp creategroup moderateur 50
/lp creategroup admin 100
/lp group vip parent add default
/lp group moderateur parent add vip
/lp group admin parent add moderateur
L'héritage est récursif : l'admin récupère les permissions du modérateur, donc du VIP, donc du joueur. Vous n'aurez jamais à répéter une permission dans plusieurs groupes. Pour un groupe déjà créé, le poids se règle avec /lp group vip setweight 10.
Étape 4 : les modèles de rangs prêts à l'emploi
Les modèles ci-dessous utilisent les permissions d'EssentialsX, le plugin d'utilitaires le plus répandu. Adaptez-les à vos propres plugins : leur documentation liste toujours les permissions disponibles.
Joueur (groupe default)
/lp group default permission set essentials.spawn true
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.tpdeny true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.balance true
/lp group default permission set essentials.pay true
VIP
Le VIP reçoit des avantages de confort, sans rien qui déséquilibre la partie :
/lp group vip permission set essentials.hat true
/lp group vip permission set essentials.workbench true
/lp group vip permission set essentials.back true
/lp group vip permission set essentials.nick true
/lp group vip permission set essentials.sethome.multiple true
/lp group vip permission set essentials.sethome.multiple.vip true
Les deux dernières lignes donnent plusieurs résidences : le nombre exact se règle dans la section sethome-multiple du config.yml d'EssentialsX (5 pour « vip » dans la configuration par défaut). Il faut bien les deux permissions.
Modérateur
/lp group moderateur permission set essentials.kick true
/lp group moderateur permission set essentials.mute true
/lp group moderateur permission set essentials.tempban true
/lp group moderateur permission set essentials.tp true
/lp group moderateur permission set essentials.invsee true
/lp group moderateur permission set essentials.vanish true
/lp group moderateur permission set essentials.socialspy true
Le modérateur peut bannir temporairement, mais pas définitivement : c'est une protection simple contre les erreurs et les abus.
Admin
/lp group admin permission set essentials.* true
/lp group admin permission set minecraft.command.* true
/lp group admin permission set luckperms.* true
Réservez luckperms.* aux personnes de confiance absolue : avec elle, on peut se donner n'importe quel droit. Et n'attribuez jamais la permission globale * à un rang de modération.
Bloquer une permission héritée
La valeur false retire une permission qu'un groupe hérite. Exemple : interdire /fly au VIP dans le Nether seulement, grâce au contexte :
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.fly false world=world_nether
Étape 5 : préfixes et affichage dans le chat
Ajoutez un préfixe par groupe. La priorité (le premier nombre) départage les préfixes quand un joueur en hérite plusieurs : le plus élevé l'emporte. Gardez la même valeur que le poids, c'est plus lisible.
/lp group default meta setprefix 0 "&7[Joueur] "
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group moderateur meta setprefix 50 "&9[Modo] "
/lp group admin meta setprefix 100 "&c[Admin] "
Les guillemets sont nécessaires pour conserver l'espace final. setprefix remplace le préfixe existant dans le même contexte, alors que addprefix en ajoute un de plus.
Pour que ces préfixes apparaissent réellement, installez Vault et un plugin de chat compatible Vault : EssentialsX Chat si vous utilisez déjà EssentialsX, ou VaultChatFormatter pour quelque chose de minimal. Pour la liste des joueurs (Tab) et au-dessus des têtes, il faut un plugin dédié comme TAB.
Étape 6 : attribuer les rangs aux joueurs
# Ajouter un rang (les autres sont conservés)
/lp user Steve parent add vip
# Remplacer tous les rangs par un seul
/lp user Steve parent set moderateur
# VIP pendant 30 jours, retiré automatiquement ensuite
/lp user Alex parent addtemp vip 30d
# Retirer un rang
/lp user Steve parent remove vip
Les durées se combinent : 1mo3d12h correspond à un mois, trois jours et douze heures. Pour vérifier le résultat, /lp user Steve info affiche les groupes, le groupe principal et le préfixe effectivement transmis aux autres plugins.
Étape 7 : une track pour promouvoir votre équipe
Une track est une échelle de groupes ordonnée. Elle évite de retirer et d'ajouter les groupes à la main lors d'une promotion :
/lp createtrack equipe
/lp track equipe append moderateur
/lp track equipe append admin
/lp user Steve promote equipe
/lp user Steve demote equipe
Si Steve n'est encore sur aucun groupe de la track, promote l'ajoute au premier (modérateur). Une promotion suivante le fait passer admin et retire automatiquement le groupe modérateur.
La méthode rapide : l'éditeur web /lp editor
Si les commandes vous semblent laborieuses, l'éditeur web fait tout dans le navigateur, avec autocomplétion des permissions :
- Tapez
/lp editor(ou/lp editor groupspour n'ouvrir que les groupes,/lp group vip editorpour un seul groupe). - Cliquez sur le lien reçu dans le chat ou la console.
- Ajoutez vos permissions dans le champ « Add Permission » : vous pouvez en coller plusieurs d'un coup. Cliquez sur une valeur pour la modifier, ou sur « Add Contexts » pour la limiter à un monde.
- Enregistrez avec « Save » ou Ctrl+S. L'éditeur génère une commande
/lp applyedits <code>: exécutez-la sur le serveur pour appliquer les changements.
Dans l'éditeur, les rangs se gèrent aussi sous forme de nœuds : group.vip pour un parent, weight.10 pour le poids, prefix.10.&6[VIP] pour un préfixe, displayname.Joueur pour un nom affiché. Ne partagez jamais le lien d'une session : il donne accès à vos données de permissions.
Dépannage : les problèmes les plus fréquents
« Je ne trouve pas la bonne permission »
Utilisez le mode verbose, la méthode la plus fiable. Lancez /lp verbose record Steve, demandez à Steve d'exécuter la commande qui pose problème, puis tapez /lp verbose upload : vous obtenez la liste exacte des permissions vérifiées et leur résultat.
Le préfixe n'apparaît pas dans le chat
Vérifiez d'abord /lp user Steve info. Si le préfixe y figure, LuckPerms fonctionne et le problème vient de l'affichage : Vault absent, plugin de chat manquant ou mal configuré. La commande /vault-info doit indiquer que les données de chat viennent de LuckPerms.
Un joueur a une permission qu'il ne devrait pas avoir
Le plus souvent, c'est un opérateur (/op) : un OP reçoit d'office toutes les permissions qu'un plugin réserve par défaut aux opérateurs. Retirez ce statut avec /deop et gérez tout par LuckPerms. Sinon, cherchez la source avec /lp user Steve permission check essentials.fly.
Mes modifications ne s'appliquent pas
Après une modification faite hors du serveur (fichiers YAML édités à la main, base partagée), lancez /lp sync pour recharger les données.
Tester tout cela sur un serveur gratuit
LuckPerms ne demande presque aucune ressource : vous pouvez monter et tester toute votre hiérarchie sur un serveur Minecraft gratuit MineServerGratis sous Paper, Spigot ou Purpur, avant d'ouvrir le serveur à votre communauté.
FAQ
LuckPerms est-il gratuit ?
Oui, LuckPerms est gratuit et open source, sur toutes les plateformes prises en charge.
Faut-il Vault pour utiliser LuckPerms ?
Non pour les permissions elles-mêmes. Oui dès qu'un autre plugin (chat, économie, Tab) doit lire les groupes ou les préfixes via Vault.
Comment renommer le groupe default ?
On ne le renomme pas : on lui donne un nom affiché avec /lp group default setdisplayname Joueur, ou on le fait hériter d'un groupe « membre » avec /lp group default parent add membre.
Quelle est la différence entre parent add et parent set ?
parent add ajoute un groupe en gardant les autres ; parent set retire tous les groupes existants et n'en garde qu'un.
Peut-on donner un rang pour une durée limitée ?
Oui, avec /lp user Pseudo parent addtemp vip 30d. Le rang disparaît seul à l'échéance.