Comment installer et configurer LuckPerms sur son serveur Minecraft

Introduction

LuckPerms est le gestionnaire de permissions le plus utilise sur les serveurs Minecraft. Il permet de creer des groupes (Admin, Moderateur, VIP, Joueur...) et de controler precisement ce que chaque joueur peut faire. Ce guide vous explique comment l installer et le configurer sur votre serveur OneHeberge.

---

Qu est-ce que LuckPerms ?

LuckPerms remplace le systeme de permissions basique de Minecraft et vous permet de :

• Creer des groupes avec des permissions precises
• Attribuer des permissions par commande sans editer de fichiers
• Configurer des prefixes/suffixes (avec un plugin de chat compatible)
• Gerer les permissions via une interface web pratique
• Stocker les donnees en MySQL ou fichiers locaux

---

Installation

Etape 1 : Telecharger LuckPerms

Rendez-vous sur https://luckperms.net et telechargez la version correspondant a votre serveur :

• Paper/Spigot → LuckPerms-Bukkit-x.x.x.jar
• Fabric → LuckPerms-Fabric-x.x.x.jar
• Forge → LuckPerms-Forge-x.x.x.jar

Etape 2 : Installer le plugin

1. Connectez-vous sur https://game.oneheberge.fr
2. Ouvrez le Gestionnaire de fichiers de votre serveur
3. Naviguez vers le dossier plugins/ (ou mods/ pour Fabric/Forge)
4. Uploadez le fichier .jar de LuckPerms
5. Redemptez le serveur

LuckPerms va generer automatiquement ses fichiers de configuration.

---

Configuration de base

Etape 3 : Creer vos groupes

Une fois le serveur redemarré, connectez-vous en jeu ou via la console. Creez vos groupes avec les commandes suivantes :

Creer un groupe Joueur (groupe par defaut) :

/lp creategroup joueur
/lp group joueur setweight 1

Creer un groupe VIP :

/lp creategroup vip
/lp group vip setweight 10

Creer un groupe Moderateur :

/lp creategroup moderateur
/lp group moderateur setweight 50

Creer un groupe Admin :

/lp creategroup admin
/lp group admin setweight 100

Etape 4 : Definir le groupe par defaut

/lp group joueur setdefault true

---

Ajouter des permissions

Permissions essentielles par groupe

Groupe Joueur :

/lp group joueur permission set essentials.spawn true
/lp group joueur permission set essentials.home true
/lp group joueur permission set essentials.warp true

Groupe VIP :

/lp group vip parent add joueur
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.kit.vip true

Groupe Moderateur :

/lp group moderateur parent add vip
/lp group moderateur permission set essentials.kick true
/lp group moderateur permission set essentials.mute true
/lp group moderateur permission set essentials.ban true

Groupe Admin :

/lp group admin parent add moderateur
/lp group admin permission set * true

La commande parent add permet d heriter des permissions du groupe parent.

---

Attribuer un groupe a un joueur

/lp user <pseudo> parent add <groupe>

Exemples :

/lp user Steve parent add vip
/lp user Alex parent add admin

Pour retirer un groupe :

/lp user Steve parent remove vip

---

Configurer les prefixes (avec EssentialsX Chat)

LuckPerms seul ne gere pas l affichage du prefix dans le chat. Installez EssentialsX (avec EssentialsXChat) :

/lp group vip meta setprefix "&6[VIP] "
/lp group moderateur meta setprefix "&9[Modo] "
/lp group admin meta setprefix "&c[Admin] "

Les codes couleur Minecraft : &a vert, &c rouge, &6 or, &b cyan, &9 bleu...

---

Interface Web LuckPerms

LuckPerms dispose d une interface web tres pratique pour gerer vos permissions visuellement :

1. Sur votre serveur, tapez : /lp editor
2. Une URL unique s affiche dans la console
3. Ouvrez cette URL dans votre navigateur
4. Editez les permissions, groupes, etc.
5. Cliquez sur Save et copiez la commande generee
6. Collez-la dans la console de votre serveur

---

Sauvegarder la configuration

LuckPerms sauvegarde automatiquement, mais vous pouvez forcer une sauvegarde :

/lp sync

---

Problemes frequents

Les permissions ne s appliquent pas :

• Verifiez que LuckPerms est bien charge (/plugins doit l afficher en vert)


• Relogguez le joueur concerne


• Verifiez que le groupe par defaut est bien attribue

Conflit avec PermissionsEx ou GroupManager :

• Retirez les anciens plugins de permissions


• LuckPerms peut importer les donnees depuis PermissionsEx

Prefix qui ne s affiche pas :

• Verifiez que EssentialsXChat est installe


• Configurez format dans config.yml d EssentialsXChat

---

Support

Notre equipe est disponible pour vous aider :

• Ticket depuis votre espace client sur oneheberge.fr


• Discord : https://discord.gg/oneheberge