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.
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
- Un serveur sous Paper, avec la commande
mc-consolemise en place dans le guide Installer et mettre à jour des plugins sur Paper - LuckPerms installé avec les groupes du guide Gérer les grades et permissions avec LuckPerms
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 :
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
exitPour Minecraft 26.1.2 ou 1.21.11, utilisez plutôt la version stable, à la place de la boucle ci-dessus :
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"
doneRedémarrez le serveur et attendez la ligne Done :
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fVérifier l'installation
Quittez le suivi avec Ctrl+C, puis lancez :
sudo mc-console plugins
sudo mc-console vault-info
sudo mc-console 'essentials version'Vous devez retrouver :
Essentials,EssentialsChat,EssentialsSpawn,LuckPermsetVaultdans la liste des pluginsPermission: LuckPermsetChat: LuckPermsdans la réponse devault-infoEconomy: Essentials Economydans 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 :
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"
doneComplétez ensuite les grades supérieurs :
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 :
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/config.ymlDans 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.
# 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: trueLe 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 :
sethome-multiple:
default: 3
vip: 5
staff: 10Appliquez vos changements sans redémarrer :
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 :
/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 :
newbies:
announce-format: '&dBienvenue à {DISPLAYNAME}&d sur le serveur !'
spawnpoint: newbies
kit: toolsLe 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 :
sudo -u minecraft nano /opt/minecraft/server/plugins/Essentials/kits.ymlAjoutez 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 :
kits:
depart:
delay: 86400
items:
- stonesword 1
- stonepickaxe 1
- bread 16Rechargez la configuration et autorisez le kit :
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 :
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é :
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 :
/sethome maison
/home maison
/spawn
/kit tools
/balanceChaque 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 :
sudo tar -czf /opt/minecraft/backups/essentials-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server/plugins EssentialsMettez toujours à jour tous les modules en même temps, car ils doivent avoir la même version. Pour un build de développement :
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.serviceEn 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 :
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.