--- title: "Comment installer et configurer EssentialsX sur un serveur Minecraft ?" description: "Installez et configurez EssentialsX sur votre serveur Minecraft hébergé chez Winheberg. Homes, économie, chat, kits, commandes et permissions LuckPerms." category: jeux subcategory: minecraft-java icon: tabler:file-text date: 2026-08-11 author: Winheberg slug: "installer-utiliser-essentialsx-minecraft" order: 61 image: /statics/images/docs/fr/gaming/minecraft-java/installer-utiliser-essentialsx-minecraft.webp tags: [essentialsx, minecraft, plugin, luckperms, permissions] keywords: [essentialsx, plugin minecraft, config.yml essentials, luckperms, kits essentialsx, winheberg] link_en: "/en/docs/minecraft-java/install-use-essentialsx-minecraft" --- ## Contexte **[EssentialsX](https://essentialsx.net/)** est l'un des plugins de référence pour toute infrastructure de serveur Minecraft basée sur Spigot, Paper ou Purpur. Il regroupe plus d'une centaine de fonctionnalités qui manquent au jeu d'origine, parmi lesquelles la téléportation (homes, warps, tpa), une économie intégrée, la gestion des kits, des outils de modération (ban, mute, kick) et la personnalisation des messages système. Plutôt que d'empiler une dizaine de petits plugins, **[EssentialsX](https://essentialsx.net/)** offre un ensemble cohérent et optimisé pour les serveurs modernes. Ce guide vous accompagne pour l'installer depuis votre [panel Winheberg](https://panel.winheberg.com), le configurer et l'utiliser sereinement. ## Prérequis - Un serveur Minecraft Java (Spigot, Paper ou Purpur) actif sur votre [panel Winheberg](https://panel.winheberg.com) - Un plugin de gestion des permissions comme **[LuckPerms](https://luckperms.net/)** pour distribuer les accès aux joueurs - Le plugin **[Vault](https://www.curseforge.com/minecraft/bukkit-plugins/vault/files/all?page=1&pageSize=20&showAlphaFiles=hide)** si vous souhaitez relier l'économie d'**[EssentialsX](https://essentialsx.net/)** à d'autres plugins > [!WARNING] > Arrêtez votre serveur avant l'installation initiale pour éviter les conflits d'écriture lors de la génération des fichiers de configuration. ## Étape 1 : Installer EssentialsX via le panel Le [panel Winheberg](https://panel.winheberg.com) simplifie l'installation des plugins. Vous pouvez choisir l'installation automatique ou la méthode manuelle. ### Méthode A : Installation automatique (recommandée) 1. Connectez-vous à votre [panel Winheberg](https://panel.winheberg.com) 2. Arrêtez votre serveur pour éviter les erreurs d'écriture lors de la configuration initiale 3. Dans le menu de navigation, cliquez sur le bouton **Plugins** 4. Utilisez la barre de recherche et tapez `EssentialsX` 5. Cliquez sur le bouton d'installation à côté d'**[EssentialsX](https://essentialsx.net/)** (Core), puis ajoutez `EssentialsXChat` pour le format du chat et `EssentialsXSpawn` pour le point de réapparition selon vos besoins 6. Redémarrez votre serveur pour que le panel déploie automatiquement les fichiers requis Onglet d'installation des plugins via le bouton Plugin sur le panel Winheberg ### Méthode B : Installation manuelle via le gestionnaire de fichiers 1. Téléchargez les fichiers `.jar` voulus depuis le site officiel d'**[EssentialsX](https://essentialsx.net/downloads.html)** 2. Sur votre panel gaming, ouvrez l'onglet **File manager** (Gestionnaire de fichiers) 3. Accédez au dossier `/plugins/` 4. Cliquez sur le bouton **Upload** en haut à droite et sélectionnez les fichiers `.jar`, ou glissez-déposez-les dans la fenêtre 5. Démarrez votre serveur pour générer l'arborescence des fichiers de configuration ## Étape 2 : Configurer les fonctionnalités clés (config.yml) Une fois le serveur relancé, un dossier `/plugins/Essentials/` est créé. Il contient le fichier central de configuration `config.yml`, que vous pouvez ouvrir depuis le gestionnaire de fichiers du panel. Voici les sections prioritaires à adapter. ### 1. Nombre maximal de homes par joueur Recherchez la section `sethome-multiple` pour attribuer des quotas de résidences selon les groupes de permissions. ```yaml sethome-multiple: default: 3 vip: 5 staff: 20 ``` > [!TIP] > Pour que le groupe VIP profite de 5 homes, attribuez-lui la permission `essentials.sethome.multiple.vip` via votre plugin de permissions comme **[LuckPerms](https://luckperms.net/)**. ### 2. Format du chat (nécessite EssentialsXChat) Repérez la section `chat` pour lier vos grades et harmoniser l'affichage en jeu. ```yaml chat: radius: 0 format: '<{DISPLAYNAME}> {MESSAGE}' group-formats: default: '&7[Joueur] {DISPLAYNAME}&7> &f{MESSAGE}' vip: '&e[VIP] {DISPLAYNAME}&f> &a{MESSAGE}' ``` ### 3. Économie globale **[EssentialsX](https://essentialsx.net/)** intègre son propre système de monnaie. Adaptez les valeurs de base selon l'équilibrage de votre gameplay. ```yaml starting-balance: 100 currency-symbol: '$' max-money: 10000000 ``` ## Étape 3 : Commandes essentielles et permissions Voici un récapitulatif des commandes les plus utiles pour l'administration et pour les joueurs. | Commande | Description | Permission associée | |---|---|---| | `/v` ou `/vanish` | Rend le modérateur invisible | `essentials.vanish` | | `/fly` | Active ou désactive le mode vol | `essentials.fly` | | `/setwarp [nom]` | Crée un point de téléportation public | `essentials.setwarp` | | `/warp [nom]` | Téléporte vers un warp | `essentials.warp` | | `/kit [nom]` | Donne un lot d'objets prédéfinis | `essentials.kit.[nom]` | | `/ess reload` | Recharge la configuration | Console ou opérateur | > [!WARNING] > Par défaut, les opérateurs (`/op`) ont accès à toutes les commandes. Pour les joueurs réguliers, utilisez un plugin de gestion des permissions comme **[LuckPerms](https://luckperms.net/)** afin de distribuer les accès de façon contrôlée. ## Étape 4 : Créer et distribuer des kits Les kits permettent d'offrir des lots d'équipements à vos joueurs, par exemple un kit de bienvenue ou un kit journalier. Définissez-les dans la section `kits` du fichier `config.yml`. ```yaml kits: bienvenue: delay: 86400 items: - diamond_sword 1 - bread 16 - iron_helmet 1 ``` > [!NOTE] > Le paramètre `delay` s'exprime en secondes. Dans cet exemple, `86400` secondes correspondent à un temps de recharge de 24 heures avant de pouvoir réclamer à nouveau le kit. ## En cas de problème ### ❌ Les joueurs ne peuvent pas utiliser `/spawn` ou `/home` - **[EssentialsX](https://essentialsx.net/)** bloque la plupart des commandes pour les non-opérateurs par défaut. - Attribuez les permissions `essentials.spawn` et `essentials.home` aux groupes concernés via **[LuckPerms](https://luckperms.net/)**. - Vérifiez que le joueur appartient bien au groupe auquel la permission a été accordée. ### ❌ Les modifications de `config.yml` ne s'appliquent pas en jeu - Rechargez le plugin avec la commande `/ess reload`. - Lancez cette commande depuis la console du panel ou en jeu si vous êtes opérateur. - Contrôlez l'indentation YAML : une erreur de format empêche le chargement du fichier. ### ❌ L'économie n'est pas reconnue par les autres plugins - Installez le plugin **[Vault](https://www.curseforge.com/minecraft/bukkit-plugins/vault/files/all?page=1&pageSize=20&showAlphaFiles=hide)**, qui sert de pont économique entre **[EssentialsX](https://essentialsx.net/)** et les autres plugins. - Redémarrez le serveur après l'ajout de **[Vault](https://www.curseforge.com/minecraft/bukkit-plugins/vault/files/all?page=1&pageSize=20&showAlphaFiles=hide)**. - Vérifiez dans les logs que **[Vault](https://www.curseforge.com/minecraft/bukkit-plugins/vault/files/all?page=1&pageSize=20&showAlphaFiles=hide)** détecte bien **[EssentialsX](https://essentialsx.net/)** comme fournisseur d'économie. ## Bonnes pratiques - **Sauvegarder l'environnement :** Effectuez une sauvegarde depuis l'onglet **Backups** de votre panel avant toute modification importante. - **Recharger sans redémarrer :** Privilégiez l'utilisation de la commande `/ess reload` après avoir modifié un fichier YAML plutôt que de relancer tout le serveur. - **Déléguer les accès proprement :** Confiez la distribution des permissions à **[LuckPerms](https://luckperms.net/)** plutôt que d'attribuer le statut d'opérateur (`/op`) aux membres du staff. - **Valider les configurations :** Testez vos kits, warps et permissions en jeu à l'aide d'un compte joueur standard non-opérateur. ## Besoin d'aide ? Si malgré ce guide vous rencontrez des difficultés de configuration ou des erreurs de plugin dans vos logs, n'hésitez pas à solliciter notre assistance. Ouvrez un ticket d'assistance technique depuis le [support Winheberg](https://billing.winheberg.com/login). Nos équipes vous aideront à vérifier vos fichiers et à résoudre vos conflits ! 🎮