LuckPerms est le plugin de permissions qui te permet, sur un serveur Paper ou Spigot, de définir qui peut utiliser quelles commandes. Sans plugin de permissions, il n'existe que deux niveaux : opérateur avec tous les droits, et joueur normal avec presque rien. LuckPerms insère des groupes entre les deux : invités, bâtisseurs, modération. Chaque groupe porte des nœuds de permission, et les joueurs héritent des nœuds de leurs groupes.

Ce guide te montre le chemin de l'installation jusqu'à ton premier groupe de modération. Les commandes proviennent de la documentation officielle de LuckPerms ; les captures d'écran d'un serveur de test avec Paper 1.21.4 et LuckPerms 5.5.71.

Installation via le panel

Dans le panel de ton serveur, tu trouves LuckPerms sous Plugins → Navigateur. La recherche récupère les données depuis Modrinth ; le loader et la version du serveur sont vérifiés par rapport aux métadonnées du plugin avant que le fichier n'atterrisse dans le dossier plugins/. L'assistant de protection du monde sur la page du plugin installe LuckPerms avec WorldGuard et WorldEdit en une seule étape, si tu souhaites obtenir le pack complet. Après le redémarrage, le plugin se signale à la connexion avec sa version et son auteur.

Chat après connexion : LuckPerms 5.5.71 est chargé, avec le site web et l'auteur
Chat après connexion : LuckPerms 5.5.71 est chargé, avec le site web et l'auteur

Ce message apparaît quand tu saisis /luckperms ou en version courte /lp sans arguments. C'est le test le plus rapide pour vérifier que le plugin fonctionne réellement.

Comment les droits sont structurés 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 worldedit.* couvre tous les nœuds d'un plugin et se révèle pratique pour la modération, mais dangereux pour les joueurs normaux.

LuckPerms connaît trois niveaux :

  • Les groupes regroupent des nœuds. Le groupe default est attribué automatiquement à chaque joueur.
  • Les joueurs héritent de leurs groupes et peuvent en plus porter leurs propres nœuds.
  • Les contextes restreignent les 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 tant qu'opérateur en jeu :

/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 WorldEdit en intégralité et la commande kick d'EssentialsX. La dernière ligne ajoute un joueur au groupe. Tu peux vérifier le résultat avec /lp user Nomdujoueur permission check essentials.kick.

Pour le groupe default, la démarche inverse est judicieuse : retirer les commandes dont les joueurs n'ont pas besoin. Sans le droit bukkit.command.plugins, Paper n'affiche même plus la commande /plugins ; le joueur ne voit qu'un message d'erreur signalant une commande inconnue.

Sans le droit bukkit.command.plugins, le serveur signale une commande inconnue
Sans le droit bukkit.command.plugins, le serveur signale une commande inconnue
/lp group default permission set bukkit.command.plugins false

Ce n'est pas une mesure de sécurité au sens strict, mais cela tient la liste des plugins éloignée des invités curieux.

L'éditeur web

Pour des modifications plus importantes, la console devient vite fastidieuse. /lp editor génère un lien vers l'éditeur web sur luckperms.net. Tu y vois tous les groupes et joueurs dans un tableau, tu peux définir des nœuds à la souris et transférer la session en un clic vers le serveur à la fin. Le lien est valable quelques minutes seulement et n'est utilisable qu'avec le code généré. Les sessions contiennent les noms de joueurs et les UUID, donc ne partage pas ce lien.

Erreurs typiques

  • Un droit n'a pas d'effet. Le joueur est encore opérateur. Les opérateurs contournent LuckPerms. Retire le statut op et travaille uniquement avec des 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 standard donne tout à chaque invité. Ne place des astérisques que dans les groupes de modération.
  • Modifications perdues après redémarrage. LuckPerms enregistre par défaut 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 dans la console au démarrage révèle l'erreur.

Emplacement de stockage et sauvegarde

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

FAQ

Pourquoi un droit retiré n'a-t-il aucun effet sur moi-même ?

Parce que tu es opérateur. Les opérateurs contournent entièrement LuckPerms — chaque vérification leur est favorable. Retire-toi le statut op et travaille toi aussi avec un groupe de modération, sinon tu ne testes pas tes propres règles dans des conditions réelles.

Ai-je besoin d'une base de données MySQL pour LuckPerms ?

Pas pour un serveur unique. LuckPerms enregistre par défaut dans un fichier H2 sous plugins/LuckPerms/, que la sauvegarde du panel inclut également. MySQL ne devient intéressant que lorsque plusieurs serveurs d'un réseau doivent partager les mêmes groupes et droits.

Combien de groupes sont raisonnables ?

Deux à quatre suffisent pour la grande majorité des serveurs : default pour tous, un groupe de construction et un groupe de modération. Des chaînes d'héritage profondes rendent difficile de savoir d'où provient un droit — garde une structure simple et n'attribue des nœuds astérisque que dans les groupes de modération.

Comment vérifier si un joueur possède un droit précis ?

Avec /lp user Nomdujoueur permission check noeud — la réponse indique le résultat et son origine, c'est-à-dire s'il est hérité d'un groupe ou défini directement. /lp user Nomdujoueur info affiche tous les groupes du joueur en un coup d'œil.

Le lien de l'éditeur web est-il sûr ?

Il n'est valable que quelques minutes et inutilisable sans le code généré. La session contient toutefois les noms de joueurs et les UUID de ton serveur — ne le partage donc pas et génère plutôt un nouveau lien si tu as un doute.

Guides complémentaires

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

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.

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

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