Comment gérer les grades et permissions avec LuckPerms
Installez LuckPerms sur votre serveur Minecraft Paper, créez des grades, attribuez des permissions et des préfixes, puis vérifiez et sauvegardez votre configuration.
Sur cette page
LuckPerms est un plugin qui décide ce que chaque joueur a le droit de faire sur votre serveur. Ce guide vous explique comment l'installer, créer une hiérarchie de grades (joueur, VIP, modérateur, administrateur), y placer vos joueurs et contrôler le résultat.
Prérequis
- Un serveur sous Paper, avec la commande
mc-consolemise en place dans le guide Installer et mettre à jour des plugins sur Paper - Aucun autre plugin de permissions installé : LuckPerms doit être le seul
- Votre pseudo Minecraft, et des joueurs qui se sont déjà connectés au moins une fois
Dans ce guide, Steve et Alex sont des exemples : remplacez-les par de vrais pseudos.
Les notions à connaître
| Notion | Signification |
|---|---|
| Permission | Droit sous forme de texte, par exemple minecraft.command.ban. Sa valeur est true (accordé) ou false (refusé) |
| Groupe | Ensemble de permissions attribué à des joueurs : c'est votre grade |
| Parent | Groupe dont on hérite. Un joueur hérite de ses groupes, et un groupe peut hériter d'un autre |
| Poids | Priorité d'un groupe en cas de conflit. Le nombre le plus élevé l'emporte |
| Contexte | Condition d'application d'une permission, par exemple un monde précis |
| Piste (track) | Échelle de grades qui permet de promouvoir ou rétrograder un joueur |
Tous les joueurs appartiennent par défaut au groupe default, qui existe dès l'installation.
Installer LuckPerms
Téléchargez la version pour Bukkit/Paper dans le dossier plugins :
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
ls -l LuckPerms-*.jar
exitRedémarrez ensuite le serveur et attendez la ligne Done :
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fQuittez le suivi avec Ctrl+C, puis vérifiez que le plugin répond :
sudo mc-console 'lp info'La réponse indique la version de LuckPerms et le type de stockage utilisé.
Choisir le stockage
Par défaut, LuckPerms enregistre ses données dans une base locale H2, le fichier plugins/LuckPerms/luckperms-h2-v2.mv.db. Ce choix convient à un serveur unique, et vous n'avez rien à changer.
Si vous préférez des fichiers lisibles et modifiables, indiquez storage-method: yaml dans plugins/LuckPerms/config.yml, puis redémarrez le serveur. Si vous exploitez plusieurs serveurs qui partagent les mêmes grades, il vous faut une base distante comme MySQL ou MariaDB. Faites ce choix maintenant : c'est plus simple avant de créer vos groupes.
Vous donner l'accès aux commandes
Juste après l'installation, personne ne peut utiliser /lp en jeu. Seule la console y a accès. Donnez-vous tous les droits sur LuckPerms :
sudo mc-console 'lp user Steve permission set luckperms.* true'Vous pouvez ensuite utiliser /lp en jeu, ou continuer depuis la console comme dans la suite de ce guide.
Créer les grades
Voici la hiérarchie de l'exemple. Laissez de l'écart entre les poids pour pouvoir insérer un grade plus tard.
| Groupe | Poids | Hérite de | Rôle |
|---|---|---|---|
default |
1 | aucun | Tous les joueurs |
vip |
10 | default |
Joueurs privilégiés |
moderator |
50 | vip |
Modération |
admin |
100 | moderator |
Administration |
Créez les groupes et leurs poids :
sudo mc-console 'lp creategroup vip'
sudo mc-console 'lp creategroup moderator'
sudo mc-console 'lp creategroup admin'
sudo mc-console 'lp group default setweight 1'
sudo mc-console 'lp group vip setweight 10'
sudo mc-console 'lp group moderator setweight 50'
sudo mc-console 'lp group admin setweight 100'Définissez ensuite l'héritage. L'héritage se transmet : admin reçoit aussi les droits de vip et de default.
sudo mc-console 'lp group vip parent add default'
sudo mc-console 'lp group moderator parent add vip'
sudo mc-console 'lp group admin parent add moderator'Attribuer des permissions
Les commandes de Minecraft utilisent des permissions de la forme minecraft.command.<commande>. Donnez aux modérateurs de quoi expulser et bannir, et aux administrateurs des droits supplémentaires :
sudo mc-console 'lp group moderator permission set minecraft.command.kick true'
sudo mc-console 'lp group moderator permission set minecraft.command.ban true'
sudo mc-console 'lp group moderator permission set minecraft.command.pardon true'
sudo mc-console 'lp group admin permission set minecraft.command.gamemode true'
sudo mc-console 'lp group admin permission set minecraft.command.whitelist true'Pour retirer une permission, ou pour l'interdire explicitement :
sudo mc-console 'lp group moderator permission unset minecraft.command.pardon'
sudo mc-console 'lp group vip permission set minecraft.command.kick false'unset efface la ligne, tandis que false refuse activement le droit, même s'il est hérité d'ailleurs. Ces deux commandes sont des exemples : lancez-les seulement si vous souhaitez ces changements.
Pour connaître les permissions d'un plugin, consultez sa documentation. Vous pouvez aussi observer celles que le serveur contrôle lorsqu'un joueur tape une commande :
sudo mc-console 'lp verbose on Steve'Faites taper la commande au joueur, lisez le journal avec sudo journalctl -u minecraft.service -n 30 --no-pager, puis coupez le suivi :
sudo mc-console 'lp verbose off'Placer les joueurs dans les grades
# Remplace tous les groupes du joueur par ce grade
sudo mc-console 'lp user Steve parent set moderator'
# Ajoute un grade sans retirer les autres
sudo mc-console 'lp user Alex parent add vip'
# Retire un grade
sudo mc-console 'lp user Alex parent remove vip'
# Donne un grade pendant 30 jours
sudo mc-console 'lp user Alex parent addtemp vip 30d'Les modifications s'appliquent immédiatement, sans redémarrage.
Créer une piste de promotion
Une piste permet de faire monter ou descendre un joueur d'un cran, sans retenir le nom des grades. Elle ne change rien à l'héritage.
sudo mc-console 'lp createtrack staff'
sudo mc-console 'lp track staff append default'
sudo mc-console 'lp track staff append moderator'
sudo mc-console 'lp track staff append admin'
sudo mc-console 'lp user Alex promote staff'
sudo mc-console 'lp user Alex demote staff'Ajouter des préfixes
Un préfixe s'affiche devant le pseudo. Son poids décide lequel est retenu quand un joueur en hérite de plusieurs. Les codes comme &c définissent la couleur :
sudo mc-console 'lp group vip meta setprefix 10 "&6[VIP] "'
sudo mc-console 'lp group moderator meta setprefix 50 "&9[Modo] "'
sudo mc-console 'lp group admin meta setprefix 100 "&c[Admin] "'Conservez les guillemets simples autour de la commande complète et les guillemets doubles autour du préfixe.
Limiter une permission à un monde
Ajoutez un contexte à la fin de la commande. Le monde principal s'appelle world avec la configuration par défaut :
sudo mc-console 'lp group vip permission set minecraft.command.weather true world=world'Pour la retirer, indiquez le même contexte :
sudo mc-console 'lp group vip permission unset minecraft.command.weather world=world'Utiliser l'éditeur web
Si vous préférez une interface graphique, LuckPerms propose un éditeur dans le navigateur :
sudo MC_CONSOLE_WAIT=5 mc-console 'lp editor'Ouvrez le lien affiché, faites vos changements puis enregistrez. Si l'éditeur vous donne une commande à exécuter, lancez-la dans la console pour appliquer les modifications. Ne partagez pas ce lien : il donne accès à l'édition de vos permissions.
Vérifier le résultat
sudo mc-console 'lp listgroups'
sudo mc-console 'lp group moderator info'
sudo mc-console 'lp group moderator listmembers'
sudo mc-console 'lp user Steve info'
sudo mc-console 'lp user Steve permission check minecraft.command.kick'
sudo mc-console 'lp user Steve meta info'Vous devez retrouver vos quatre groupes, Steve dans moderator, la permission minecraft.command.kick à true et le préfixe [Modo].
Faites ensuite un essai réel avec un compte qui n'est pas opérateur. Un opérateur dispose déjà de la plupart des droits, ce qui masque les erreurs de configuration. Retirez ce statut si besoin :
sudo mc-console 'deop Steve'Sauvegarder les permissions
La commande suivante crée le fichier plugins/LuckPerms/sauvegarde-luckperms.json.gz :
sudo MC_CONSOLE_WAIT=5 mc-console 'lp export sauvegarde-luckperms'Pour restaurer ce fichier, placé dans plugins/LuckPerms, indiquez son extension :
sudo MC_CONSOLE_WAIT=5 mc-console 'lp import sauvegarde-luckperms.json.gz'Copiez régulièrement ce fichier hors du serveur, car une sauvegarde conservée au même endroit disparaîtrait avec lui.
Mettre à jour LuckPerms
Déposez la nouvelle version dans plugins/update, puis redémarrez. Paper remplace l'ancien fichier au démarrage :
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
exit
sudo systemctl restart minecraft.serviceEn cas de problème
« You do not have permission to use this command! »
Votre compte n'a pas accès à /lp. Donnez-vous luckperms.* depuis la console, comme indiqué plus haut.
« A user for Steve could not be found »
Le pseudo est mal écrit, ou ce joueur ne s'est jamais connecté. Vérifiez l'orthographe et demandez-lui de se connecter une première fois.
« A group named vip could not be found »
Le groupe n'existe pas encore. Vérifiez la liste avec sudo mc-console 'lp listgroups', puis créez-le avec lp creategroup.
« Cannot execute command 'lp' in plugin LuckPerms … plugin is disabled »
LuckPerms n'a pas réussi à démarrer. Cherchez la première erreur dans le journal :
sudo journalctl -u minecraft.service --no-pager | grep -i -A5 'luckperms' | grep -iE 'error|exception|caused by' | head -20
df -h /opt/minecraftUn disque plein (No space left on device) ou un dossier qui n'appartient pas à minecraft empêche le plugin de créer ses fichiers. Dans ce second cas, lancez sudo chown -R minecraft /opt/minecraft/server, puis redémarrez le serveur.
Une permission ne fonctionne pas
- Contrôlez-la avec
lp user Steve permission check <permission> - Vérifiez qu'aucun autre plugin de permissions n'est installé avec
sudo mc-console plugins - Testez avec un compte non opérateur
- Regardez si un groupe de poids supérieur la refuse avec
false - Utilisez
lp verbosepour voir le nom exact de la permission contrôlée
Le préfixe n'apparaît pas dans le chat
Vérifiez d'abord qu'il est bien enregistré avec lp user Steve meta info. S'il l'est, le problème vient de l'affichage : installez Vault et un plugin de chat. Si deux préfixes ont le même poids, donnez-leur des poids différents.
Les joueurs Bedrock ne sont pas reconnus
Les pseudos Bedrock commencent par un point avec Floodgate, ce que LuckPerms refuse par défaut. La marche à suivre se trouve dans le guide Accueillir les joueurs Bedrock avec Geyser et Floodgate.
Pour aller plus loin, consultez le wiki officiel de LuckPerms.