Gérer les permissions et les grades avec LuckPerms

À quoi sert LuckPerms ?

Configurer LuckPerms permet de déterminer précisément les commandes et fonctionnalités accessibles à chaque joueur sur votre serveur Minecraft. Vous pouvez créer des grades comme Joueur, VIP, Modérateur ou Administrateur, puis leur attribuer des permissions différentes.

Une permission est un identifiant associé à une action. Par exemple, un plugin de téléportation peut utiliser une permission comme plugin.teleport, tandis qu’une commande de modération peut être contrôlée par un nœud comme minecraft.command.kick.

LuckPerms permet notamment de :

• créer des groupes correspondant aux grades du serveur ;
• autoriser ou refuser des commandes ;
• attribuer un ou plusieurs groupes à un joueur ;
• organiser un système d’héritage entre les grades ;
• ajouter des préfixes et des couleurs ;
• appliquer des permissions selon un monde, un serveur ou un contexte précis.

LuckPerms est un plugin. Votre serveur doit donc utiliser Paper, Spigot ou une plateforme compatible avec les plugins Bukkit. Il ne fonctionne pas sur un serveur Vanilla sans couche logicielle compatible.

Si votre serveur n’accepte pas encore les plugins, commencez par suivre le guide pour installer un plugin sur un serveur Minecraft.

LuckPerms gère les autorisations, mais ne crée pas les commandes. Pour accorder une commande ajoutée par un autre plugin, celui-ci doit être installé et vous devez connaître son nœud de permission exact.

Installer LuckPerms sur le serveur

Téléchargez la version Bukkit de LuckPerms depuis sa page officielle ou une plateforme reconnue comme Modrinth. Vérifiez que le fichier correspond bien à votre type de serveur.

Arrêtez ensuite complètement le serveur avant de modifier ses fichiers.

Évitez d’utiliser la commande /reload pour installer ou mettre à jour un plugin. Un redémarrage complet est plus fiable et limite les problèmes de chargement.

Depuis le gestionnaire de fichiers du panel TalCloud :

1. ouvrez le dossier plugins/ ;
2. déposez le fichier .jar de LuckPerms ;
3. redémarrez le serveur ;
4. consultez la console pour vérifier son chargement.

L’arborescence doit ressembler à ceci :

serveur-minecraft/
├── plugins/
│   ├── LuckPerms-Bukkit.jar
│   └── LuckPerms/
├── server.properties
└── world/

Après le premier démarrage, LuckPerms crée son dossier de configuration. Vous pouvez vérifier que le plugin répond avec :

/lp info

Depuis la console du panel, retirez simplement la barre oblique :

lp info

Si la commande est inconnue, vérifiez que le fichier se trouve directement dans plugins/, que le serveur utilise Paper ou Spigot et qu’aucune erreur LuckPerms n’apparaît dans les logs.

Comprendre les groupes, les permissions et l’héritage

Dans LuckPerms, un groupe correspond généralement à un grade. Un joueur placé dans le groupe vip récupère les permissions attribuées à ce groupe.

Le groupe default existe normalement dès l’installation. Tous les joueurs en héritent automatiquement. Vous pouvez l’utiliser comme grade de base ou créer un groupe joueur pour rendre votre organisation plus explicite.

L’héritage évite de répéter les mêmes permissions dans chaque groupe. Par exemple :

default
└── joueur
    ├── vip
    └── modo
        └── admin

Dans cette organisation :

• joueur contient les permissions de base ;
• vip hérite des permissions de joueur et reçoit des avantages supplémentaires ;
• modo hérite de joueur et reçoit des outils de modération ;
• admin hérite de modo et récupère donc aussi les permissions de modération.

Vous pouvez créer cet héritage avec :

/lp group joueur parent add default
/lp group vip parent add joueur
/lp group modo parent add joueur
/lp group admin parent add modo

Ainsi, une permission ajoutée plus tard au groupe joueur sera automatiquement transmise aux groupes qui en héritent.

Évitez de donner directement toutes les permissions à chaque joueur. Centralisez-les dans des groupes : votre configuration sera plus simple à vérifier, modifier et sécuriser.

Créer des grades et configurer LuckPerms

Créer les groupes

Utilisez la commande creategroup pour créer les grades :

/lp creategroup joueur
/lp creategroup vip
/lp creategroup modo
/lp creategroup admin

Vous pouvez vérifier un groupe avec :

/lp group vip info

Attribuer une permission à un groupe

La syntaxe générale est :

/lp group <groupe> permission set <permission> true

Par exemple, pour autoriser les modérateurs à utiliser la commande native d’expulsion :

/lp group modo permission set minecraft.command.kick true

Pour autoriser le bannissement :

/lp group modo permission set minecraft.command.ban true

Pour accorder une permission provenant d’un plugin, remplacez le nœud par celui indiqué dans sa documentation. Par exemple, si EssentialsX est installé :

/lp group vip permission set essentials.fly true

Pour retirer une permission explicitement définie :

/lp group vip permission unset essentials.fly

Pour refuser une permission, définissez-la sur false :

/lp group joueur permission set minecraft.command.ban false

N’utilisez pas systématiquement les permissions génériques terminées par .*. Elles peuvent donner accès à des commandes sensibles ajoutées lors d’une future mise à jour.

Mettre un joueur dans un groupe

Pour remplacer le groupe principal d’un joueur :

/lp user Pseudo parent set vip

La commande parent set remplace les groupes définis dans le même contexte. Utilisez-la lorsque le joueur doit avoir un seul grade principal.

Pour ajouter un groupe sans supprimer les groupes existants :

/lp user Pseudo parent add vip

Cette seconde méthode est utile pour cumuler des rôles, par exemple un grade VIP et un groupe technique temporaire.

Pour retirer un groupe :

/lp user Pseudo parent remove vip

Enfin, vérifiez la configuration du joueur avec :

/lp user Pseudo info

Vous pouvez également tester une permission précise :

/lp user Pseudo permission check essentials.fly

Ajouter des préfixes et des couleurs aux grades

Un préfixe permet d’associer un texte à un grade, par exemple [VIP], [Modo] ou [Admin].

La syntaxe est :

/lp group <groupe> meta setprefix <priorité> "<préfixe>"

Voici une configuration simple :

/lp group joueur meta setprefix 10 "&7[Joueur] "
/lp group vip meta setprefix 50 "&6[VIP] "
/lp group modo meta setprefix 80 "&2[Modo] "
/lp group admin meta setprefix 100 "&c[Admin] "

Quelques codes couleur classiques :

Code	Couleur
&7	Gris
&6	Or
&2	Vert foncé
&9	Bleu
&c	Rouge
&f	Blanc

La valeur numérique correspond à la priorité du préfixe. Lorsqu’un joueur hérite de plusieurs préfixes, celui dont la priorité est la plus élevée est généralement sélectionné.

LuckPerms enregistre les préfixes, mais ne les affiche pas lui-même dans le chat ou la liste des joueurs. Vous devez utiliser un plugin de chat ou de tablist compatible avec LuckPerms, souvent par l’intermédiaire de Vault.

Si le grade fonctionne mais que son préfixe reste invisible, le problème vient généralement du plugin d’affichage, et non de LuckPerms.

Vous pouvez vérifier le préfixe détecté pour un joueur avec :

/lp user Pseudo meta info

Selon le plugin de chat utilisé, les couleurs peuvent être définies avec les codes classiques comme &c ou avec un format moderne tel que MiniMessage. Consultez la documentation du plugin chargé de l’affichage.

Utiliser l’éditeur web LuckPerms

L’éditeur web est souvent plus simple que les commandes pour configurer LuckPerms, surtout lorsque vous devez gérer plusieurs groupes et de nombreuses permissions.

Lancez cette commande depuis le jeu ou la console :

/lp editor

LuckPerms génère alors un lien temporaire. Ouvrez-le dans votre navigateur pour afficher les groupes, les utilisateurs, les permissions, les héritages et les métadonnées.

Dans l’éditeur, vous pouvez :

• sélectionner un groupe ;
• ajouter ou supprimer une permission ;
• définir la valeur sur true ou false ;
• ajouter un groupe parent ;
• créer un préfixe ;
• limiter une permission à un contexte ;
• comparer plus facilement les différents grades.

Une fois les modifications terminées, cliquez sur le bouton d’enregistrement. L’éditeur génère une commande que vous devez copier et exécuter sur le serveur pour appliquer les changements.

Enregistrer la page web ne suffit pas : les modifications ne sont appliquées qu’après l’exécution de la commande générée par l’éditeur.

Pour limiter les éléments chargés dans l’éditeur, vous pouvez demander uniquement les groupes :

/lp editor groups

Après l’application, contrôlez les groupes importants et testez les commandes avec un compte non administrateur. Cela évite de croire qu’une permission fonctionne alors que votre statut d’opérateur contourne les restrictions.

En résumé

• Pour configurer LuckPerms, installez sa version Bukkit dans le dossier plugins/ d’un serveur Paper ou Spigot.
• Créez un grade avec /lp creategroup <groupe>.
• Ajoutez une permission avec /lp group <groupe> permission set <permission> true.
• Retirez-la avec /lp group <groupe> permission unset <permission>.
• Affectez un grade principal avec /lp user <joueur> parent set <groupe>.
• Organisez les grades avec l’héritage /lp group <groupe> parent add <parent>.
• Ajoutez un préfixe avec /lp group <groupe> meta setprefix <priorité> "<préfixe>".
• Utilisez /lp editor pour modifier visuellement les groupes et permissions.
• Installez un plugin de chat compatible pour afficher les préfixes.
• Testez toujours les droits avec un compte joueur non opérateur.
• Pour héberger votre serveur et configurer LuckPerms depuis un panel de gestion, découvrez l’offre serveur Minecraft TalCloud.