Retour au blog

EssentialsX : Guide complet installation et config

Apprenez à installer et configurer EssentialsX sur votre serveur Minecraft. Guide complet : commandes, économie, kits, permissions et configuration avancée.

EssentialsX : Guide complet installation et config

Introduction

EssentialsX est le plugin le plus populaire et le plus complet pour les serveurs Minecraft. Fork moderne du légendaire Essentials, il offre plus de 130 commandes et des fonctionnalités essentielles pour tout administrateur de serveur.

Pourquoi choisir EssentialsX ?

  • +130 commandes — Téléportation, économie, kits, warps, homes...
  • Gratuit et open-source — Maintenu activement par la communauté
  • Modulaire — Installez uniquement ce dont vous avez besoin
  • Compatible — Fonctionne avec Spigot, Paper, Purpur (1.8 à 1.21+)
  • Personnalisable — Configuration détaillée de chaque fonctionnalité
  • Traduit — Support multilingue dont le français

Installation

Prérequis

Élément Version Minimum
Minecraft 1.8.8+ (recommandé 1.20+)
Serveur Spigot, Paper, Purpur
Java 17+ (pour MC 1.20+)
Vault Recommandé pour l'économie

Étape 1 : Téléchargement

Téléchargez EssentialsX depuis les sources officielles uniquement :

⚠️ Attention : Ne téléchargez jamais depuis des sites non officiels. Risque de malware !

Étape 2 : Installation

1. Arrêtez votre serveur
2. Placez EssentialsX-X.X.X.jar dans le dossier /plugins/
3. (Optionnel) Ajoutez les modules souhaités
4. Démarrez le serveur
5. EssentialsX génère automatiquement ses fichiers de configuration

Étape 3 : Vérification

/plugins

EssentialsX doit apparaître en vert. Vous pouvez aussi tester :

/essentials

Modules EssentialsX

EssentialsX est modulaire. Installez uniquement ce dont vous avez besoin :

Modules Disponibles

Module Description Indispensable ?
EssentialsX Plugin principal (commandes de base) ✅ Oui
EssentialsX Chat Formatage du chat, préfixes, couleurs ✅ Recommandé
EssentialsX Spawn Gestion du spawn, respawn, newbie spawn ✅ Recommandé
EssentialsX AntiBuild Restrictions de construction par permission Optionnel
EssentialsX Discord Liaison Discord ↔ Minecraft Optionnel
EssentialsX GeoIP Localisation géographique des joueurs Optionnel
EssentialsX Protect Protection basique du monde Optionnel
EssentialsX XMPP Support Jabber/XMPP Rare

Installation Recommandée (Serveur Survie)

plugins/
├── EssentialsX-2.XX.X.jar          # Principal
├── EssentialsXChat-2.XX.X.jar      # Chat
├── EssentialsXSpawn-2.XX.X.jar     # Spawn
└── Vault-X.X.X.jar                  # Économie (dépendance)

Dépendances Optionnelles

Plugin Utilité avec EssentialsX
Vault Connexion avec l'économie et les permissions
LuckPerms Gestion avancée des permissions
PlaceholderAPI Variables dans le chat et les messages

Configuration de Base

Après le premier démarrage, EssentialsX génère ses fichiers dans /plugins/Essentials/.

Structure des Fichiers

plugins/Essentials/
├── config.yml           # Configuration principale
├── messages.properties  # Messages personnalisables
├── items.json          # Alias des items
├── kits.yml            # Configuration des kits
├── spawn.yml           # Coordonnées du spawn
├── warps/              # Fichiers des warps
└── userdata/           # Données des joueurs

Configuration Essentielle (config.yml)

Ouvrez config.yml et modifiez ces paramètres clés :

Langue du Plugin

# Changez la langue (fr pour français)
locale: fr

Pseudo et Surnom

# Autoriser les surnoms colorés
change-displayname: true


Format du pseudo (avec surnom)


nickname-prefix: '~'


Longueur max du surnom


max-nick-length: 15


Autoriser les couleurs dans les surnoms


nick-color: true

Messages de Connexion/Déconnexion

# Désactiver les messages par défaut (si vous utilisez un autre plugin)
custom-join-message: "none"
custom-quit-message: "none"


Ou personnaliser


custom-join-message: "&8[&a+&8] &7{DISPLAYNAME}"
custom-quit-message: "&8[&c-&8] &7{DISPLAYNAME}"

Téléportation

# Délai avant téléportation (en secondes)
teleport-delay: 3


Annuler si le joueur bouge


teleport-cancel-on-move: true


Cooldown entre téléportations


teleport-cooldown: 30


Téléportation gratuite pour l'OP


teleport-cost: 0

Commandes Essentielles

Commandes Joueurs

Commande Description Permission
/spawn Retourner au spawn essentials.spawn
/home Aller à sa maison essentials.home
/sethome [nom] Définir une maison essentials.sethome
/delhome [nom] Supprimer une maison essentials.delhome
/tpa <joueur> Demander une téléportation essentials.tpa
/tpaccept Accepter une demande essentials.tpaccept
/tpdeny Refuser une demande essentials.tpdeny
/back Retourner à sa position précédente essentials.back
/warp <nom> Aller à un warp essentials.warp
/warps Liste des warps essentials.warp.list
/bal Voir son solde essentials.balance
/pay <joueur> <montant> Envoyer de l'argent essentials.pay
/kit <nom> Recevoir un kit essentials.kit
/kits Liste des kits essentials.kit.list
/msg <joueur> <message> Message privé essentials.msg
/r <message> Répondre au dernier MP essentials.msg
/afk Se mettre AFK essentials.afk
/nick <pseudo> Changer son surnom essentials.nick
/seen <joueur> Dernière connexion d'un joueur essentials.seen
/mail send <joueur> <msg> Envoyer un mail essentials.mail.send
/mail read Lire ses mails essentials.mail
/helpop <message> Demander de l'aide au staff essentials.helpop

Commandes Modération

Commande Description Permission
/tp <joueur> Se téléporter à un joueur essentials.tp
/tphere <joueur> Téléporter un joueur à soi essentials.tphere
/tppos <x> <y> <z> Téléportation aux coordonnées essentials.tppos
/tpall Téléporter tout le monde à soi essentials.tpall
/kick <joueur> [raison] Expulser un joueur essentials.kick
/ban <joueur> [raison] Bannir un joueur essentials.ban
/tempban <joueur> <durée> Bannir temporairement essentials.tempban
/unban <joueur> Débannir un joueur essentials.unban
/mute <joueur> [durée] Rendre muet essentials.mute
/unmute <joueur> Rendre la parole essentials.unmute
/jail <joueur> <prison> Emprisonner essentials.jail
/unjail <joueur> Libérer essentials.unjail
/vanish Devenir invisible essentials.vanish
/invsee <joueur> Voir l'inventaire essentials.invsee
/socialspy Espionner les MP essentials.socialspy
/broadcast <message> Message global essentials.broadcast

Commandes Administration

Commande Description Permission
/setspawn Définir le spawn essentials.setspawn
/setwarp <nom> Créer un warp essentials.setwarp
/delwarp <nom> Supprimer un warp essentials.delwarp
/createkit <nom> <délai> Créer un kit depuis l'inventaire essentials.createkit
/eco give <joueur> <montant> Donner de l'argent essentials.eco.give
/eco take <joueur> <montant> Retirer de l'argent essentials.eco.take
/eco set <joueur> <montant> Définir le solde essentials.eco.set
/god [joueur] Mode invincible essentials.god
/fly [joueur] Mode vol essentials.fly
/speed <1-10> Vitesse de déplacement essentials.speed
/heal [joueur] Soigner essentials.heal
/feed [joueur] Nourrir essentials.feed
/gamemode <mode> Changer le mode de jeu essentials.gamemode
/time <day/night> Changer l'heure essentials.time
/weather <sun/rain> Changer la météo essentials.weather
/essentials reload Recharger la config essentials.reload

Système d'Économie

EssentialsX inclut un système d'économie complet.

Configuration de l'Économie

Dans config.yml :

# Symbole de la monnaie
currency-symbol: '€'


Nom de la monnaie (singulier/pluriel)


currency-singular: 'euro'
currency-plural: 'euros'


Argent de départ


starting-balance: 1000


Solde maximum (0 = illimité)


max-money: 10000000000000


Solde minimum (peut être négatif pour autoriser les dettes)


min-money: -10000


Format d'affichage


economy-log-enabled: false

Commandes Économie

# Joueurs
/bal                    # Voir son solde
/baltop                 # Classement des plus riches
/pay <joueur> <montant> # Envoyer de l'argent


Administration


/eco give <joueur> 1000  # Donner 1000€
/eco take <joueur> 500   # Retirer 500€
/eco set <joueur> 5000   # Définir le solde à 5000€
/eco reset <joueur>      # Remettre au solde de départ

Intégration avec Vault

Pour connecter l'économie à d'autres plugins (shops, jobs...) :

  1. Installez Vault : Télécharger Vault
  2. Placez-le dans /plugins/
  3. Redémarrez le serveur
  4. L'économie EssentialsX est automatiquement détectée

Kits et Warps

Créer un Kit

Méthode 1 : Via le jeu (Recommandée)

# Mettez les items voulus dans votre inventaire
# Puis créez le kit avec le délai en secondes
/createkit starter 86400

Méthode 2 : Fichier kits.yml

kits:
  starter:
    delay: 86400  # 24 heures en secondes
    items:
      - stone_sword 1
      - leather_helmet 1
      - leather_chestplate 1
      - leather_leggings 1
      - leather_boots 1
      - cooked_beef 16
      - torch 32
      

  vip:
    delay: 43200  # 12 heures
    items:
      - diamond_sword 1 sharpness:2
      - diamond_pickaxe 1 efficiency:3
      - golden_apple 5
      - ender_pearl 8


  weekly:
    delay: 604800  # 7 jours
    items:
      - diamond 16
      - emerald 32
      - netherite_ingot 2

Enchantements dans les Kits

Format : item quantité enchantement:niveau

items:
  - diamond_sword 1 sharpness:5 unbreaking:3 fire_aspect:2
  - diamond_pickaxe 1 efficiency:5 fortune:3 unbreaking:3
  - elytra 1 unbreaking:3 mending:1

Permissions des Kits

# Permission pour utiliser le kit "starter"
essentials.kit.starter


Permission pour utiliser tous les kits


essentials.kit.*

Créer des Warps

# Se placer à l'endroit souhaité
/setwarp shop        # Crée le warp "shop"
/setwarp arena       # Crée le warp "arena"
/setwarp spawn       # Crée le warp "spawn"


Supprimer un warp


/delwarp shop


Lister les warps


/warps

Permissions des Warps

# Accès à un warp spécifique
essentials.warps.shop


Accès à tous les warps


essentials.warps.*

Homes et Téléportation

Configuration des Homes

Dans config.yml :

# Nombre de homes par défaut
default-home-limit: 1


Homes par groupe (avec LuckPerms)


Définissez via les permissions : essentials.sethome.multiple.<nombre>

Permissions Multi-Homes

Permission Effet
essentials.sethome.multiple.2 2 homes
essentials.sethome.multiple.5 5 homes
essentials.sethome.multiple.unlimited Homes illimités

Exemple avec LuckPerms

# Joueurs normaux : 2 homes
/lp group default permission set essentials.sethome.multiple.2


VIP : 5 homes


/lp group vip permission set essentials.sethome.multiple.5


Staff : illimité


/lp group staff permission set essentials.sethome.multiple.unlimited

Configuration Téléportation

# Délai avant téléportation (en secondes)
teleport-delay: 3


Désactiver le délai pour certains groupes via permission


essentials.teleport.timer.bypass


Cooldown entre les /tpa


teleport-cooldown: 60


Durée de validité d'une demande TPA


tpa-accept-cancellation: 120


Téléportation vers les joueurs AFK


teleport-to-afk: true

Permissions

Structure des Permissions EssentialsX

essentials.<commande>              # Permission de base
essentials.<commande>.others       # Utiliser sur d'autres joueurs
essentials.<commande>.<argument>   # Arguments spécifiques

Permissions Recommandées par Groupe

Groupe : default (Joueurs)

permissions:
  - essentials.spawn
  - essentials.home
  - essentials.sethome
  - essentials.delhome
  - essentials.tpa
  - essentials.tpaccept
  - essentials.tpdeny
  - essentials.back
  - essentials.back.ondeath
  - essentials.warp
  - essentials.warp.list
  - essentials.balance
  - essentials.balance.others
  - essentials.pay
  - essentials.kit
  - essentials.kit.starter
  - essentials.msg
  - essentials.mail
  - essentials.mail.send
  - essentials.afk
  - essentials.seen
  - essentials.list
  - essentials.motd
  - essentials.rules
  - essentials.helpop
  - essentials.sethome.multiple.2

Groupe : VIP

permissions:
  - essentials.nick
  - essentials.nick.color
  - essentials.back.ondeath
  - essentials.kit.vip
  - essentials.sethome.multiple.5
  - essentials.tpa.cooldown.bypass
  - essentials.teleport.timer.bypass

Groupe : Modérateur

permissions:
  - essentials.tp
  - essentials.tphere
  - essentials.tppos
  - essentials.kick
  - essentials.kick.notify
  - essentials.mute
  - essentials.mute.notify
  - essentials.tempban
  - essentials.tempban.notify
  - essentials.jail
  - essentials.vanish
  - essentials.vanish.see
  - essentials.invsee
  - essentials.socialspy
  - essentials.helpop.receive
  - essentials.fly
  - essentials.god

Groupe : Admin

permissions:
  - essentials.*
  # Ou sélectivement :
  - essentials.ban
  - essentials.unban
  - essentials.setspawn
  - essentials.setwarp
  - essentials.delwarp
  - essentials.createkit
  - essentials.eco
  - essentials.eco.give
  - essentials.eco.take
  - essentials.eco.set
  - essentials.gamemode
  - essentials.time
  - essentials.weather
  - essentials.broadcast
  - essentials.essentials

Configuration avec LuckPerms (Exemple Complet)

# Créer les groupes
/lp creategroup vip
/lp creategroup mod
/lp creategroup admin


Hiérarchie


/lp group vip parent add default
/lp group mod parent add vip
/lp group admin parent add mod


Permissions Joueur


/lp group default permission set essentials.spawn
/lp group default permission set essentials.home
/lp group default permission set essentials.sethome
/lp group default permission set essentials.tpa
/lp group default permission set essentials.warp
/lp group default permission set essentials.balance
/lp group default permission set essentials.kit.starter


Permissions VIP


/lp group vip permission set essentials.fly
/lp group vip permission set essentials.nick
/lp group vip permission set essentials.kit.vip


Permissions Mod


/lp group mod permission set essentials.kick
/lp group mod permission set essentials.mute
/lp group mod permission set essentials.vanish
/lp group mod permission set essentials.tp


Permissions Admin


/lp group admin permission set essentials.*

Configuration Avancée

EssentialsX Chat

Installez EssentialsXChat pour personnaliser le chat.

Configuration dans config.yml :

# Activer le formatage du chat
chat:
  # Format global du chat
  format: '{DISPLAYNAME}&7: &f{MESSAGE}'
  

Format par groupe (nécessite Vault + LuckPerms)


  group-formats:
    default: '&7[Joueur] {DISPLAYNAME}&7: &f{MESSAGE}'
    vip: '&6[VIP] {DISPLAYNAME}&7: &f{MESSAGE}'
    mod: '&9[Mod] {DISPLAYNAME}&7: &f{MESSAGE}'
    admin: '&c[Admin] {DISPLAYNAME}&7: &f{MESSAGE}'

Variables Chat Disponibles

Variable Description
{DISPLAYNAME} Pseudo ou surnom du joueur
{USERNAME} Pseudo réel
{MESSAGE} Message envoyé
{GROUP} Groupe du joueur
{PREFIX} Préfixe LuckPerms
{SUFFIX} Suffixe LuckPerms
{WORLD} Monde actuel
{WORLDNAME} Nom du monde

EssentialsX Spawn

Configuration du spawn dans config.yml :

# Téléporter au spawn à la connexion
spawn-on-join: true


Uniquement pour les nouveaux joueurs


spawn-on-join: newbies


Spawn par groupe


spawn-on-join-groups:


    

  • default
    • 



Respawn au spawn (au lieu du lit)


respawn-at-spawn: true


Spawn par monde


respawn-at-spawn-by-world: false

Configuration dans spawn.yml :

spawns:
  default:
    world: world
    x: 0.5
    y: 100.0
    z: 0.5
    yaw: 0.0
    pitch: 0.0

Messages Personnalisés (MOTD, Rules)

Message du Jour (MOTD)

Créez/modifiez motd.txt :

&6╔════════════════════════════════════╗
&6║  &eBienvenue sur &bMonServeur&e !        &6║
&6║                                    &6║
&6║  &7• Site: &fwww.monserveur.fr        &6║
&6║  &7• Discord: &fdiscord.gg/monserveur &6║
&6║  &7• Boutique: &f/shop                &6║
&6║                                    &6║
&6║  &aBonne aventure !                  &6║
&6╚════════════════════════════════════╝

Règles

Créez/modifiez rules.txt :

&6&l▬▬▬ RÈGLES DU SERVEUR ▬▬▬


&e1. &fRespecter tous les joueurs
&e2. &fPas de triche ou de hack
&e3. &fPas de grief ou vol
&e4. &fPas de pub ou spam
&e5. &fUtiliser le bon sens


&7Enfreindre ces règles = Ban permanent

Codes Couleur

Code Couleur Code Couleur
&0 Noir &8 Gris foncé
&1 Bleu foncé &9 Bleu
&2 Vert foncé &a Vert clair
&3 Cyan foncé &b Cyan
&4 Rouge foncé &c Rouge
&5 Violet &d Rose
&6 Or &e Jaune
&7 Gris &f Blanc
Code Format
&l Gras
&o Italique
&n Souligné
&m ~~Barré~~
&r Reset

Dépannage

Problèmes Fréquents

"Unknown command" après installation

Causes possibles :

  1. Le plugin n'est pas chargé correctement
  2. Conflit avec un autre plugin

Solutions :

# Vérifier que le plugin est chargé
/plugins


Si rouge, vérifier les logs


/logs/latest.log


Redémarrer proprement


/stop

L'économie ne fonctionne pas avec d'autres plugins

Solution :

  1. Installez Vault
  2. Vérifiez que Vault détecte EssentialsX :
/vault-info economy

Les permissions ne fonctionnent pas

Vérifications :

# Tester une permission
/essentials:perm <joueur> essentials.fly


Avec LuckPerms, vérifier


/lp user <joueur> permission check essentials.fly

Les homes/warps ne se sauvegardent pas

Causes :

  • Problème de permissions fichiers
  • Arrêt brutal du serveur

Solutions :

# Sauvegarder manuellement
/essentials save


Vérifier les permissions du dossier


chmod -R 755 plugins/Essentials/

Messages d'erreur dans la console

Erreur : "Player data not found"

  • Normal pour les nouveaux joueurs
  • Les données sont créées à la première connexion

Erreur : "Could not load config"

  • Erreur de syntaxe YAML
  • Utilisez un validateur YAML en ligne
  • Vérifiez les espaces (pas de tabulations !)

Commandes de Diagnostic

# Version d'EssentialsX
/essentials version


Recharger la configuration


/essentials reload


Debug d'un joueur


/essentials debug


Informations économie


/essentials eco

Reset Complet

Si tout est cassé :

1. Arrêtez le serveur
2. Sauvegardez le dossier plugins/Essentials/
3. Supprimez plugins/Essentials/
4. Redémarrez le serveur (régénère les configs par défaut)
5. Reconfigurez progressivement

Commandes Rapides - Aide-Mémoire

Configuration Initiale

# 1. Définir le spawn
/setspawn


2. Créer les warps importants


/setwarp shop
/setwarp arena
/setwarp mine


3. Créer le kit de départ


(avec items dans l'inventaire)


/createkit starter 86400


4. Tester


/kit starter
/warp shop
/spawn

Gestion Joueur Rapide

# Téléportation
/tp <joueur>           # Aller vers
/tphere <joueur>       # Amener à soi


Modération


/kick <joueur> raison
/tempban <joueur> 1h raison
/mute <joueur> 10m


Économie


/eco give <joueur> 1000

Ressources Utiles

Conclusion

EssentialsX est la fondation de tout bon serveur Minecraft. Avec ce guide, vous avez toutes les clés pour :

  • Installer et configurer le plugin correctement
  • Gérer l'économie, les kits et les warps
  • Configurer les permissions par groupe
  • Personnaliser le chat et les messages
  • Résoudre les problèmes courants

Prochaines étapes recommandées :

  1. Installer LuckPerms pour les permissions avancées
  2. Configurer EssentialsX Chat pour un chat professionnel
  3. Créer des kits adaptés à votre gameplay
  4. Personnaliser les messages (MOTD, rules)
Retour au blog