EssentialsX est le plugin du quotidien pour les serveurs Paper et Spigot : homes, warps, un point de spawn, des demandes de téléportation entre joueurs, des kits et un message de bienvenue à la connexion. Presque tous les serveurs de survie l'utilisent, car il regroupe les commandes que les joueurs considèrent comme allant de soi. Ce guide configure les fonctions de base et montre quels droits tu dois attribuer. Les captures d'écran proviennent d'un serveur de test avec Paper 1.21.4 et EssentialsX 2.21.0.

Installation et première connexion

Dans le panel, tu trouves EssentialsX sous Plugins → Browser. Le module principal EssentialsX suffit ; les modules complémentaires comme EssentialsX Chat ou EssentialsX Spawn ne sont à installer que si tu as besoin de leurs fonctions. Après le redémarrage, EssentialsX accueille chaque joueur avec un message de bienvenue, le nombre de joueurs en ligne et le temps de jeu.

Message de bienvenue d'EssentialsX avec mention d'une version plus récente
Message de bienvenue d'EssentialsX avec mention d'une version plus récente

La mention en rouge dans l'image est la vérification de mise à jour intégrée : elle signale aux opérateurs qu'une version plus récente est disponible. La mise à jour se fait via le navigateur de plugins du panel, pas via le lien. Si tu ne veux pas de ce message, mets la valeur update-check: false dans plugins/Essentials/config.yml.

Spawn, homes et warps

Les trois commandes que les joueurs utilisent le plus souvent :

/setspawn
/sethome
/home
/setwarp markt
/warp markt

/setspawn définit le point où apparaissent les nouveaux joueurs et où /spawn les mène. /sethome enregistre la position actuelle comme home du joueur ; /home l'y ramène. Les warps sont des points publics qu'un administrateur crée avec /setwarp et que chacun peut atteindre avec /warp.

Retour au village via /home : le joueur se retrouve devant sa maison
Retour au village via /home : le joueur se retrouve devant sa maison

Tu gères plusieurs homes par joueur via les droits : celui qui possède essentials.sethome.multiple.vip obtient autant de homes que ce qui est indiqué dans config.yml sous sethome-multiple pour vip. Sans ces nœuds, le joueur reste limité à un seul home.

Droits pour le groupe par défaut

Sans plugin de droits, EssentialsX donne la plupart des commandes à tous les joueurs. Dès que LuckPerms tourne, seul ce que tu autorises s'applique. Un ensemble raisonnable pour le groupe default :

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.home true
/lp group default permission set essentials.warp true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.back true

/tpa envoie une demande de téléportation, /tpaccept l'accepte ; /back ramène au point de mort après la mort. Des commandes comme /gamemode, /give, /kick et /ban restent réservées au groupe de modération. Pour savoir comment créer des groupes, consulte LuckPerms : configurer les droits.

Kits et message de bienvenue

Un kit de départ donne des outils aux nouveaux joueurs. Les kits se trouvent dans plugins/Essentials/config.yml sous kits ; une entrée indique les objets et un délai en secondes. La commande /kit starter nécessite le droit essentials.kits.starter. Le message de bienvenue et le message du jour se trouvent dans le même fichier sous newbies et motd ; tu définis les couleurs avec des codes &. Après des modifications de la configuration, /essentials reload les charge sans redémarrage.

Où se trouvent les données des joueurs

EssentialsX ne stocke rien dans le dossier du monde, mais dans son propre répertoire de plugin. C'est important à savoir si tu remplaces un monde ou déménages vers un autre serveur :

  • plugins/Essentials/userdata/ — un fichier par joueur avec les homes, la dernière position, le temps de jeu et les surnoms, nommé selon son UUID.
  • plugins/Essentials/warps/ — un fichier propre par warp.
  • plugins/Essentials/config.yml — kits, message de bienvenue, délai de téléportation et tous les autres paramètres.

Un nouveau monde laisse donc homes et warps intacts — mais leurs coordonnées pointent ensuite dans le vide et doivent être redéfinies. Lors d'un déménagement de serveur, tu emportes tout le dossier plugins/Essentials/, ainsi homes et warps sont conservés.

Erreurs courantes

  • /home sans effet. Le joueur n'a pas défini de home ou le droit essentials.home manque.
  • La téléportation s'interrompt. Le paramètre teleport-delay attend quelques secondes et s'interrompt en cas de mouvement. Réduis la valeur dans config.yml ou attribue le droit essentials.teleport.timer.bypass.
  • Warps disparus. Les warps sont stockés sous forme de fichiers dans plugins/Essentials/warps/. La sauvegarde du panel les inclut ; un nouveau dossier de monde n'y change rien.
  • Commandes en double. D'autres plugins fournissent leurs propres commandes /spawn ou /home. Dans config.yml sous overridden-commands, tu définis quel plugin l'emporte.

FAQ

Ai-je besoin de tous les modules EssentialsX ?

Non. Le module principal EssentialsX apporte homes, warps, téléportation et kits. Les modules complémentaires ne sont à installer que pour leur fonction précise : EssentialsX Chat pour les préfixes dans le chat, EssentialsX Spawn pour des règles de spawn distinctes lors de la première connexion et à la mort.

Pourquoi les commandes ne fonctionnent-elles plus après l'installation de LuckPerms ?

Sans plugin de droits, EssentialsX laisse la plupart des commandes libres d'accès. Dès que LuckPerms tourne, seul ce qui est explicitement autorisé s'applique. Configure une bonne fois pour toutes les nœuds pour le groupe default — le comportement devient alors prévisible et c'est toi qui décides qui peut utiliser /tpa ou /back.

Comment un joueur obtient-il plusieurs homes ?

Par deux éléments liés : dans config.yml, tu définis sous sethome-multiple combien de homes un niveau autorise, et dans LuckPerms tu attribues le nœud correspondant, par exemple essentials.sethome.multiple.vip. Sans ce nœud, le joueur reste limité à un home.

Dois-je redémarrer après une modification du config.yml ?

Pour la plupart des valeurs, /essentials reload suffit, par exemple pour les kits, le message de bienvenue ou le délai de téléportation. Un module complémentaire nouvellement installé et des modifications concernant d'autres plugins nécessitent un redémarrage complet du serveur.

Les homes et warps sont-ils inclus dans la sauvegarde du panel ?

Oui, la sauvegarde protège l'intégralité du répertoire du serveur, donc aussi plugins/Essentials/. Un remplacement du monde ne supprime pas les homes et warps — mais leurs coordonnées ne correspondent plus au terrain et doivent être redéfinies.

Guides complémentaires

Les zones que les joueurs ne doivent pas modifier sont protégées par WorldGuard : protéger des régions. Si le serveur rame malgré peu de joueurs, spark : analyser le lag peut t'aider.

Sources

EssentialsX: Voir l'exemple

Captures réalisées dans un environnement de démonstration. La version et la configuration présentées peuvent différer de celles de ton serveur.

Le point de home atelier a été enregistré.
Le point de home atelier a été enregistré.

2.21.0