LuckPerms est le plugin de permissions qui te permet de définir qui peut utiliser quelles commandes sur un serveur Paper ou Spigot. Sans plugin de permissions, il n'existe que deux niveaux : l'opérateur, qui a tous les droits, et les joueurs normaux, qui n'en ont presque aucun. LuckPerms ajoute des groupes entre les deux : invités, constructeurs, modération. Chaque groupe possède des nœuds de permission, et les joueurs héritent des nœuds de leurs groupes.

Ce guide t'accompagne de l'installation jusqu'à la création de ton premier groupe de modération. Les commandes proviennent de la documentation officielle de LuckPerms ; les captures d'écran ont été réalisées sur un serveur de test avec Paper 1.21.4 et LuckPerms 5.5.71.

Installation depuis le panel

Dans le panel de ton serveur, tu trouveras LuckPerms sous Plugins → Navigateur. La recherche récupère les données depuis Modrinth ; le loader et la version du serveur sont comparés aux métadonnées du plugin avant que le fichier n'arrive dans le dossier plugins/. Si tu veux le pack complet, l'assistant de protection du monde, sur la page des plugins, installe LuckPerms avec WorldGuard et WorldEdit en une seule étape. Après le redémarrage, le plugin affiche sa version et son auteur lorsque tu rejoins le serveur.

Chat après la connexion : LuckPerms 5.5.71 est chargé, avec son site web et son auteur (Enlarge image)

Ce message apparaît lorsque tu saisis /luckperms ou simplement /lp sans argument. C'est le moyen le plus rapide de vérifier que le plugin fonctionne réellement.

Comment les permissions sont structurées dans LuckPerms

Un nœud de permission est une chaîne de caractères comme essentials.home ou worldedit.region.set. Chaque plugin apporte ses propres nœuds et les documente. Un nœud peut être défini sur true ou false. L'astérisque de worldedit.* couvre tous les nœuds d'un plugin : c'est pratique pour la modération, mais dangereux pour les joueurs normaux.

LuckPerms distingue trois niveaux :

  • Les groupes rassemblent des nœuds. Chaque joueur reçoit automatiquement le groupe default.
  • Les joueurs héritent de leurs groupes et peuvent aussi posséder leurs propres nœuds.
  • Les contextes limitent la portée des nœuds, par exemple à un monde ou à un mode de jeu.

Garde une structure simple. Deux à quatre groupes suffisent pour la plupart des serveurs.

Créer le premier groupe

Les commandes suivantes s'exécutent dans la console du serveur ou en jeu en tant qu'opérateur :

/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user NomDuJoueur parent add mod

La première ligne crée le groupe. Les deux lignes permission set lui donnent un accès complet à WorldEdit ainsi que la commande de kick d'EssentialsX. La dernière ligne ajoute un joueur au groupe. Tu peux vérifier le résultat avec /lp user Spielername permission check essentials.kick.

Pour le groupe default, il vaut mieux faire l'inverse : retirer les commandes dont les joueurs n'ont pas besoin. Sans la permission bukkit.command.plugins, Paper n'affiche plus du tout la commande /plugins ; le joueur voit seulement un message d'erreur indiquant une commande inconnue.

Sans la permission bukkit.command.plugins, le serveur signale une commande inconnue (Enlarge image)
/lp group default permission set bukkit.command.plugins false

Ce n'est pas une mesure de sécurité à proprement parler, mais cela cache la liste des plugins aux invités trop curieux.

L'éditeur web

Pour les modifications importantes, la console n'est pas très pratique. /lp editor génère un lien vers l'éditeur web sur luckperms.net. Tu y vois tous les groupes et tous les joueurs dans un tableau, tu peux définir les nœuds à la souris, puis renvoyer la session vers le serveur en un clic. Le lien n'est valable que quelques minutes et ne peut être utilisé qu'avec le code généré. Les sessions contiennent des noms de joueurs et des UUID, alors ne partage pas le lien.

Erreurs courantes

  • Une permission ne fonctionne pas. Le joueur est encore opérateur. Les opérateurs contournent LuckPerms. Retire-lui le statut op et utilise uniquement les groupes.
  • Nœud mal orthographié. LuckPerms accepte n'importe quel texte, y compris les fautes de frappe. Vérifie le nœud dans la documentation du plugin concerné.
  • Astérisque dans default. Un nœud * dans le groupe par défaut donne tous les droits à chaque invité. N'utilise les astérisques que dans les groupes de modération.
  • Modifications perdues après un redémarrage. Par défaut, LuckPerms enregistre ses données dans un fichier H2 situé dans le dossier du plugin. Si ce dossier n'est pas accessible en écriture au redémarrage, les modifications sont perdues. Un coup d'œil à la console au démarrage te montrera l'erreur.

Emplacement des données et sauvegarde

Toutes les données se trouvent dans plugins/LuckPerms/. La sauvegarde du panel inclut ce dossier. Pour les réseaux de plusieurs serveurs, LuckPerms propose une base de données MySQL commune ; pour un serveur unique, H2 reste le choix le plus simple.

Pour aller plus loin

Pour savoir comment installer et mettre à jour des plugins en général, consulte le guide Installer et gérer des plugins. La protection du monde avec des régions est expliquée dans WorldGuard : protéger des régions, et les outils de construction dans WorldEdit : construire et annuler des modifications.

Sources

LuckPerms: Voir l'exemple

Captures réalisées dans un environnement de démonstration. La version et la configuration présentées peuvent différer de celles de ton serveur.

LuckPerms: Sans autorisation, la commande de liste des plugins testée n'est pas disponible.
Sans autorisation, la commande de liste des plugins testée n'est pas disponible.

LuckPerms 5.5.71 · 2026-09-12

LuckPerms: Après le changement de droits, la même commande affiche la liste des plugins.
Après le changement de droits, la même commande affiche la liste des plugins.

LuckPerms 5.5.71 · 2026-09-12