EssentialsX

Logo d'EssentialsX

EssentialsX

Type

Utilitaire

Développeur

mdcfe, JRoy, pop4959

Statut

Installé

Grade requis

Pérégrin

Ressources

Documentation

Documentation

Site web

Site web

Hangar

Hangar

Modrinth

Modrinth

Spigot

Spigot

Code source

GitHub

Compatibilité

Dépendance(s)

Vault (recommandé)

Compatible avec

1.8.8 à 1.21.8

EssentialsX est la suite de plugins essentiels la plus populaire pour serveurs Paper et Spigot. C'est une continuation moderne du plugin original Essentials, avec plus de 130 commandes et d'innombrables fonctionnalités pour serveurs de toute taille.

Description

EssentialsX est un fork maintenu activement d'Essentials, offrant des améliorations de performance, corrections de bugs, et nouvelles fonctionnalités tout en restant compatible avec les configurations existantes. Le projet est développé par la communauté et soutient les dernières versions de Minecraft.

Modules

EssentialsX est divisé en plusieurs modules optionnels :

Module	Description	Utilité
EssentialsX	Core principal	Commandes de base, téléportation, économie
EssentialsXChat	Gestion du chat	Formats custom, canaux, modération chat
EssentialsXSpawn	Gestion des spawns	Spawn premier join, respawn, jail
EssentialsXProtect	Protection	Anti-grief basique, protection signes
EssentialsXAntiBuild	Contrôle construction	Restrictions de build par permissions
EssentialsXGeoIP	Géolocalisation	Affiche pays des joueurs (nécessite base MaxMind)
EssentialsXDiscord	Intégration Discord	Lie chat Minecraft ↔ Discord
EssentialsXXMPP	Support XMPP	Chat via protocole XMPP (rare)

Fonctionnalités principales

Catégorie	Fonctionnalités
Économie	Système économique complet Gestion de l'argent des joueurs Commandes /pay, /balance, /baltop Support Vault Taxes configurables Signes d'achat/vente
Téléportation	/home (homes multiples) /spawn, /setspawn /warp (warps publics) /tpa, /tpaccept, /tpdeny /back (retour position précédente) /top (téléport surface) Cooldowns et warmups configurables
Modération	/kick, /ban, /tempban /mute, /tempmute /jail (prison temporaire) /freeze (bloquer mouvement) /vanish (invisibilité staff) Système de bans IP Historique des sanctions
Chat	Formats de chat personnalisables Préfixes/suffixes (via LuckPerms + Vault) Chat local/global Canaux privés Anti-spam intégré Censure de mots Support émojis et couleurs
Utilitaires joueur	/afk (away from keyboard) /msg, /reply (messages privés) /mail (courrier hors ligne) /list (liste joueurs custom) /rules, /motd, /info /nick (pseudonyme) /realname (pseudo réel) Kits prédéfinis
Administration	/god (invincibilité)	/fly (vol) /speed (vitesse marche/vol) /gamemode, /gm /heal, /feed /repair, /enchant /give, /item /sudo (forcer commande) /invsee (voir inventaire)
Monde	/time, /weather /world (téléport entre mondes) Protection spawn configurable Anti-explosion Contrôle PvP par zone Limitation de créatures
Économie avancée	Signes d'achat [BUY] Signes de vente [SELL] Signes de trade [TRADE] Prix dynamiques Taxes sur transactions Worth (valeur items)
Divers	Coffres virtuels /enderchest Tables de craft portables /workbench Poubelle /trash Réparation /repair Enchantements /enchant Météo personnelle /pweather Temps personnel /ptime

Installation

Prérequis

• **Serveur** : Paper (recommandé), Spigot ou CraftBukkit
• **Version** : Minecraft 1.8.8 à 1.21.8
• **Plugins requis** :
  • Vault (pour permissions/économie)
  • LuckPerms (recommandé pour permissions)

Première configuration

# config.yml - Configuration de base

# Autoriser couleurs dans pseudos
allow-colored-names: true

# Nombre de homes par défaut
sethome-multiple:
  default: 3
  vip: 5
  admin: 10

# Cooldown téléportation (secondes)
teleport-cooldown: 5
teleport-delay: 3

# Spawn au premier join
spawn-on-join: true
spawn-on-join-first: true

# Économie de départ
starting-balance: 100

# Currency symbol
currency-symbol: '$'

# Protection spawn (rayon en blocs)
spawn-protection-radius: 16

# Kit par défaut au join
starter-kit: starter

# AFK auto après (secondes)
auto-afk: 300
auto-afk-kick: 600

Configuration avancée

Chat personnalisé (EssentialsXChat)

# config.yml d'EssentialsXChat

format: '{DISPLAYNAME}: {MESSAGE}'

# Format avec grades LuckPerms
format: '&7[{GROUP}] &r{DISPLAYNAME}&7: &f{MESSAGE}'

# Chat local (rayon 100 blocs)
chat-radius: 100

# Canaux
channels:
  global:
    format: '&a[Global] &r{DISPLAYNAME}&7: {MESSAGE}'
    radius: 0
  local:
    format: '&e[Local] &r{DISPLAYNAME}&7: {MESSAGE}'
    radius: 100
  staff:
    format: '&c[Staff] &r{DISPLAYNAME}&7: {MESSAGE}'
    permission: 'essentials.chat.staff'

Kits

# kits.yml

kits:
  starter:
    delay: 0
    items:
      - stone_sword 1
      - bread 16
      - leather_helmet 1
      - leather_chestplate 1
      - leather_leggings 1
      - leather_boots 1
  
  vip:
    delay: 86400 # 24h
    permission: essentials.kits.vip
    items:
      - diamond_sword 1 sharpness:2
      - golden_apple 5
      - diamond_helmet 1 protection:2
      - diamond_chestplate 1 protection:2
      - diamond_leggings 1 protection:2
      - diamond_boots 1 protection:2
  
  tools:
    delay: 3600 # 1h
    items:
      - diamond_pickaxe 1 efficiency:3 unbreaking:2
      - diamond_axe 1 efficiency:3
      - diamond_shovel 1 efficiency:3

Warps

# Créer un warp
/setwarp [nom]

# Exemples
/setwarp spawn
/setwarp shop
/setwarp pvp
/setwarp minage

# Téléportation
/warp [nom]

# Liste
/warp

Worth (valeur items)

# worth.yml

worth:
  # Format: MATERIAL: prix
  
  # Minerais
  diamond: 100
  emerald: 150
  gold_ingot: 50
  iron_ingot: 10
  
  # Blocs
  stone: 0.1
  cobblestone: 0.1
  dirt: 0.05
  
  # Nourriture
  bread: 5
  cooked_beef: 8
  golden_apple: 50

Signes

Signe d'achat :

Ligne 1: [Buy]
Ligne 2: quantité
Ligne 3: material:data
Ligne 4: prix

Exemple:
[Buy]
64
stone
10

Signe de vente :

Ligne 1: [Sell]
Ligne 2: quantité
Ligne 3: material
Ligne 4: prix

Exemple:
[Sell]
64
diamond
1000

Commandes principales

Commande	Description	Permission
Économie
/balance [joueur]	Voir son argent	essentials.balance
/baltop [page]	Top des plus riches	essentials.balancetop
/pay <joueur> <montant>	Payer un joueur	essentials.pay
/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 l'argent	essentials.eco.set
/sell hand	Vendre item en main	essentials.sell
/sell all	Vendre tout l'inventaire	essentials.sell
/worth [item]	Valeur d'un item	essentials.worth
Téléportation
/home [nom]	Téléport home	essentials.home
/sethome [nom]	Définir home	essentials.sethome
/delhome [nom]	Supprimer home	essentials.delhome
/spawn	Téléport spawn	essentials.spawn
/setspawn	Définir spawn	essentials.setspawn
/warp <nom>	Téléport warp	essentials.warp
/setwarp <nom>	Créer warp	essentials.setwarp
/delwarp <nom>	Supprimer warp	essentials.delwarp
/tpa <joueur>	Demande téléportation	essentials.tpa
/tpahere <joueur>	Demande que joueur vienne	essentials.tpahere
/tpaccept	Accepter demande	essentials.tpaccept
/tpdeny	Refuser demande	essentials.tpdeny
/back	Retour position	essentials.back
/tp <joueur>	Téléport à joueur	essentials.tp
/tphere <joueur>	Téléporter joueur	essentials.tphere
/top	Téléport surface	essentials.top
Communication
/msg <joueur> <message>	Message privé	essentials.msg
/reply <message>	Répondre	essentials.msg.reply
/mail send <joueur> <message>	Envoyer mail	essentials.mail.send
/mail read	Lire mails	essentials.mail
/mail clear	Effacer mails	essentials.mail.clear
/broadcast <message>	Annonce serveur	essentials.broadcast
/me <action>	Action RP	essentials.me
Modération
/kick <joueur> [raison]	Expulser	essentials.kick
/ban <joueur> [raison]	Bannir	essentials.ban
/tempban <joueur> <durée> [raison]	Ban temporaire	essentials.tempban
/unban <joueur>	Débannir	essentials.unban
/mute <joueur> [durée]	Rendre muet	essentials.mute
/unmute <joueur>	Démute	essentials.unmute
/jail <joueur> <prison> <durée>	Emprisonner	essentials.jail
/unjail <joueur>	Libérer	essentials.unjail
/freeze <joueur>	Figer joueur	essentials.freeze
/vanish	Invisibilité	essentials.vanish
/socialspy	Espionner MPs	essentials.socialspy
Utilitaires
/afk	Marquer AFK	essentials.afk
/nick <pseudo>	Changer pseudo	essentials.nick
/realname <pseudo>	Voir vrai nom	essentials.realname
/list	Liste joueurs	essentials.list
/rules	Voir règles	essentials.rules
/kit <nom>	Récupérer kit	essentials.kits.[nom]
/suicide	Se suicider	essentials.suicide
/hat	Item sur tête	essentials.hat
/repair [all/hand]	Réparer	essentials.repair
/workbench	Table craft	essentials.workbench
/enderchest	Coffre ender	essentials.enderchest
/trash	Poubelle	essentials.trash
Administration
/god [joueur]	Mode dieu	essentials.god
/fly [joueur]	Voler	essentials.fly
/speed <1-10>	Vitesse	essentials.speed
/heal [joueur]	Soigner	essentials.heal
/feed [joueur]	Nourrir	essentials.feed
/give <joueur> <item> [qté]	Donner item	essentials.give
/item <material> [qté]	Obtenir item	essentials.item
/enchant <enchant> [level]	Enchanter	essentials.enchant
/gamemode <mode> [joueur]	Changer gamemode	essentials.gamemode
/invsee <joueur>	Voir inventaire	essentials.invsee
/sudo <joueur> <commande>	Forcer commande	essentials.sudo
/ext [joueur]	Éteindre feu	essentials.ext
/lightning <joueur>	Foudre	essentials.lightning
/skull [joueur]	Tête de joueur	essentials.skull
Monde
/time <set/add> <valeur>	Changer heure	essentials.time
/ptime <heure>	Heure personnelle	essentials.ptime
/weather <type>	Changer météo	essentials.weather
/pweather <type>	Météo personnelle	essentials.pweather
/world <monde>	Téléport monde	essentials.world
/biome	Voir biome	essentials.biome

Permissions

Structure des permissions

# Exemple avec LuckPerms

# Groupe Joueur
/lp group default permission set essentials.home
/lp group default permission set essentials.sethome.multiple.3
/lp group default permission set essentials.spawn
/lp group default permission set essentials.warp
/lp group default permission set essentials.tpa
/lp group default permission set essentials.msg
/lp group default permission set essentials.balance
/lp group default permission set essentials.pay
/lp group default permission set essentials.kit.starter

# Groupe VIP
/lp group vip permission set essentials.sethome.multiple.5
/lp group vip permission set essentials.fly
/lp group vip permission set essentials.hat
/lp group vip permission set essentials.nick
/lp group vip permission set essentials.kit.vip
/lp group vip permission set essentials.back.ondeath

# Groupe Modérateur
/lp group moderator permission set essentials.kick
/lp group moderator permission set essentials.mute
/lp group moderator permission set essentials.tempban
/lp group moderator permission set essentials.jail
/lp group moderator permission set essentials.vanish
/lp group moderator permission set essentials.socialspy
/lp group moderator permission set essentials.invsee

# Groupe Admin
/lp group admin permission set essentials.*
/lp group admin permission set essentials.sudo
/lp group admin permission set essentials.god
/lp group admin permission set essentials.gamemode

Permissions importantes

Permission	Description
essentials.home.unlimited	Homes illimités
essentials.sethome.multiple.<nombre>	Limite de homes
essentials.back.ondeath	/back après mort
essentials.teleport.cooldown.bypass	Bypass cooldown TP
essentials.teleport.timer.bypass	Bypass warmup TP
essentials.vanish.see	Voir joueurs vanish
essentials.fly.safelogin	Garder fly au login
essentials.nick.color	Couleurs dans /nick
essentials.chat.color	Couleurs dans chat
essentials.chat.format	Formater chat (gras, etc.)
essentials.signs.use.*	Utiliser tous signes
essentials.signs.create.*	Créer tous signes
essentials.oversizedstacks	Stacks > 64

Intégrations

Vault

EssentialsX s'intègre automatiquement avec Vault pour fournir :

• API économie standard
• Support préfixes/suffixes depuis LuckPerms
• Compatibilité avec plugins tierces

PlaceholderAPI

EssentialsX fournit des placeholders PAPI :

%essentials_nickname% → Pseudo avec couleurs
%essentials_afk% → Statut AFK
%essentials_godmode% → Mode dieu
%essentials_fly% → Mode vol
%essentials_balance% → Argent
%essentials_worth% → Valeur item en main
%essentials_home_<nom>% → Coordonnées home

Discord (EssentialsXDiscord)

Configuration Discord :

# config.yml d'EssentialsXDiscord

# Token bot Discord
token: 'YOUR_BOT_TOKEN_HERE'

# ID du canal
channel-id: '123456789012345678'

# Format des messages
message-format: '**{displayname}**: {message}'

# Relayer événements
console-relay:
  enable: true

# Commandes Discord
commands:
  list:
    enable: true
  msg:
    enable: true

Voir aussi

• Vault
• LuckPerms
• PlaceholderAPI