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.
Installation de LuckPerms
- Téléchargez LuckPerms depuis luckperms.net/download (version Bukkit pour Paper)
- Déposez le fichier
.jardans le dossier/plugins/de votre serveur - Redémarrez le serveur — LuckPerms génère ses fichiers de configuration
- 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 |
|---|---|---|
| Groupe | Ensemble de permissions réutilisables | joueur, vip, admin |
| Permission | Droit d'accès à une commande ou fonction | essentials.home, worldedit.wand |
| Héritage | Un groupe hérite des permissions d'un autre | VIP hérite de joueur → toutes les permissions joueur + les siennes |
| Contexte | Permission valide uniquement dans un contexte | Permettre /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.
Articles liés
Publié le par l'Équipe OnPowered — hébergeur belge de serveurs Minecraft et VPS.