LuckPerms est le plugin de référence pour gérer les permissions sur un serveur Minecraft. Tu décides précisément ce que les joueurs peuvent faire, des commandes vanilla aux fonctions ajoutées par d’autres plugins. Ça tient sur un petit serveur entre amis comme sur un gros réseau.

Le logiciel doit prendre en charge les plugins. Sur Vanilla, le dossier plugins/ n’existe pas, donc LuckPerms ne démarre pas.

Aperçu rapide

Ouvre l’onglet Plugins, cherche LuckPerms et clique sur Ajouter au panier pour le build Paper.
Clique sur Redémarrer. Un simple reload ne charge pas le plugin.
Dans Console, tape lp editor (sans slash) et ouvre le lien.
Crée un groupe (par exemple default, vip, admin).
Ajoute des permissions (par exemple minecraft.command.gamemode).
Assigne un joueur : /lp user <joueur> parent set <groupe>

Qu’est-ce qu’une permission ?

Sur un serveur, chaque commande et chaque fonction repose sur une permission. Certaines viennent de Minecraft, d’autres des plugins. La permission décide qui a le droit d’agir.

Une permission, c’est un texte séparé par des points, par exemple :

minecraft.command.ban

C’est la permission pour /ban (voir Comment bannir et débannir un joueur sur un serveur Minecraft).

Chaque plugin peut avoir ses propres permissions
LuckPerms centralise leur gestion
Tu les attaches à un joueur ou à un groupe

Installer LuckPerms

Ouvre ton serveur, puis l’onglet Plugins. Dans le champ de recherche (Rechercher des plugins…), tape LuckPerms. Active Modrinth et Hangar. Clique sur Ajouter au panier pour le build Paper, pas une vieille variante abandonnée.

Le logiciel doit prendre en charge les plugins (Paper, Purpur ou Spigot). Vanilla ne lance pas LuckPerms. Change de fork avec Comment changer le type de serveur Minecraft dans Eternyx Dashboard.

Si tu préfères un upload manuel, télécharge le build adapté sur le site officiel LuckPerms. Ouvre Explorateur de fichiers, va dans plugins (ou mods sur Fabric ou Forge), puis clique sur Importer.

Après l’installation, clique sur Redémarrer.

Éditeur LuckPerms (interface web)

LuckPerms propose un éditeur web pour gérer groupes et permissions à la souris, sans tout faire dans la console.

Ouvrir l’éditeur

Dans Console, sans slash :

lp editor

Clique sur le lien généré.

Au premier accès, une fenêtre affiche une commande de confiance :

/lp trusteditor <code>

Colle-la dans Console. Sans cette étape, l’éditeur reste verrouillé. Ensuite l’interface se charge et tu travailles dedans.

Ce que tu fais dans l’éditeur

créer des groupes (rangs)
ajouter des permissions
gérer les joueurs

Créer un groupe

Clique sur + à côté de GROUP et remplis :

Option	Signification
Group name	Nom interne du groupe
Display name	Nom affiché
Weight	Priorité (plus le chiffre est haut, plus ça prime)
Parent	Groupe parent
Prefix/Suffix	Tag avant ou après le nom

Ajouter une permission

Ouvre le groupe et tape la permission dans la ligne du bas.

Exemples :

minecraft.command.ban : le joueur peut utiliser /ban
minecraft.command.gamemode : le joueur peut changer de mode de jeu (creative, survival)
minecraft.command.whitelist : le joueur peut gérer la whitelist

Mets true ou false pour autoriser ou interdire. Si tu mets bukkit.command.plugins à FALSE, ce groupe ne pourra plus utiliser /pl. Le changement s’applique tout de suite. Pour rendre l’accès, remets le même node à true, ou retire-le avec permission unset.

Commandes de base LuckPerms

Commandes générales

/lp help : aide et liste des commandes
/lp creategroup <groupe> : crée un groupe
/lp deletegroup <groupe> : supprime un groupe
/lp listgroups : liste les groupes
/lp editor : ouvre le lien de l’éditeur web

Permissions joueur

/lp user <joueur> : commandes de gestion du joueur
/lp user <joueur> permission set <permission> : ajoute une permission (ajoute false pour refuser)
/lp user <joueur> permission unset <permission> : retire une permission
/lp user <joueur> permission info : liste les permissions du joueur

Groupes

/lp group <groupe> : commandes de gestion du groupe
/lp group <groupe> permission set <permission> : ajoute une permission au groupe
/lp group <groupe> permission unset <permission> : retire une permission du groupe
/lp group <groupe> permission info : liste les permissions du groupe
/lp group <groupe> meta setprefix <prefix> : définit le préfixe du groupe

Assigner des groupes

/lp user <joueur> parent set <groupe> : définit le groupe principal
/lp user <joueur> parent addtemp <groupe> 7d : groupe temporaire (par exemple 7 jours)

Héritage de groupes

/lp group <groupe> parent set <parent> : le groupe hérite des permissions du parent

Base MySQL (avancé)

Sans base de données, les permissions restent locales et ne se synchronisent pas sur un réseau. Si tu tournes avec BungeeCord ou Velocity, MySQL est obligatoire pour la sync.

Configurer MySQL

Ouvre /plugins/LuckPerms/config.yml
Règle :

storage-method: MySQL
data:
  address: <IP>
  database: <nom-de-la-base>
  username: <utilisateur>
  password: '<mot-de-passe>'

De mauvais identifiants empêchent LuckPerms de se connecter. Le serveur peut quand même démarrer, mais les permissions restent fausses ou figées sur l’ancien stockage local. Vérifie l’adresse, le nom de la base, l’utilisateur et le mot de passe, puis clique sur Redémarrer.

Crée la base avec Comment créer une base de données dans Eternyx Dashboard.

Proxy (BungeeCord / Velocity)

LuckPerms tourne aussi sur un proxy (BungeeCord ou Velocity). C’est le setup classique des grands réseaux.

Comment les pièces s’assemblent

Installe LuckPerms sur le proxy (build BungeeCord ou Velocity)
Installe LuckPerms sur chaque backend (Paper, Spigot, etc.)
Tous les serveurs doivent utiliser la même base MySQL, sinon les permissions restent isolées

Les joueurs gardent alors les mêmes groupes et droits sur tout le réseau.

Commandes sur le proxy

Sans MySQL partagé entre proxy et backends, utilise des commandes différentes :

/lpb : sur BungeeCord
/lpv : sur Velocity

Avec une base correctement partagée, utilise :

/lp : marche sur tous les serveurs

Configurer les préfixes

LuckPerms stocke et gère les préfixes. Il ne les affiche pas tout seul en jeu. Pour voir un préfixe dans le chat ou dans la liste TAB, il te faut d’autres plugins. Le logiciel doit prendre en charge les plugins.

Plugins qui affichent les préfixes

Chat

LPC (LuckPerms Chat) : recommandé
EssentialsX Chat : module d’EssentialsX

Liste TAB

TAB (by NEZNAMY)

Problèmes fréquents

Les commandes LuckPerms ne font rien

Vérifie que tu as OP. Dans Console, sans slash : op <ton_pseudo>. Voir Comment donner OP à un joueur sur un serveur Minecraft.

Contrôle que LuckPerms s’est bien chargé et que la console ne signale pas d’erreur pour ce plugin.

Préfixes absents dans le chat ou le TAB

Le joueur doit être dans le bon groupe
Si le préfixe apparaît seulement à un endroit (TAB oui, chat non), il manque un plugin de chat
Vérifie le weight des groupes : le chiffre le plus haut l’emporte
Utilise des plugins compatibles (LPC, EssentialsX Chat, TAB)

Les permissions ne marchent pas

N’utilise qu’un seul plugin de permissions (LuckPerms)
La permission doit vraiment exister (chaque plugin a ses propres nodes)
Vérifie que tu ne l’as pas mise à false
Après de gros changements, clique sur Redémarrer

Sur les serveurs Fabric, les permissions vanilla Minecraft s’appliquent souvent mal. C’est une limite de Fabric.

Les permissions ne se synchronisent pas entre serveurs

MySQL n’est pas configuré
Chaque serveur stocke en local : configure MySQL (voir la section plus haut)
Tous les serveurs doivent utiliser les mêmes identifiants de base

Les préfixes s’affichent dans le mauvais ordre

Mauvaises valeurs de weight des groupes
Plusieurs groupes sur un même joueur peuvent se chevaucher
Revois l’ordre et la priorité des groupes

Pour un serveur privé, configure aussi une whitelist.

LuckPerms : configurer les permissions sur un serveur Minecraft