FR

Serveurs de jeux

Comment installer et configurer EssentialsX

Installez EssentialsX sur votre serveur Minecraft Paper : homes, warps, téléportation, kits, économie et chat, avec les permissions LuckPerms adaptées.

7 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

EssentialsX ajoute à votre serveur les commandes que les joueurs attendent : /home, /spawn, /tpa, /warp, /msg, des kits et une économie. Ce guide vous explique comment l'installer sur Paper, donner les bonnes permissions et régler les options les plus utiles.

Prérequis

Dans ce guide, Steve est un exemple : remplacez-le par un vrai pseudo.

Choisir la bonne version

La version à installer dépend de votre version de Minecraft. Contrôlez-la avec sudo mc-console version.

Minecraft EssentialsX à installer
26.2 ou 26.3 Build de développement 2.22.1
26.1.2 ou 1.21.11 Version stable 2.22.0

Choisir les modules

EssentialsX est découpé en plusieurs fichiers, et seul le premier est obligatoire.

Module Rôle Dans ce guide
EssentialsX Commandes principales, kits, économie Obligatoire
EssentialsX Spawn Point d'apparition, /spawn, /setspawn Installé
EssentialsX Chat Format du chat, préfixes et suffixes Installé
EssentialsX AntiBuild Autoriser ou non la construction par permission Facultatif
EssentialsX Protect Réglages du monde : dégâts des creepers, propagation du feu Facultatif
EssentialsX GeoIP Localisation approximative des joueurs Facultatif
EssentialsX Discord et Discord Link Passerelle et liaison avec Discord Facultatif
EssentialsX XMPP Passerelle XMPP, module historique Facultatif

Installer Vault et EssentialsX

Vault permet à EssentialsX de lire les groupes et préfixes de LuckPerms. Sans lui, les préfixes et les fonctions liées aux groupes ne marchent pas.

Téléchargez Vault, puis les trois modules du build de développement, adapté à Minecraft 26.3 :

Terminal
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
curl -fL -o Vault.jar https://github.com/MilkBowl/Vault/releases/latest/download/Vault.jar
BASE="https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild"
for MODULE in EssentialsX EssentialsXSpawn EssentialsXChat; do
    FICHIER=$(curl -fsSL "$BASE/api/json?tree=artifacts%5BfileName%5D" | jq -r --arg m "$MODULE" '.artifacts[].fileName | select(startswith($m + "-"))')
    curl -fL -o "$FICHIER" "$BASE/artifact/jars/$FICHIER"
done
ls -l Vault.jar EssentialsX*.jar
exit

Pour Minecraft 26.1.2 ou 1.21.11, utilisez plutôt la version stable, à la place de la boucle ci-dessus :

Terminal
BASE="https://github.com/EssentialsX/Essentials/releases/download/2.22.0"
for MODULE in EssentialsX EssentialsXSpawn EssentialsXChat; do
    curl -fLO "$BASE/$MODULE-2.22.0.jar"
done

Redémarrez le serveur et attendez la ligne Done :

Terminal
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Vérifier l'installation

Quittez le suivi avec Ctrl+C, puis lancez :

Terminal
sudo mc-console plugins
sudo mc-console vault-info
sudo mc-console 'essentials version'

Vous devez retrouver :

  • Essentials, EssentialsChat, EssentialsSpawn, LuckPerms et Vault dans la liste des plugins
  • Permission: LuckPerms et Chat: LuckPerms dans la réponse de vault-info
  • Economy: Essentials Economy dans cette même réponse
  • la même version pour tous les modules dans essentials version

Les fichiers de configuration se trouvent dans /opt/minecraft/server/plugins/Essentials.

Donner les permissions aux joueurs

Les opérateurs ont accès à tout. Les autres joueurs n'ont accès à aucune commande EssentialsX tant que vous ne leur donnez pas la permission correspondante.

Donnez les commandes courantes à tous les joueurs :

Terminal
for PERM in spawn home sethome delhome tpa tpaccept tpdeny back warp warp.list msg afk list motd rules help balance pay kit kits.tools; do
    sudo mc-console "lp group default permission set essentials.$PERM true"
done

Complétez ensuite les grades supérieurs :

Terminal
for PERM in sethome.multiple sethome.multiple.vip fly; do
    sudo mc-console "lp group vip permission set essentials.$PERM true"
done
for PERM in tp tphere kick mute tempban; do
    sudo mc-console "lp group moderator permission set essentials.$PERM true"
done
for PERM in setspawn setwarp delwarp eco createkit; do
    sudo mc-console "lp group admin permission set essentials.$PERM true"
done
Commande Effet Permission
/spawn Retourner au point d'apparition essentials.spawn
/sethome [nom] et /home [nom] Créer un home et s'y rendre essentials.sethome, essentials.home
/delhome <nom> Supprimer un home essentials.delhome
/tpa <joueur> Demander à se téléporter vers un joueur essentials.tpa
/tpaccept et /tpdeny Accepter ou refuser une demande essentials.tpaccept, essentials.tpdeny
/back Revenir à la position précédente essentials.back
/warp [nom] Lister les warps ou s'y rendre essentials.warp, essentials.warp.list
/msg <joueur> <message> et /r <message> Message privé et réponse essentials.msg
/balance et /pay <joueur> <montant> Solde et paiement essentials.balance, essentials.pay
/kit [nom] Lister les kits ou en recevoir un essentials.kit, essentials.kits.<nom>

La liste complète des permissions se trouve sur le site du projet.

Régler la configuration

Ouvrez le fichier avec l'utilisateur minecraft :

Terminal
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/config.yml

Dans nano, Ctrl+W permet de chercher une option. Modifiez les lignes existantes au lieu d'en ajouter de nouvelles, et n'utilisez que des espaces pour l'indentation.

YAML
# Langue des messages (cette ligne est commentée par défaut)
locale: fr

# Attente entre deux téléportations, en secondes
teleport-cooldown: 30

# Délai avant la téléportation, annulé si le joueur bouge ou est attaqué
teleport-delay: 3

# Solde de départ et monnaie
starting-balance: 100
currency-symbol: '€'
currency-symbol-suffix: true

Le nombre de homes se règle par rang. Un joueur sans essentials.sethome.multiple ne peut en avoir qu'un seul. Avec cette permission, il reçoit la valeur default, et essentials.sethome.multiple.vip lui donne la valeur vip :

YAML
sethome-multiple:
  default: 3
  vip: 5
  staff: 10

Appliquez vos changements sans redémarrer :

Terminal
sudo mc-console 'essentials reload'

Définir le point d'apparition et les warps

Ces commandes se tapent en jeu, à l'endroit voulu, avec un compte opérateur ou membre du groupe admin :

Texte
/setspawn
/setspawn newbies
/setwarp boutique

/setspawn définit le point d'apparition général. /setspawn newbies définit celui des nouveaux joueurs, utilisé grâce à l'option newbies de config.yml :

YAML
newbies:
  announce-format: '&dBienvenue à {DISPLAYNAME}&d sur le serveur !'
  spawnpoint: newbies
  kit: tools

Le kit indiqué est donné à la première connexion, sans vérifier les permissions. Mettez kit: '' pour le désactiver.

Créer un kit

Les kits se trouvent dans plugins/Essentials/kits.yml :

Terminal
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/kits.yml

Ajoutez votre kit dans la section kits:. delay est le temps d'attente en secondes entre deux utilisations, et -1 le rend utilisable une seule fois :

YAML
kits:
  depart:
    delay: 86400
    items:
      - stonesword 1
      - stonepickaxe 1
      - bread 16

Rechargez la configuration et autorisez le kit :

Terminal
sudo mc-console 'essentials reload'
sudo mc-console 'lp group default permission set essentials.kits.depart true'

Afficher les grades dans le chat

Avec EssentialsX Chat, Vault et LuckPerms, le format du chat se règle dans la section chat de config.yml :

YAML
chat:
  radius: 0
  format: '{DISPLAYNAME}&7:&r {MESSAGE}'

{DISPLAYNAME} contient déjà le préfixe et le suffixe de LuckPerms. N'ajoutez donc pas {PREFIX} à côté, sinon le préfixe apparaîtra deux fois. radius: 0 envoie les messages à tout le serveur.

Appliquez avec sudo mc-console 'essentials reload', puis écrivez un message en jeu : le préfixe défini dans LuckPerms doit s'afficher.

Gérer l'économie

Depuis la console, vous pouvez modifier le solde d'un joueur qui s'est déjà connecté :

Terminal
sudo mc-console 'eco give Steve 100'
sudo mc-console 'eco take Steve 25'
sudo mc-console 'balance Steve'

Grâce à Vault, les autres plugins compatibles peuvent utiliser cette économie.

Vérifier le résultat

Connectez-vous avec un compte non opérateur membre du groupe default, puis essayez :

Texte
/sethome maison
/home maison
/spawn
/kit tools
/balance

Chaque commande doit fonctionner sans le message You do not have access to that command. Si vous avez activé locale: fr, les réponses s'affichent en français.

Sauvegarder et mettre à jour

Le dossier plugins/Essentials contient la configuration, les données des joueurs et les warps :

Terminal
sudo tar -czf /opt/minecraft/backups/essentials-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server/plugins Essentials

Mettez toujours à jour tous les modules en même temps, car ils doivent avoir la même version. Pour un build de développement :

Terminal
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
BASE="https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild"
for MODULE in EssentialsX EssentialsXSpawn EssentialsXChat; do
    FICHIER=$(curl -fsSL "$BASE/api/json?tree=artifacts%5BfileName%5D" | jq -r --arg m "$MODULE" '.artifacts[].fileName | select(startswith($m + "-"))')
    curl -fL -o "$FICHIER" "$BASE/artifact/jars/$FICHIER"
done
exit
sudo systemctl restart minecraft.service

En cas de problème

« You are running an unsupported server version! »

Cette version d'EssentialsX ne prend pas en charge votre version de Minecraft. Installez le build indiqué dans le tableau du début de ce guide.

« Version mismatch! Please update all Essentials jars to the same version »

Les modules n'ont pas tous la même version. Remplacez-les ensemble, puis redémarrez le serveur. Vérifiez qu'il ne reste pas deux fichiers pour un même module avec ls /opt/minecraft/server/plugins.

« You do not have access to that command »

Le joueur n'a pas la permission. Vérifiez-la, par exemple pour /home :

Terminal
sudo mc-console 'lp user Steve permission check essentials.home'

/r utilise la permission essentials.msg, et /spawn nécessite le module EssentialsX Spawn.

« You cannot set more than 1 homes »

Le joueur a atteint sa limite. Donnez-lui essentials.sethome.multiple et, si besoin, un rang comme essentials.sethome.multiple.vip.

« Detected supported permissions plugin LuckPerms without Vault installed »

Vault est absent ou ne s'est pas chargé. Vérifiez qu'il figure dans sudo mc-console plugins, puis contrôlez le résultat de sudo mc-console vault-info.

« The file is broken and Essentials can't open it »

Un fichier YAML contient une erreur, souvent une tabulation ou une indentation incorrecte. Le journal indique le fichier concerné. Corrigez-le ou restaurez votre sauvegarde, puis redémarrez le serveur.

Une commande d'un autre plugin est remplacée

Si deux plugins proposent la même commande, utilisez la forme complète, par exemple /essentials:home. Pour laisser définitivement la priorité à l'autre plugin, ajoutez la commande dans disabled-commands dans config.yml.

Pour aller plus loin, consultez le wiki officiel d'EssentialsX.