Comment installer et configurer LuckPerms sur Minecraft

LuckPerms est un plugin permettant de gérer facilement les permissions des joueurs sur un serveur Minecraft. Il permet notamment de créer des groupes, d'attribuer des permissions, de définir des grades et de mettre en place une hiérarchie entre les différents rôles de votre serveur.

Très utilisé sur les serveurs Minecraft basés sur Paper, Spigot et leurs dérivés, LuckPerms permet de gérer les permissions de manière beaucoup plus précise que le système d'opérateur intégré à Minecraft. Il est également compatible avec de nombreux plugins et propose un éditeur web permettant de configurer facilement les permissions sans avoir à saisir toutes les commandes manuellement.

Qu'est-ce que LuckPerms ?

LuckPerms est un plugin de gestion des permissions pour Minecraft. Il permet de contrôler les commandes et fonctionnalités auxquelles les joueurs ont accès, en les organisant notamment au sein de différents groupes.

Par exemple, vous pouvez créer des groupes comme Joueur, Modérateur et Administrateur, puis attribuer à chacun les permissions correspondantes.

LuckPerms fonctionne également avec un système d'héritage. Un groupe peut ainsi récupérer automatiquement les permissions d'un autre groupe, ce qui permet de construire facilement une hiérarchie de grades.

Avant de commencer

Avant d'installer LuckPerms sur votre serveur, assurez-vous que :

• Votre serveur est arrêté ;
• Votre serveur utilise Paper, Spigot ou un autre logiciel compatible avec LuckPerms ;
• Vous disposez d'une version de LuckPerms compatible avec votre version de Minecraft ;
• Vous avez accès au gestionnaire de fichiers de votre serveur.

Vous pouvez télécharger LuckPerms depuis le site officiel de LuckPerms ou depuis Modrinth.

Nous vous recommandons d'effectuer une sauvegarde de votre serveur Hosterfy avant toute modification. Vous pouvez créer une sauvegarde directement depuis votre panel Hosterfy, dans la section Configuration basique, puis Sauvegardes.

Étape 1 : Télécharger LuckPerms

Rendez-vous sur la page de téléchargement de LuckPerms et sélectionnez le fichier correspondant au logiciel utilisé par votre serveur.
Pour un serveur Minecraft utilisant Paper, Spigot ou un logiciel similaire, choisissez la version Bukkit / Paper / Spigot.
Le fichier téléchargé est fourni au format .jar. Assurez-vous de choisir une version compatible avec votre version de Minecraft.

Étape 2 : Installer LuckPerms sur le serveur

Accédez au gestionnaire de fichiers de votre serveur depuis votre panel Hosterfy ou connectez-vous en SFTP.
Ouvrez ensuite le dossier plugins situé à la racine de votre serveur.
Déposez le fichier .jar de LuckPerms précédemment téléchargé dans ce dossier.

Une fois le transfert terminé, démarrez puis redémarrez complètement votre serveur afin que LuckPerms puisse générer automatiquement ses fichiers.

⚠️ Évitez d'utiliser une commande de reload pour charger LuckPerms. Un redémarrage complet du serveur est recommandé après l'installation ou la modification importante d'un plugin.

Étape 3 : Vérifier l'installation

Une fois votre serveur démarré, ouvrez la console et recherchez les messages indiquant que LuckPerms a correctement été chargé.
Vous pouvez également exécuter la commande suivante en jeu ou depuis la console :

/lp info

Si LuckPerms est correctement installé, les informations concernant le plugin et sa version devraient s'afficher.

LuckPerms crée également automatiquement son dossier de configuration dans plugins/LuckPerms.
Vous y trouverez notamment son fichier de configuration ainsi que les données utilisées pour enregistrer les permissions.

Étape 4 : Donner les permissions à votre compte

Lors de la première installation de LuckPerms, aucun joueur ne possède automatiquement les permissions permettant d'utiliser toutes ses commandes. Pour vous donner un accès complet à LuckPerms, ouvrez la console de votre serveur et utilisez la commande suivante :

lp user VOTRE_PSEUDO permission set luckperms.* true

Remplacez VOTRE_PSEUDO par votre nom d'utilisateur Minecraft.

⚠️ Cette permission donne un accès complet aux fonctionnalités de LuckPerms. Elle est destinée à votre compte administrateur et ne doit pas être attribuée à des joueurs classiques.

Étape 5 : Créer votre premier groupe

Les groupes permettent de regrouper plusieurs permissions afin de les attribuer facilement à plusieurs joueurs.
Par exemple, nous allons créer un groupe nommé moderateur :

/lp creategroup moderateur

Vous pouvez vérifier les groupes existants avec :

/lp listgroups

LuckPerms possède également un groupe default, utilisé comme groupe de base pour les joueurs qui n'ont pas de groupe spécifique.

Étape 6 : Ajouter une permission à un groupe

Une fois votre groupe créé, vous pouvez lui attribuer des permissions.
Par exemple, pour autoriser le groupe moderateur à utiliser la commande /ban, vous pouvez utiliser :

/lp group moderateur permission set minecraft.command.ban true

La permission utilisée dépend du plugin ou de la fonctionnalité concernée. Les permissions des plugins sont généralement indiquées dans leur documentation.

Vous pouvez également utiliser le mode verbose de LuckPerms afin d'identifier les permissions demandées lorsqu'un joueur utilise une commande ou une fonctionnalité.

Étape 7 : Ajouter un joueur à un groupe

Pour ajouter un joueur à votre groupe moderateur, utilisez la commande :

/lp user PSEUDO parent add moderateur

Remplacez PSEUDO par le nom du joueur concerné.
Le joueur héritera alors des permissions attribuées au groupe moderateur.

Étape 8 : Créer une hiérarchie de groupes

LuckPerms permet de faire hériter un groupe des permissions d'un autre groupe. Cela est particulièrement pratique pour créer un système de grades.

Imaginons que votre serveur possède trois groupes :

• default : joueurs classiques ;
• moderateur : membres de l'équipe de modération ;
• admin : administrateurs du serveur.

Vous pouvez faire en sorte que moderateur hérite des permissions de default :

/lp group moderateur parent add default

Puis faire hériter admin des permissions de moderateur :

/lp group admin parent add moderateur

Grâce à ce système, un administrateur héritera également des permissions du groupe moderateur, qui lui-même hérite des permissions de default.

Étape 9 : Utiliser l'éditeur web de LuckPerms

Si vous ne souhaitez pas gérer toutes vos permissions avec des commandes, LuckPerms propose également un éditeur web.
Depuis votre serveur, exécutez :

/lp editor

LuckPerms générera alors un lien permettant d'ouvrir son éditeur web. Vous pourrez y créer et modifier vos groupes, permissions et héritages depuis une interface graphique.

Une fois vos modifications terminées, l'éditeur vous indiquera la commande à exécuter sur votre serveur afin d'appliquer les changements.

Étape 10 : Configurer le stockage

LuckPerms utilise par défaut une base de données locale H2 pour stocker les données relatives aux permissions. Cette configuration convient parfaitement à un serveur unique et ne nécessite aucune configuration supplémentaire.

Pour un réseau composé de plusieurs serveurs Minecraft, il est cependant nécessaire d'utiliser une base de données distante comme MySQL, MariaDB, PostgreSQL ou MongoDB afin que les différentes instances de LuckPerms puissent partager les mêmes données.

💡 Si vous utilisez uniquement un serveur Minecraft, nous vous recommandons de conserver la configuration de stockage par défaut. Une base de données distante n'est généralement nécessaire que pour les réseaux de plusieurs serveurs.

Dépannage

Si LuckPerms ne fonctionne pas correctement, vérifiez les points suivants :

• La version de LuckPerms correspond à votre version de Minecraft ;
• Vous avez téléchargé la version correspondant à votre logiciel serveur ;
• Le fichier .jar se trouve bien dans le dossier plugins ;
• Le serveur a été complètement redémarré après l'installation ;
• Aucun autre plugin de gestion des permissions n'est installé en parallèle ;
• LuckPerms apparaît correctement dans la console du serveur ;
• Les permissions utilisées correspondent bien au plugin concerné.

Si une permission ne semble pas fonctionner, vous pouvez utiliser la commande /lp verbose afin d'observer les vérifications de permissions effectuées par LuckPerms et identifier la permission recherchée.

Pourquoi utiliser LuckPerms ?

LuckPerms est une solution complète pour gérer les permissions d'un serveur Minecraft. Il permet de créer facilement des grades, d'organiser une équipe de modération et de contrôler précisément les fonctionnalités accessibles à chaque joueur.

Son système d'héritage permet également de construire une hiérarchie complète sans devoir attribuer les mêmes permissions individuellement à chaque joueur. L'éditeur web constitue enfin une solution pratique pour gérer les configurations plus complexes.

Besoin d'aide ?

Ce guide a été réalisé sur un serveur Minecraft Hosterfy. Vous souhaitez créer votre propre serveur Minecraft et mettre en place un système de permissions pour votre communauté ? Découvrez nos offres d'hébergement Minecraft.

Si vous rencontrez des difficultés lors de l'installation ou de la configuration de LuckPerms, notre équipe reste disponible pour vous accompagner dans la configuration de votre serveur ! 🛠️