LuckPerms : créer des grades et des permissions sur son serveur Minecraft

Introduction

LuckPerms est le plugin de permissions de référence pour les serveurs Minecraft Paper, Spigot et Purpur : il sert à créer des grades (joueur, VIP, modérateur, admin), à leur donner des droits précis et à les attribuer aux joueurs, sans jamais donner l'op à personne d'autre que le propriétaire. Ce guide montre l'installation, la création d'une hiérarchie de grades, les préfixes dans le chat et l'éditeur web, avec les commandes exactes.

Installer LuckPerms sur votre serveur

LuckPerms est un plugin : il demande un serveur Paper, Spigot ou Purpur (pas Vanilla, ni Forge ou Fabric pour cette version).

1. Depuis le panel. Sur serv-minecraft, ouvrez l'onglet Plugins de votre serveur, cherchez « LuckPerms » et cliquez sur Installer. Le fichier est déposé dans le dossier plugins.
2. À la main. Téléchargez la version Bukkit sur le site officiel luckperms.net et envoyez le .jar dans plugins avec le gestionnaire de fichiers du panel.
3. Redémarrez le serveur (pas de /reload). Dans la console, la ligne « Successfully enabled » confirme le chargement.

Ajoutez aussi Vault : c'est le pont qui permet aux autres plugins (chat, économie, boutique) de lire les grades LuckPerms. La liste des autres plugins utiles est dans notre guide des plugins indispensables pour un serveur Minecraft.

Comprendre groupes, permissions et héritage

• Une permission (ou « nœud ») est un droit nommé, comme essentials.home ou worldedit.*. Chaque plugin documente les siennes.
• Un groupe est un grade : un paquet de permissions. Tout joueur est d'abord dans le groupe default.
• L'héritage évite de tout recopier : le groupe vip hérite de default, modo hérite de vip, et ainsi de suite.

Toutes les commandes commencent par /lp en jeu, ou lp sans le slash dans la console du panel, qui a tous les droits.

Créer une hiérarchie de grades pas à pas

Exemple avec trois grades au-dessus de default :

lp creategroup vip
lp creategroup modo
lp creategroup admin
lp group vip parent add default
lp group modo parent add vip
lp group admin parent add modo
lp group vip setweight 10
lp group modo setweight 20
lp group admin setweight 30

Le poids (weight) départage les grades quand un joueur en a plusieurs : le plus lourd l'emporte, notamment pour le préfixe.

Donnez ensuite les droits à chaque groupe :

lp group default permission set essentials.home true
lp group vip permission set essentials.sethome.multiple true
lp group modo permission set essentials.kick true
lp group modo permission set coreprotect.lookup true
lp group admin permission set worldedit.* true

Pour retirer un droit hérité, mettez-le à false sur le groupe concerné.

Attribuer un grade à un joueur

lp user Pseudo parent add vip
lp user Pseudo parent set modo
lp user Pseudo parent addtemp vip 30d
lp user Pseudo info

parent add ajoute un grade, parent set remplace tous les grades du joueur, addtemp donne un grade pour une durée (pratique pour un VIP d'un mois). info affiche les grades et le préfixe actuels.

Pour promouvoir en une commande, créez une piste (track) : lp createtrack staff, puis lp track staff append vip, lp track staff append modo, lp track staff append admin. Ensuite lp user Pseudo promote staff fait monter le joueur d'un cran.

Préfixes dans le chat et éditeur web

lp group vip meta setprefix 10 "&6[VIP] "
lp group modo meta setprefix 20 "&2[Modo] "
lp group admin meta setprefix 30 "&c[Admin] "

LuckPerms stocke le préfixe, mais ne l'affiche pas lui-même : il faut un plugin de chat qui le lit via Vault, comme EssentialsX Chat ou LPC. Sans lui, le préfixe n'apparaît pas.

Pour tout gérer à la souris, tapez lp editor : LuckPerms donne un lien vers un éditeur web où vous cochez les permissions, glissez les joueurs entre groupes et modifiez les préfixes. Cliquez sur « Save », puis collez dans la console la commande lp applyedits … affichée.

Pour trouver le nom d'une permission, lp verbose on affiche en direct toutes les permissions vérifiées quand un joueur tape une commande. lp verbose off pour arrêter.

Questions fréquentes

LuckPerms fonctionne-t-il sur un serveur Vanilla ?

Non. Il faut Paper, Spigot ou Purpur. Il existe des versions Fabric, Forge et NeoForge à part, et des versions BungeeCord et Velocity pour les réseaux.

Faut-il encore donner l'op aux modérateurs ?

Non. L'op donne absolument tous les droits. Créez un groupe modo avec les seules commandes utiles et réservez l'op au propriétaire.

Pourquoi mon préfixe ne s'affiche pas ?

Il manque un plugin de chat (EssentialsX Chat, LPC) ou Vault. Vérifiez aussi le poids : si le joueur a deux grades, c'est le préfixe de priorité la plus haute qui gagne.

Comment voir les grades d'un joueur ?

lp user Pseudo info dans la console ou en jeu.

Comment retirer un grade ?

lp user Pseudo parent remove vip. Le joueur garde ses autres grades et revient à default s'il n'en a plus.

Comment donner un grade temporaire ?

lp user Pseudo parent addtemp vip 7d : le grade disparaît seul au bout de 7 jours. Les durées acceptent m, h, d, w et mo.

Où LuckPerms stocke-t-il les données ?

Par défaut dans une base H2, dans plugins/LuckPerms. Pour un réseau de plusieurs serveurs, passez en MySQL ou MariaDB dans config.yml.

Comment sauvegarder ses grades ?

lp export sauvegarde crée un fichier dans le dossier du plugin, lp import sauvegarde le restaure. Gardez aussi le dossier plugins/LuckPerms dans vos sauvegardes.

Que donne la permission luckperms.* ?

Le contrôle complet de LuckPerms, donc la possibilité de se donner tous les droits. Ne la donnez qu'aux administrateurs de confiance.

En résumé

Installez LuckPerms et Vault, créez vos groupes avec lp creategroup, enchaînez-les avec parent add, donnez les droits avec permission set, puis attribuez les grades aux joueurs. L'éditeur web (lp editor) fait le reste à la souris. L'offre Plugins de serv-minecraft est faite pour ce type de serveur : Paper, 12 Go de RAM et 6 vCPU pour 8,99 € par mois, avec l'installation des plugins en un clic depuis le panel.