3 min de lecture Intermédiaire 5.8k

Installer et configurer LuckPerms sur Minecraft Paper/Spigot

Publié le 18 mai 2026 à 15:59

LuckPerms est le système de permissions standard du monde Minecraft moderne. Guide pas à pas pour l'installer chez VeryCloud sur Paper/Spigot, créer des groupes, donner des permissions, et le brancher à MySQL pour un réseau.

Introduction

LuckPerms remplace les anciens PermissionsEx, GroupManager, etc. C'est rapide, async, supporte MySQL pour les réseaux multi-serveurs, et la web UI est excellente. Si tu utilises encore PermissionsEx en 2026, c'est le moment de migrer.

Prérequis

Un serveur Paper ou Spigot chez VeryCloud
Accès au gestionnaire Files du panel Wisp
Optionnel : une BDD MySQL si tu fais du multi-serveur

Étape 1 : Télécharger LuckPerms

Va sur https://luckperms.net/download et choisis :

Platform : Bukkit (pour Paper / Spigot / Purpur)
Version : la dernière stable
Télécharge le .jar

Pour Velocity ou BungeeCord, choisis le variant correspondant.

Étape 2 : Installer le plugin

Dans Wisp → Files :

Va dans /plugins/
Upload LuckPerms-Bukkit-5.x.x.jar
Restart le serveur

Au boot, LuckPerms génère ses fichiers de config dans /plugins/LuckPerms/.

Étape 3 : Vérifier l'installation

Dans la console (panel ou en jeu en tant qu'OP) :

/lp info

Tu dois voir la version, le storage backend (H2 par défaut), et les options actives.

Étape 4 : Créer un premier groupe

/lp creategroup admin
/lp creategroup moderator
/lp creategroup default

Le groupe default est appliqué automatiquement à tous les joueurs.

Étape 5 : Ajouter des permissions à un groupe

/lp group admin permission set essentials.* true
/lp group admin permission set worldedit.* true
/lp group admin permission set luckperms.* true

Ou avec la web UI (recommandé pour les opérations massives) :

/lp editor

Cette commande génère un lien temporaire vers https://luckperms.net/editor où tu édites graphiquement.

Étape 6 : Ajouter un joueur à un groupe

/lp user MathysAdmin parent set admin
/lp user JoueurNuit parent set moderator

À la connexion suivante, les permissions du groupe sont héritées.

Étape 7 : Hiérarchie et héritage

Tu peux structurer une hiérarchie : default < vip < moderator < admin.

/lp group vip parent set default
/lp group moderator parent set vip
/lp group admin parent set moderator

Un joueur dans admin hérite des permissions de tous les groupes en dessous.

Étape 8 : Storage MySQL (réseau multi-serveurs)

Pour partager les permissions entre plusieurs serveurs Minecraft (proxy BungeeCord/Velocity + plusieurs backends), passe au storage MySQL.

Édite /plugins/LuckPerms/config.yml :

storage-method: mysql

data:
  address: ton.mysql.host:3306
  database: luckperms
  username: lp_user
  password: 'mdp_solide'

  pool-settings:
    maximum-pool-size: 10
    minimum-idle: 2
    maximum-lifetime: 1800000
    connection-timeout: 5000

messaging-service: sql

Le messaging-service: sql synchronise les permissions entre serveurs en temps réel via une table MySQL dédiée. Plus besoin de reload manuel.

Restart chaque serveur pour appliquer.

Étape 9 : Permissions temporaires

Utile pour des passes VIP temporaires :

/lp user JoueurPass parent addtemp vip 7d
/lp user JoueurPass permission settemp essentials.fly true 1h

LuckPerms gère la révocation automatique à expiration.

Étape 10 : Permissions par monde

/lp group admin permission set essentials.fly true world=creative

La permission n'est active que dans le monde creative.

Dépannage

Les permissions ne s'appliquent pas

Le joueur doit se reconnecter après l'ajout au groupe
Vérifie avec /lp user <nom> info que le parent est bien set
Cache éventuel : /lp sync

Conflit avec un autre plugin de permissions

Désinstalle complètement PEX/GroupManager avant LuckPerms (les deux ne cohabitent pas)
Supprime leurs fichiers de données

Connexion MySQL refusée

IP source whitelisted côté MySQL ? GRANT ... ON luckperms.* TO 'lp_user'@'IP_MC'
Port 3306 ouvert dans le firewall ?

La web UI ne se charge pas

Le lien /lp editor expire après quelques minutes
Régénère-le si besoin

Commandes utiles

/lp info                              # info plugin
/lp user <nom> info                   # info joueur
/lp group <nom> info                  # info groupe
/lp group <nom> setweight <nb>        # poids hierarchique
/lp editor                            # web UI
/lp sync                              # forcer le reload
/lp tree                              # arbre des permissions
/lp verbose record                    # debug perms en live

Conclusion

LuckPerms est la référence en 2026 : performant, complet, multi-serveur via MySQL. La web UI fait gagner un temps fou pour des configs complexes. Pour un serveur sérieux chez VeryCloud, c'est le standard.

Pour aller plus loin : intégration Discord (Discord SRV + LuckPerms), permissions contextuelles avancées, audit log des changements.