Retour au blog
Rangées de clés anciennes sur fond jaune, symbole des rangs et permissions gérés avec LuckPerms
Publié le 19/10/2026

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_nether pour 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.

  1. 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.
  2. Démarrez votre serveur une première fois pour que le dossier plugins existe, puis déposez-y le fichier .jar via le gestionnaire de fichiers de votre panel.
  3. Faites un redémarrage complet (commande stop puis 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 :

RangGroupePoidsHérite dePréfixe
Joueurdefault0aucun&7[Joueur]
VIPvip10default&6[VIP]
Modérateurmoderateur50vip&9[Modo]
Adminadmin100moderateur&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 :

  1. Tapez /lp editor (ou /lp editor groups pour n'ouvrir que les groupes, /lp group vip editor pour un seul groupe).
  2. Cliquez sur le lien reçu dans le chat ou la console.
  3. 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.
  4. 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.