[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-fr-installer-utiliser-essentialsx-minecraft":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":21,"docGroup":26,"docGroupIcon":26,"link_en":27,"bodyHtml":28},"\u002Fdocs\u002Ffr\u002Fgaming\u002Fminecraft-java\u002Finstaller-utiliser-essentialsx-minecraft","installer-utiliser-essentialsx-minecraft","Comment installer et configurer EssentialsX sur un serveur Minecraft ?","Installez et configurez EssentialsX sur votre serveur Minecraft hébergé chez Winheberg. Homes, économie, chat, kits, commandes et permissions LuckPerms.","jeux","minecraft-java","tabler:file-text","2026-08-11","Winheberg",61,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fminecraft-java\u002Finstaller-utiliser-essentialsx-minecraft.webp",[16,17,18,19,20],"essentialsx","minecraft","plugin","luckperms","permissions",[16,22,23,19,24,25],"plugin minecraft","config.yml essentials","kits essentialsx","winheberg","","\u002Fen\u002Fdocs\u002Fminecraft-java\u002Finstall-use-essentialsx-minecraft","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> 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.\u003C\u002Fp>\n\u003Cp>Plutôt que d'empiler une dizaine de petits plugins, \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> offre un ensemble cohérent et optimisé pour les serveurs modernes. Ce guide vous accompagne pour l'installer depuis votre \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">panel Winheberg\u003C\u002Fa>, le configurer et l'utiliser sereinement.\u003C\u002Fp>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Un serveur Minecraft Java (Spigot, Paper ou Purpur) actif sur votre \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">panel Winheberg\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Un plugin de gestion des permissions comme \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong> pour distribuer les accès aux joueurs\u003C\u002Fli>\n\u003Cli>Le plugin \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fwww.curseforge.com\u002Fminecraft\u002Fbukkit-plugins\u002Fvault\u002Ffiles\u002Fall?page=1&pageSize=20&showAlphaFiles=hide\">Vault\u003C\u002Fa>\u003C\u002Fstrong> si vous souhaitez relier l'économie d'\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> à d'autres plugins\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Arrêtez votre serveur avant l'installation initiale pour éviter les conflits d'écriture lors de la génération des fichiers de configuration.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Étape 1 : Installer EssentialsX via le panel\u003C\u002Fh2>\n\u003Cp>Le \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">panel Winheberg\u003C\u002Fa> simplifie l'installation des plugins. Vous pouvez choisir l'installation automatique ou la méthode manuelle.\u003C\u002Fp>\n\u003Ch3>Méthode A : Installation automatique (recommandée)\u003C\u002Fh3>\n\u003Col>\n\u003Cli>Connectez-vous à votre \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">panel Winheberg\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Arrêtez votre serveur pour éviter les erreurs d'écriture lors de la configuration initiale\u003C\u002Fli>\n\u003Cli>Dans le menu de navigation, cliquez sur le bouton \u003Cstrong>Plugins\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Utilisez la barre de recherche et tapez \u003Ccode>EssentialsX\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Cliquez sur le bouton d'installation à côté d'\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> (Core), puis ajoutez \u003Ccode>EssentialsXChat\u003C\u002Fcode> pour le format du chat et \u003Ccode>EssentialsXSpawn\u003C\u002Fcode> pour le point de réapparition selon vos besoins\u003C\u002Fli>\n\u003Cli>Redémarrez votre serveur pour que le panel déploie automatiquement les fichiers requis\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fminecraft-java\u002Finstaller-utiliser-essentialsx-minecraft-1786463140736-f7215529285bcafef2647e2d.webp\" alt=\"Onglet d'installation des plugins via le bouton Plugin sur le panel Winheberg\" width=\"800\" \u002F>\n\n\u003Ch3>Méthode B : Installation manuelle via le gestionnaire de fichiers\u003C\u002Fh3>\n\u003Col>\n\u003Cli>Téléchargez les fichiers \u003Ccode>.jar\u003C\u002Fcode> voulus depuis le site officiel d'\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002Fdownloads.html\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Sur votre panel gaming, ouvrez l'onglet \u003Cstrong>File manager\u003C\u002Fstrong> (Gestionnaire de fichiers)\u003C\u002Fli>\n\u003Cli>Accédez au dossier \u003Ccode>\u002Fplugins\u002F\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Cliquez sur le bouton \u003Cstrong>Upload\u003C\u002Fstrong> en haut à droite et sélectionnez les fichiers \u003Ccode>.jar\u003C\u002Fcode>, ou glissez-déposez-les dans la fenêtre\u003C\u002Fli>\n\u003Cli>Démarrez votre serveur pour générer l'arborescence des fichiers de configuration\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2>Étape 2 : Configurer les fonctionnalités clés (config.yml)\u003C\u002Fh2>\n\u003Cp>Une fois le serveur relancé, un dossier \u003Ccode>\u002Fplugins\u002FEssentials\u002F\u003C\u002Fcode> est créé. Il contient le fichier central de configuration \u003Ccode>config.yml\u003C\u002Fcode>, que vous pouvez ouvrir depuis le gestionnaire de fichiers du panel. Voici les sections prioritaires à adapter.\u003C\u002Fp>\n\u003Ch3>1. Nombre maximal de homes par joueur\u003C\u002Fh3>\n\u003Cp>Recherchez la section \u003Ccode>sethome-multiple\u003C\u002Fcode> pour attribuer des quotas de résidences selon les groupes de permissions.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-yaml\">sethome-multiple:\n  default: 3\n  vip: 5\n  staff: 20\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Pour que le groupe VIP profite de 5 homes, attribuez-lui la permission \u003Ccode>essentials.sethome.multiple.vip\u003C\u002Fcode> via votre plugin de permissions comme \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch3>2. Format du chat (nécessite EssentialsXChat)\u003C\u002Fh3>\n\u003Cp>Repérez la section \u003Ccode>chat\u003C\u002Fcode> pour lier vos grades et harmoniser l'affichage en jeu.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-yaml\">chat:\n  radius: 0\n  format: '<{DISPLAYNAME}> {MESSAGE}'\n  group-formats:\n    default: '&7[Joueur] {DISPLAYNAME}&7> &f{MESSAGE}'\n    vip: '&e[VIP] {DISPLAYNAME}&f> &a{MESSAGE}'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3>3. Économie globale\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> intègre son propre système de monnaie. Adaptez les valeurs de base selon l'équilibrage de votre gameplay.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-yaml\">starting-balance: 100\ncurrency-symbol: '$'\nmax-money: 10000000\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>Étape 3 : Commandes essentielles et permissions\u003C\u002Fh2>\n\u003Cp>Voici un récapitulatif des commandes les plus utiles pour l'administration et pour les joueurs.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Commande\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003Cth>Permission associée\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fv\u003C\u002Fcode> ou \u003Ccode>\u002Fvanish\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Rend le modérateur invisible\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.vanish\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Ffly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Active ou désactive le mode vol\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.fly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fsetwarp [nom]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Crée un point de téléportation public\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.setwarp\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fwarp [nom]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Téléporte vers un warp\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.warp\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fkit [nom]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Donne un lot d'objets prédéfinis\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.kit.[nom]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fess reload\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recharge la configuration\u003C\u002Ftd>\n\u003Ctd>Console ou opérateur\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Par défaut, les opérateurs (\u003Ccode>\u002Fop\u003C\u002Fcode>) ont accès à toutes les commandes. Pour les joueurs réguliers, utilisez un plugin de gestion des permissions comme \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong> afin de distribuer les accès de façon contrôlée.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Étape 4 : Créer et distribuer des kits\u003C\u002Fh2>\n\u003Cp>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 \u003Ccode>kits\u003C\u002Fcode> du fichier \u003Ccode>config.yml\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-yaml\">kits:\n  bienvenue:\n    delay: 86400\n    items:\n      - diamond_sword 1\n      - bread 16\n      - iron_helmet 1\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Le paramètre \u003Ccode>delay\u003C\u002Fcode> s'exprime en secondes. Dans cet exemple, \u003Ccode>86400\u003C\u002Fcode> secondes correspondent à un temps de recharge de 24 heures avant de pouvoir réclamer à nouveau le kit.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Ch3>❌ Les joueurs ne peuvent pas utiliser \u003Ccode>\u002Fspawn\u003C\u002Fcode> ou \u003Ccode>\u002Fhome\u003C\u002Fcode>\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> bloque la plupart des commandes pour les non-opérateurs par défaut.\u003C\u002Fli>\n\u003Cli>Attribuez les permissions \u003Ccode>essentials.spawn\u003C\u002Fcode> et \u003Ccode>essentials.home\u003C\u002Fcode> aux groupes concernés via \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Vérifiez que le joueur appartient bien au groupe auquel la permission a été accordée.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Les modifications de \u003Ccode>config.yml\u003C\u002Fcode> ne s'appliquent pas en jeu\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Rechargez le plugin avec la commande \u003Ccode>\u002Fess reload\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Lancez cette commande depuis la console du panel ou en jeu si vous êtes opérateur.\u003C\u002Fli>\n\u003Cli>Contrôlez l'indentation YAML : une erreur de format empêche le chargement du fichier.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ L'économie n'est pas reconnue par les autres plugins\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Installez le plugin \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fwww.curseforge.com\u002Fminecraft\u002Fbukkit-plugins\u002Fvault\u002Ffiles\u002Fall?page=1&pageSize=20&showAlphaFiles=hide\">Vault\u003C\u002Fa>\u003C\u002Fstrong>, qui sert de pont économique entre \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> et les autres plugins.\u003C\u002Fli>\n\u003Cli>Redémarrez le serveur après l'ajout de \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fwww.curseforge.com\u002Fminecraft\u002Fbukkit-plugins\u002Fvault\u002Ffiles\u002Fall?page=1&pageSize=20&showAlphaFiles=hide\">Vault\u003C\u002Fa>\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Vérifiez dans les logs que \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fwww.curseforge.com\u002Fminecraft\u002Fbukkit-plugins\u002Fvault\u002Ffiles\u002Fall?page=1&pageSize=20&showAlphaFiles=hide\">Vault\u003C\u002Fa>\u003C\u002Fstrong> détecte bien \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> comme fournisseur d'économie.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Bonnes pratiques\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Sauvegarder l'environnement :\u003C\u002Fstrong> Effectuez une sauvegarde depuis l'onglet \u003Cstrong>Backups\u003C\u002Fstrong> de votre panel avant toute modification importante.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Recharger sans redémarrer :\u003C\u002Fstrong> Privilégiez l'utilisation de la commande \u003Ccode>\u002Fess reload\u003C\u002Fcode> après avoir modifié un fichier YAML plutôt que de relancer tout le serveur.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Déléguer les accès proprement :\u003C\u002Fstrong> Confiez la distribution des permissions à \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong> plutôt que d'attribuer le statut d'opérateur (\u003Ccode>\u002Fop\u003C\u002Fcode>) aux membres du staff.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Valider les configurations :\u003C\u002Fstrong> Testez vos kits, warps et permissions en jeu à l'aide d'un compte joueur standard non-opérateur.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d'aide ?\u003C\u002Fh2>\n\u003Cp>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.\u003C\u002Fp>\n\u003Cp>Ouvrez un ticket d'assistance technique depuis le \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\u002Flogin\">support Winheberg\u003C\u002Fa>. Nos équipes vous aideront à vérifier vos fichiers et à résoudre vos conflits ! 🎮\u003C\u002Fp>\n",1788993137556]