EssentialsX Minecraft : installation et config 2026

Le symptôme arrive souvent après le premier redémarrage : /sethome répond, mais vos joueurs lisent "You do not have access to that command." EssentialsX ne donne pas un serveur prêt à jouer par magie. Vous installez le bon fichier, vous ouvrez les bonnes permissions, puis vous fixez les limites avant que 30 joueurs posent 300 homes.

Installer EssentialsX sur un serveur Paper Minecraft

EssentialsX tourne sur Paper, Purpur et Spigot. En 2026, Paper 1.21.8 avec Java 21 reste le choix propre pour un serveur public. Téléchargez EssentialsX depuis la page officielle du projet. Pas depuis un miroir resté bloqué en 2021. Un fichier compilé pour Minecraft 1.16 peut démarrer, puis casser sur une commande de téléportation avec une erreur de type "NoSuchMethodError". Vous perdez une soirée pour un mauvais .jar.

1. Arrêtez le serveur depuis le panel. Ne remplacez pas un plugin pendant que Paper écrit ses fichiers YAML.
2. Envoyez EssentialsX.jar dans le dossier plugins/. Ajoutez EssentialsXSpawn si vous gérez /spawn, EssentialsXChat si vous modifiez le format du chat.
3. Démarrez le serveur et lisez la console pendant 30 secondes. Le chargement correct affiche "EssentialsX version" puis "Enabled Essentials".
4. Connectez-vous en jeu et tapez /ess version. Vous devez voir la version du plugin, la version du serveur et le nombre de modules chargés.

Sur le panel Starmine, l'installation depuis le catalogue évite trois erreurs classiques : l'envoi FTP du mauvais fichier, le dépôt dans le mauvais dossier, puis le redémarrage oublié. Vous gardez la main sur la version installée et sur les fichiers générés après le premier lancement via notre panel.

Si la console affiche "Could not load 'plugins/EssentialsX.jar' in folder 'plugins'", vérifiez d'abord Java. Minecraft 1.21 demande Java 21. Java 17 charge encore certains vieux plugins, mais Paper 1.21 refuse de démarrer correctement dans beaucoup de cas.

Choisir les modules EssentialsX sans tout installer

EssentialsX n'est pas un seul bloc. Le fichier principal ajoute /home, /warp, /msg, /tpaccept, /back, /spawn si le module de spawn est là, et des dizaines de commandes d'administration. Les modules autour répondent à des besoins séparés. Installer les cinq fichiers parce qu'un tutoriel de 2019 le fait alourdit la maintenance. Vous ajoutez des réglages, des permissions et des causes de panne que personne n'utilise.

EssentialsXProtect ne remplace pas un anti-grief. Il bloque des actions. Il ne restaure pas une base rasée. Pour 20 joueurs connectés, Core plus Spawn suffit dans la majorité des survies privées. Ajoutez Chat si vos groupes LuckPerms doivent afficher "[Modo]" ou "[VIP]" devant le pseudo. Ajoutez Protect seulement si vous savez quelle règle vous cherchez, par exemple bloquer la TNT dans le monde world tout en laissant le Nether libre.

Configurer spawn, homes et téléportations dans EssentialsX

Le premier fichier à ouvrir après le démarrage est config.yml, dans le dossier Essentials. Ne collez pas une configuration trouvée au hasard sur un forum. Elle peut contenir 400 lignes pour une version 1.19, alors que votre serveur 1.21.8 génère des clés différentes. Travaillez sur le fichier créé par votre version. Changez peu de valeurs à la fois, puis testez.

Mettez teleport-delay à 3 sur un serveur survie public. Trois secondes empêchent le /home utilisé comme bouton panique pendant un combat. Au-delà de 5 secondes, les joueurs croient souvent que la commande ne marche pas, surtout avec 80 ms de ping et un chat chargé. Gardez teleport-safety sur true. Cette vérification évite une arrivée dans la lave, dans un bloc ou au-dessus du vide. Le coût reste faible : une recherche de position sûre au moment de la téléportation, pas une tâche continue.

Pour le spawn, choisissez une règle et gardez-la. spawn-on-join: false laisse les joueurs à leur dernière position après une coupure. spawn-on-join: true les ramène au hub à chaque connexion. C'est logique pour un lobby, beaucoup moins pour une survie où un joueur mine à 4 000 blocs. Si EssentialsXSpawn est installé, fixez le spawn avec /setspawn depuis le monde voulu. Vérifiez aussi la protection spawn de Minecraft dans server.properties : spawn-protection à 16 bloque la construction dans un carré de 33 par 33 pour les non-op. Beaucoup accusent EssentialsX, alors que Vanilla refuse le clic.

Donner les permissions EssentialsX avec LuckPerms

Être op règle le problème pendant 5 minutes et en crée dix autres. Un opérateur passe les protections, utilise /give, modifie le spawn, ignore certaines limites, et finit dans ops.json avec un niveau 4. Sur un serveur communautaire, donnez des droits par groupe. LuckPerms stocke ces droits proprement et montre les refus sans deviner.

lp group default permission set essentials.spawn true

Cette commande donne /spawn au groupe default. Ajoutez ensuite essentials.home, essentials.sethome, essentials.delhome, essentials.tpa et essentials.tpaccept. Ne donnez pas essentials.* à un grade joueur. Ce joker ouvre aussi des commandes de modération selon les modules chargés. Pour un serveur de 10 à 40 joueurs, partez sur 1 home pour default, 3 homes pour membre validé, 5 à 10 pour donateur si votre modèle l'autorise. À 50 homes par personne, le problème n'est pas le stockage. C'est l'usage : les joueurs remplacent les routes, les portails et les bases secondaires par une liste confuse.

• default : essentials.spawn, essentials.home, essentials.sethome, essentials.tpa. Un joueur rejoint, pose un home, revient au spawn et demande une téléportation.
• membre : essentials.sethome.multiple.3, essentials.warp, essentials.back.ondeath. Le retour après mort reste utile sans transformer /back en outil de fuite.
• moderateur : essentials.tp, essentials.tphere, essentials.mute, essentials.kick. Pas de essentials.gamemode si vous voulez séparer staff et créatif.

Si un joueur lit "You do not have access to that command.", EssentialsX répond déjà. La permission manque. Tapez /lp verbose on, faites rejouer la commande, puis lisez le noeud refusé dans la console.

Régler économie, kits et warps sans casser la survie

L'économie d'EssentialsX paraît légère, mais elle change le rythme du serveur dès le premier jour. Le solde des joueurs, les prix de /sell et les coûts de téléportation entrent vite dans les habitudes. Si vous doublez les gains après deux semaines, les anciens gardent leur avance et les nouveaux arrivent dans une monnaie déjà gonflée.

Les warps servent bien pour spawn, shop, event et nether. Limitez les warps publics à moins de 20. Au-delà, les joueurs ne savent plus si "shop", "shops", "market" et "marche" pointent vers la même zone. Les fichiers de warps sont stockés dans le dossier Essentials, avec une position, un monde, un yaw et un pitch. Une erreur de monde après un reset provoque un warp vers une dimension absente ou vers une coordonnée sans sol.

Gardez les kits faibles : pierre, nourriture, torches. Un kit diamant toutes les 24 heures tue le minage sur une survie de 15 joueurs. Pour un serveur semi-RP, vendez plutôt des services limités, comme un warp ville ou un changement de pseudo coloré avec cooldown.

Dépanner EssentialsX après mise à jour ou erreur console

Une mise à jour Minecraft ne se traite pas comme un redémarrage normal. Passez d'abord Paper, puis EssentialsX, puis les modules. L'ordre inverse produit des erreurs trompeuses : le plugin charge, puis tombe sur une méthode serveur absente. Le message "Unsupported API version" pointe souvent vers un plugin trop vieux pour la version Paper. Le message "Unsupported class file major version 65" pointe vers une version Java trop basse ou un fichier compilé pour Java 21 lancé avec Java 17.

Avant de supprimer un dossier Essentials, sauvegardez-le. En supprimant les userdata, vous perdez les homes, les derniers emplacements connus, les surnoms, les soldes, les temps de mute et certains cooldowns. Un monde intact ne rend pas ces données aux joueurs.

Faites une sauvegarde complète avant chaque changement de version : dossier world, dossier world_nether, dossier world_the_end, dossier plugins, fichier server.properties. Une archive de 6 Go se transfère plus lentement qu'un correctif, mais elle évite la soirée où 25 joueurs cherchent leurs homes disparus. Si vous devez tester, copiez le serveur dans une instance de staging avec le même Java 21 et la même version Paper 1.21.8.

Évitez /reload. Paper l'affiche lui-même : "Please note that this command is not supported and may cause issues." EssentialsX recharge parfois ses fichiers avec /ess reload, mais les hooks avec Vault, LuckPerms et le chat ne repartent pas toujours proprement. Redémarrez le serveur. Trente secondes d'arrêt valent mieux qu'un plugin à moitié accroché pendant deux heures.

Guides

Pourquoi mon /home disparaît après un reset de monde ?

Le home EssentialsX garde un nom de monde et des coordonnées. Si vous supprimez world puis recréez un monde avec un autre nom, l'ancien home pointe vers un monde absent. Restaurez les userdata avec le même nom de monde, ou prévenez les joueurs que les homes liés au reset sont perdus.

Pourquoi les joueurs peuvent utiliser /spawn mais pas /sethome ?

Les deux commandes utilisent deux permissions différentes. /spawn demande essentials.spawn, alors que /sethome demande essentials.sethome, parfois avec une limite comme essentials.sethome.multiple.3. Regardez LuckPerms verbose pour lire le noeud refusé exact.

EssentialsX suffit-il pour protéger une base ?

Non. EssentialsXProtect bloque certaines actions globales, comme la TNT ou le feu selon vos réglages. Il ne gère pas des claims par joueur avec membres, drapeaux et limites de zone. Ajoutez un plugin de protection de terrains si votre serveur accepte des inconnus.

Faut-il redémarrer le serveur après avoir changé config.yml ?

Pour un petit changement EssentialsX, /ess reload recharge une partie de la configuration. Pour une mise à jour de version, un ajout de module ou un changement lié à Vault, LuckPerms ou au chat, redémarrez. Le redémarrage évite les hooks chargés dans le mauvais ordre.