LuckPerms Minecraft — guide complet des permissions et des rangs 2026

LuckPerms est le système de permissions le plus utilisé sur les serveurs Minecraft. Il remplace avantageusement les systèmes intégrés d'EssentialsX et offre une interface web visuelle, des permissions temporaires, un héritage de groupes avancé et des logs d'audit. Ce guide couvre l'installation, la configuration des rangs et les cas d'usage avancés.

Configuration des rangs et permissions LuckPerms sur un serveur Minecraft

Installation de LuckPerms

  1. Téléchargez LuckPerms depuis luckperms.net/download (version Bukkit pour Paper)
  2. Déposez le fichier .jar dans le dossier /plugins/ de votre serveur
  3. Redémarrez le serveur — LuckPerms génère ses fichiers de configuration
  4. Vérifiez dans la console : [LuckPerms] Running permission checks...

💡 LuckPerms nécessite Vault pour interagir avec EssentialsX et les autres plugins d'économie. Installez Vault en premier si ce n'est pas déjà fait.

Concepts de base : groupes, permissions et héritages

Concept Définition Exemple
GroupeEnsemble de permissions réutilisablesjoueur, vip, admin
PermissionDroit d'accès à une commande ou fonctionessentials.home, worldedit.wand
HéritageUn groupe hérite des permissions d'un autreVIP hérite de joueur → toutes les permissions joueur + les siennes
ContextePermission valide uniquement dans un contextePermettre /fly uniquement dans le monde "lobby"

Créer une hiérarchie de rangs

Voici un exemple de hiérarchie classique : Joueur → VIP → Modérateur → Admin. Chaque rang hérite du précédent.

# Créer les groupes
/lp creategroup joueur
/lp creategroup vip
/lp creategroup moderateur
/lp creategroup admin

# Définir l'héritage (chaque groupe hérite du rang en-dessous)
/lp group vip parent add joueur
/lp group moderateur parent add vip
/lp group admin parent add moderateur

# Définir le groupe par défaut (tous les nouveaux joueurs reçoivent "joueur")
/lp group joueur setdefault true

Attribuer des permissions aux groupes

# Permissions groupe "joueur" (basiques)
/lp group joueur permission set essentials.home true
/lp group joueur permission set essentials.sethome true
/lp group joueur permission set essentials.spawn true
/lp group joueur permission set essentials.msg true
/lp group joueur permission set essentials.warp true

# Permissions groupe "vip" (avancées)
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.kit.vip true
/lp group vip permission set essentials.home.multiple true
/lp group vip permission set essentials.sethome.multiple.vip true

# Permissions groupe "moderateur"
/lp group moderateur permission set essentials.kick true
/lp group moderateur permission set essentials.mute true
/lp group moderateur permission set essentials.ban true
/lp group moderateur permission set coreprotect.inspect true

# Permissions groupe "admin" (tout)
/lp group admin permission set * true

Gérer les joueurs

# Attribuer un rang à un joueur
/lp user PseudoJoueur parent add vip

# Retirer un rang
/lp user PseudoJoueur parent remove vip

# Voir tous les groupes d'un joueur
/lp user PseudoJoueur info

# Rang temporaire (expire après 30 jours)
/lp user PseudoJoueur parent addtemp vip 30d

# Permission individuelle à un joueur spécifique
/lp user PseudoJoueur permission set essentials.god true

L'éditeur web LuckPerms

L'interface web est la façon la plus simple de gérer les permissions sans commandes. Depuis la console du serveur :

/lp editor

Un lien s'affiche dans la console. Ouvrez-le dans votre navigateur : vous accédez à une interface graphique pour ajouter/retirer des permissions, modifier les groupes et voir les héritages en arbre. Sauvegardez depuis l'éditeur web et les changements s'appliquent immédiatement.

Configurer les préfixes de chat (avec EssentialsX Chat)

Pour afficher les rangs dans le chat, LuckPerms utilise des méta-données prefix et suffix :

# Définir un préfixe pour le groupe VIP (avec couleurs)
/lp group vip meta setprefix "&6[VIP] &r"
/lp group moderateur meta setprefix "&9[MOD] &r"
/lp group admin meta setprefix "&c[ADMIN] &r"

# Poids de priorité (le préfixe le plus élevé s'affiche)
/lp group vip meta setweight 100
/lp group moderateur meta setweight 200
/lp group admin meta setweight 300

Dans EssentialsX/config.yml, activez le formatage des messages via LuckPerms (PlaceholderAPI) :

chat:
  format: '{DISPLAYNAME}&f: {MESSAGE}'
  # Ou avec PlaceholderAPI :
  format: '%luckperms_prefix%{DISPLAYNAME}&f: {MESSAGE}'

Foire aux questions

Comment trouver le nom exact d'une permission ?
Chaque plugin liste ses permissions dans sa documentation. Pour EssentialsX : essentialsx.net/wiki. Pour WorldGuard : docs WorldGuard. En cas de doute, activez LuckPerms verbose mode : /lp verbose on — il affiche les permissions vérifiées en temps réel.

Les permissions s'appliquent-elles immédiatement ?
Oui — sans redémarrage. LuckPerms applique les changements en temps réel sur tous les joueurs connectés. Un joueur en ligne voit ses permissions mises à jour instantanément après /lp user ou /lp group.

Peut-on importer une configuration depuis PermissionsEx ou GroupManager ?
Oui. LuckPerms intègre un outil de migration : /lp migration permissionsex ou /lp migration groupmanager. La plupart des configurations sont importées correctement, avec quelques ajustements manuels possibles pour les préfixes de couleur.

Publié le par l'Équipe OnPowered — hébergeur belge de serveurs Minecraft et VPS.