Comment utiliser le plugin EssentialsX sur votre serveur Minecraft ?

Bonjour ! Dans ce guide pratique, nous allons découvrir EssentialsX, un plugin « tout-en-un » incontournable pour votre serveur Minecraft.

EssentialsX est la continuation moderne du célèbre plugin Essentials, maintenue pour les versions récentes de Minecraft. Il regroupe plus de 130 commandes et fonctionnalités utiles pour l'administration et le gameplay de votre serveur. C'est un plugin multifonctions, à la fois simple d'utilisation, personnalisable et traduit en plusieurs langues (y compris le français). En d'autres termes, EssentialsX vous offre presque tout ce dont vous avez besoin : outils de modération, systèmes de téléportation (spawn, homes, warps, etc.), gestion d'économie, kits d'objets, commandes utilitaires, chat amélioré, et bien plus encore.

EssentialsX est compatible avec toutes les versions de Minecraft de 1.8 jusqu'aux plus récentes (il supporte par exemple Minecraft 1.20/1.21 au moment de l'écriture). La plupart des commandes restent identiques quelle que soit la version du jeu. Néanmoins, certaines fonctionnalités ont évolué au fil des versions : par exemple, depuis Minecraft 1.13, les identifiants numériques d'objets ne sont plus utilisés et ont été remplacés par les noms d'objets (ce qui impacte notamment la configuration de certaines commandes comme les restrictions d'items dans EssentialsX AntiBuild). En pratique, cela signifie qu'un même guide EssentialsX reste valable sur les anciennes versions (jusqu'à 1.8) à quelques détails près, que nous signalerons le cas échéant.

Installation du plugin EssentialsX

Avant tout, assurez-vous que votre serveur tourne sous une version compatible avec les plugins Bukkit/Spigot/Paper (les serveurs Vanilla de base n'acceptent pas les plugins). Sur MineStrator, nous vous conseillons d'utiliser PaperMC pour de meilleures performances. L'installation d'EssentialsX se fait ensuite comme pour n'importe quel plugin. Vous pouvez pour cela suivre notre tutoriel : https://minestrator.com/blog/article/ajouter-plugins-serveur-minecraft

Après installation, EssentialsX est opérationnel avec sa configuration par défaut. Pour la plupart des serveurs, les réglages par défaut conviennent très bien. Vous pourrez bien sûr personnaliser la configuration plus tard selon vos besoins (toutes les options se trouvent dans le fichier config.yml du dossier Essentials et sont documentées dans les commentaires). Par exemple, sachez que le plugin est paramétré en anglais par défaut, mais il est possible d'activer la langue française pour tous les messages. Pour ce faire, il suffit d'éditer le config.yml et de définir le code de langue sur “fr” (à la ligne locale:), une fois cette modification enregistrée et la commande /essentials reload exécutée, l'intégralité des messages du plugin passera en français.

💡 Conseil : Pensez à toujours redémarrer ou utiliser la commande /essentials reload après une modification de la configuration pour appliquer les changements. De plus, gardez à l'esprit qu'une mauvaise modification dans le fichier YAML de config (mauvais formatage, suppression accidentelle d'un caractère spécial comme #, etc.) peut empêcher le plugin de fonctionner. Faites des sauvegardes et utilisez un éditeur adapté comme Notepad++ / VisualStudioCode.

Principales fonctionnalités d'EssentialsX

EssentialsX ajoute une multitude de fonctionnalités qui enrichissent votre serveur. En voici les principales catégories :

Outils de modération : EssentialsX offre des commandes pour modérer efficacement votre serveur. Vous pouvez par exemple expulser un fauteur de trouble (/kick), le bannir définitivement ou temporairement (/ban et /tempban), le rendre muet (/mute), ou même le placer en prison (/jail) pour une durée donnée afin de le sanctionner sans le bannir. Il existe également une commande de grâce /unjail (ou /togglejail) pour libérer un joueur emprisonné. Ces outils de sanction complètent ceux déjà présents dans Minecraft en offrant plus de souplesse (par exemple, le bannissement temporaire n'existe pas nativement dans le jeu).

Téléportations et déplacements : EssentialsX introduit tout un système de téléportation avancée pour vos joueurs. Vous pouvez définir des points de téléportation fixes avec la commande /setwarp (puis /warp pour s'y téléporter), définir le point de spawn du serveur (/setspawn) où les joueurs apparaîtront, et permettre aux joueurs de définir leur propre “home” (maison) avec /sethome puis de s'y téléporter via /home. Il est aussi possible de créer plusieurs homes nommés par joueur (selon les permissions accordées). Par ailleurs, EssentialsX gère les demandes de téléportation entre joueurs : la commande /tpa permet d'envoyer une requête pour se téléporter auprès d'un joueur, que ce dernier peut accepter (/tpaccept) ou refuser (/tpdeny). Un administrateur peut aussi téléporter un joueur vers un autre (/tp ) ou tout le monde vers lui (/tpall). Enfin, la commande /back permet à un joueur de retourner à son dernier point de téléportation ou de mort, ce qui est très utile après un décès pour retrouver l'endroit où il est mort.

Kits d'objets et gestion d'inventaire : EssentialsX permet de définir des kits, c'est-à-dire des ensembles d'objets que les joueurs peuvent obtenir à la demande. Par exemple, vous pouvez créer un kit “débutant” contenant du matériel de base. Utilisez /createkit en jeu (en ayant l'inventaire rempli avec les objets souhaités) pour créer un nouveau kit, qui pourra ensuite être mis à disposition des joueurs (via la commande /kit ). Vous pouvez configurer des délais (cooldown) pour éviter les abus de kits dans le fichier config. Par défaut, EssentialsX inclut un kit appelé “default” ou “starter” que vous pouvez modifier. En complément, des commandes comme /invsee permettent aux administrateurs de consulter l'inventaire d'un joueur à distance, ou même de le modifier (pratique pour retirer des items interdits). On retrouve aussi /enderchest pour ouvrir le coffre de l'Ender d'un joueur, ou /clear pour vider son inventaire.

Économie intégrée : EssentialsX intègre un système d'économie virtuelle. Chaque joueur possède un solde d'argent que l'on peut consulter avec /balance (alias /money). Les joueurs peuvent s'envoyer de l'argent entre eux avec /pay . En tant qu'administrateur, vous pouvez ajuster le solde d'un joueur (/eco give/take/set ). EssentialsX permet également de configurer des coûts en monnaie pour les commandes (par exemple faire payer 100$ virtuels chaque téléportation, etc.), ainsi que de créer des boutiques via des panneaux en jeu. Par exemple, un panneau contenant [Buy] ou [Sell] permet respectivement d'acheter ou de vendre des items contre de l'argent, il faudra préalablement activer les types de panneaux voulus dans le fichier de config (section enabledSigns) si vous souhaitez utiliser cette fonctionnalité. Grâce à l'économie EssentialsX, vous pouvez donc gérer un serveur survival/FFA avec de la monnaie sans installer de plugin économique supplémentaire. (Pour l'interaction avec d'autres plugins de shop, EssentialsX est compatible avec Vault, qui sert de passerelle d'économie universelle.)

Communication et commandes sociales : EssentialsX améliore l'expérience de chat et d'interaction entre joueurs. Il introduit la commande /msg (alias /tell) pour envoyer des messages privés à un autre joueur, ainsi que /reply (alias /r) pour répondre rapidement au dernier message privé reçu. Les administrateurs ont accès à /socialspy qui leur permet de voir les messages privés échangés sur le serveur afin de modérer les discussions si nécessaire. Le plugin permet aussi aux joueurs de changer de pseudo affiché avec /nick (utile pour avoir un pseudo coloré ou un surnom plus lisible en jeu). À noter que cette fonctionnalité de surnom n'affecte pas le nom de connexion du compte, seulement le nom visible en jeu. Enfin, la commande /broadcast est disponible pour envoyer une annonce globale à tous les joueurs avec un formatage spécial qui la distingue dans le chat.

Autres fonctionnalités utilitaires : La liste des ajouts d'EssentialsX est très longue, mais citons encore quelques commandes pratiques. Vous pouvez activer le vol libre pour vous-même ou un joueur avec /fly. La commande /speed permet d'ajuster la vitesse de déplacement ou de vol d'un joueur (par exemple /speed 2 double la vitesse de vol). Avec /heal , un joueur peut être soigné instantanément (vie restaurée à 100%), et /feed permet de rassasier sa barre de faim sans manger. La commande /god active le mode invincible pour ne plus subir de dégâts. Il y a également /time ou /weather pour changer l'heure ou la météo sur le serveur (bien que les commandes Vanilla existent, EssentialsX offre des alias plus simples). Un outil utile pour les administrateurs est /gc (garbage collector) qui affiche des informations de performance du serveur, comme l'utilisation mémoire et les TPS (ticks par seconde). En somme, EssentialsX apporte une panoplie de commandes utilitaires pour à peu près toutes les situations courantes sur un serveur, il porte vraiment bien son nom d'« Essentials ».

Liste complète des commandes : il serait impossible de toutes les détailler ici, mais sachez que la liste exhaustive des commandes et permissions d'EssentialsX est disponible sur le wiki officiel du plugin. Vous pouvez vous y référer pour connaître la syntaxe exacte et les permissions associées à chaque commande. N'hésitez pas à la consulter lorsque vous cherchez une commande spécifique ou un réglage particulier.

Les modules additionnels (add-ons) d'EssentialsX

EssentialsX est composé d'un noyau principal et de plusieurs modules optionnels que l'on peut ajouter en fonction des besoins. Le plugin principal (EssentialsX Core) contient l'essentiel des fonctionnalités (toutes les commandes décrites plus haut, la gestion des kits, l'économie, les téléportations, ainsi que le support des panneaux interactifs). À lui seul, le core suffira pour la majorité des serveurs. Cependant, l'équipe EssentialsX fournit des extensions sous forme de plugins séparés pour des fonctionnalités plus spécifiques. Ces modules additionnels doivent être téléchargés et installés en plus du plugin principal (ils ne fonctionneront pas tout seuls). En voici les principaux :

EssentialsX Chat : module de gestion du chat. Il permet de personnaliser le format des messages du chat (couleurs, ajout de préfixes/suffixes devant les pseudos, format différent selon le groupe de joueur, etc.). Par exemple, vous pouvez faire apparaître le grade ou le faction d'un joueur devant son nom, ou colorer les noms des admins en rouge. Prerequis : pour tirer parti de ces fonctionnalités, il vous faudra installer le plugin Vault (pour gérer les préfixes/suffixes) ainsi qu'un plugin de permissions comme LuckPerms pour la gestion des groupes. EssentialsX Chat ira puiser les prefixes et noms de groupe définis dans votre plugin de permissions et les intègrera au format du chat.

EssentialsX Spawn : ce module sert à contrôler les points d'apparition des joueurs sur votre serveur. Il vous permet de définir le spawn principal (avec /setspawn) où tous les joueurs apparaissent par défaut à la connexion et où ils reviennent à leur mort. Vous pouvez aussi configurer des spawns différents par groupe de joueurs (si vous voulez par exemple que les nouveaux arrivants spawnent dans une zone tutoriel, etc.). Sans ce module, la commande /setspawn n'est pas disponible (et EssentialsX n'altèrera pas le spawn du serveur). Astuce : une fois EssentialsX Spawn installé, pensez à retirer d'éventuels autres plugins gérant le spawn pour éviter les conflits. Les permissions associées (ex: essentials.spawn pour /spawn) peuvent être attribuées aux joueurs selon ce que vous souhaitez autoriser.

EssentialsX Protect : module de protection basique du monde. Il permet d'appliquer certaines règles globales de sécurité sur votre serveur, par exemple empêcher les creepers de détruire des blocs, désactiver la propagation du feu, interdire le spawn de certaines créatures, etc.. Ces paramètres se règlent dans la section “Protect” du fichier de config. Attention : EssentialsX Protect n'est pas un plugin de protection de zones, il n'offre pas le système de régions comme WorldGuard. Ses réglages s'appliquent de manière générale sur tout le serveur (ou par monde). Si vous avez besoin de protéger des zones spécifiques, utilisez un plugin dédié (comme WorldGuard) en complément.

EssentialsX AntiBuild : ce module ajoute des contrôles fins sur le droit de construire ou d'interagir avec le monde. Par défaut, sans ce module, EssentialsX n'empêchera aucun joueur de construire. Avec AntiBuild, vous pouvez définir que certains groupes n'ont pas le droit de placer/casser certains blocs ou d'utiliser certains objets. Par exemple, empêcher les visiteurs de construire, ou interdire l'utilisation de la TNT aux non-ops, etc. AntiBuild fonctionne en conjuguant permissions et configuration : on attribue ou non aux joueurs les permissions essentials.build (ou au contraire essentials.build.exempt) et on peut lister dans le config.yml les ID des blocs interdits si nécessaire. Là encore, ce n'est pas une protection de région, mais bien une restriction globale par type d'action/objet. (Pour une protection de zone, préférez WorldGuard.) Prerequis : AntiBuild nécessite également un plugin de permissions (LuckPerms) pour gérer les autorisations de construction par groupe.

EssentialsX GeoIP : ajout purement informatif, il permet d'afficher le pays (région) d'origine des joueurs qui se connectent en se basant sur leur adresse IP. Par exemple, dans le message de connexion d'un joueur, on pourra voir « X s'est connecté depuis la France ». Les admins peuvent aussi consulter cette info via la commande /whois . Pour des raisons de confidentialité (et légales), assurez-vous d'informer vos joueurs si vous utilisez ce genre de fonctionnalité, même si c'est assez courant sur les serveurs Minecraft. Note : ce module télécharge une base de données GeoIP et la met à jour périodiquement.

EssentialsX Discord : il s'agit d'un pont entre votre serveur Minecraft et un serveur Discord. Ce plugin vous permet de relier un salon Discord avec le chat Minecraft, ainsi, les messages envoyés en jeu peuvent apparaître sur Discord, et vice-versa. Cela facilite la communication communautaire même quand des joueurs ne sont pas en jeu. EssentialsX Discord peut également relayer sur Discord certains événements du serveur (connexions, déconnexions, mort d'un joueur, messages d'annonce...). Il offre même la possibilité d'exécuter des commandes Minecraft depuis Discord (via des commandes slash dédiées côté Discord). Par exemple, un administrateur sur Discord pourrait taper /kick joueur via un bot pour expulser quelqu'un du serveur sans être connecté en jeu. Prerequis : ce module nécessite de créer un bot Discord et de l'inviter sur votre serveur Discord, puis de configurer le lien avec le serveur Minecraft via un token. La documentation d'EssentialsX explique la démarche en détail.

En plus de ceux listés ci-dessus, l'équipe d'EssentialsX développe et améliore régulièrement de nouveaux modules. Par exemple, un module EssentialsX Discord Link a été ajouté récemment pour aller encore plus loin dans l'intégration Discord : il permet de synchroniser les rôles Discord avec les grades/permissions en jeu (et inversement) et de contrôler l'accès au serveur Minecraft en fonction de l'appartenance à un groupe Discord. Ce type d'addon peut s'avérer utile pour des communautés souhaitant réserver le serveur aux membres vérifiés sur Discord, par exemple. À l'inverse, certains anciens modules plus rares existent comme EssentialsX XMPP (passerelle avec des réseaux de chat Jabber/XMPP) mais ceux-ci sont très spécialisés et peu utilisés de nos jours.

Comment installer ces addons ?

Exactement comme le plugin principal : chaque module est un fichier JAR séparé (disponible sur la même page de téléchargement qu'EssentialsX Core) à placer dans votre dossier plugins, puis redémarrez le serveur. Vous ne devez installer que les modules dont vous avez besoin. Par exemple, pour un petit serveur survie entre amis, vous utiliserez surtout EssentialsX Core et éventuellement EssentialsX Spawn et Chat. Inutile de charger Protect ou AntiBuild si vous ne vous en servez pas. À l'inverse, pour un serveur public avec beaucoup de joueurs, ajouter Protect/AntiBuild + Chat + Spawn est recommandé afin de couvrir un maximum de besoins.

Utilisation des commandes et permissions

Avec le plugin principal et les éventuels modules installés, vous disposez d'un ensemble très complet de commandes. Toutefois, par défaut, seul l'opérateur (OP) du serveur a accès à la plupart des commandes.

Les joueurs “normaux” ne pourront utiliser que certaines commandes basiques (comme /help d'Essentials, ou /msg si activé) tant que vous ne leur aurez pas attribué les permissions nécessaires. Pour accorder ou restreindre l'accès aux commandes d'EssentialsX, il est fortement conseillé d'utiliser un plugin de gestion de permissions tel que LuckPerms.

Par exemple, vous pourriez vouloir autoriser tous les joueurs à utiliser les commandes de téléportation comme /tpa et /home sans pour autant leur donner le statut OP (qui donne accès à toutes les commandes).

Avec un plugin de permissions, vous pourrez créer un groupe “Joueurs” et lui assigner les nodes de permission EssentialsX appropriés (par ex. essentials.tpa, essentials.sethome, etc, la liste complète des permissions est disponible sur le wiki EssentialsX). De même, vous pouvez créer un groupe “Modérateur” avec des permissions modérées (essentials.kick, essentials.mute…), un groupe “Administrateur” avec presque tous les droits, etc., selon la hiérarchie de votre serveur. LuckPerms dispose d'une interface web pratique pour éditer les groupes et permissions, n'hésitez pas à consulter notre guide dédié pour son utilisation si nécessaire.

Enfin, n'oubliez pas que EssentialsX dispose d'une documentation très complète (en anglais) sur son site officiel qui couvre les commande, les module et les autres options de configuration. En cas de doute sur le fonctionnement d'une fonctionnalité, consultez le wiki et la FAQ d'EssentialsX.

Si vous avez besoin de plus de détails vous pouvez aussi créer un ticket sur notre panel ou venir sur notre Discord.