[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-en-install-use-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_fr":27,"bodyHtml":28},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-use-essentialsx-minecraft","install-use-essentialsx-minecraft","How to install and configure EssentialsX on a Minecraft server","Install and configure EssentialsX on your Minecraft server hosted at Winheberg. Homes, economy, chat, kits, commands and LuckPerms permissions.","jeux","minecraft-java","tabler:file-text","2026-08-11","Winheberg",61,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-use-essentialsx-minecraft.webp",[16,17,18,19,20],"essentialsx","minecraft","plugin","luckperms","permissions",[16,22,23,19,24,25],"minecraft plugin","essentials config.yml","essentialsx kits","winheberg","","\u002Fdocs\u002Fminecraft-java\u002Finstaller-utiliser-essentialsx-minecraft","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> is one of the foundational plugins for any Spigot, Paper, or Purpur Minecraft server infrastructure. It combines over a hundred core utilities missing from vanilla gameplay, including player teleports (homes, warps, tpa), a complete economy system, kit management, moderation toolsets (ban, mute, kick), and customizable system messaging.\u003C\u002Fp>\n\u003Cp>Rather than stacking dozens of single-purpose plugins, \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> provides a unified, performance-optimized suite designed for modern servers. This technical guide explains how to install, configure, and manage \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> through your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active Java Minecraft server (Spigot, Paper, or Purpur) hosted on your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>A permission manager plugin such as \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong> to assign node access to players\u003C\u002Fli>\n\u003Cli>The \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> plugin installed if you plan to hook \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> economy into third-party 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>Stop your server before performing the initial installation to avoid file locking and configuration generation issues.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Step 1: Install EssentialsX via Panel\u003C\u002Fh2>\n\u003Cp>The \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa> simplifies plugin management. You can choose between automatic installation and manual deployment.\u003C\u002Fp>\n\u003Ch3>Method A: Automatic Installation (Recommended)\u003C\u002Fh3>\n\u003Col>\n\u003Cli>Log into your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>Stop your server instance to avoid write conflicts during initial setup\u003C\u002Fli>\n\u003Cli>Navigation bar: click the \u003Cstrong>Plugins\u003C\u002Fstrong> button\u003C\u002Fli>\n\u003Cli>Use the search bar to locate \u003Ccode>EssentialsX\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Click the install button beside \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> (Core), then add \u003Ccode>EssentialsXChat\u003C\u002Fcode> for chat formatting and \u003Ccode>EssentialsXSpawn\u003C\u002Fcode> for spawn handling as required\u003C\u002Fli>\n\u003Cli>Restart your server so the panel deploys the required files and dependencies\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-use-essentialsx-minecraft-1786463140736-f7215529285bcafef2647e2d.webp\" alt=\"Plugin installation tab via the Plugins button on the Winheberg panel\" width=\"800\" \u002F>\n\n\u003Ch3>Method B: Manual Installation via File Manager\u003C\u002Fh3>\n\u003Col>\n\u003Cli>Download the required \u003Ccode>.jar\u003C\u002Fcode> files from the official \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002Fdownloads.html\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> site\u003C\u002Fli>\n\u003Cli>Access your panel and navigate to the \u003Cstrong>File manager\u003C\u002Fstrong> tab\u003C\u002Fli>\n\u003Cli>Open the \u003Ccode>\u002Fplugins\u002F\u003C\u002Fcode> directory\u003C\u002Fli>\n\u003Cli>Click the \u003Cstrong>Upload\u003C\u002Fstrong> button at the top right and select your \u003Ccode>.jar\u003C\u002Fcode> files, or drag-and-drop them into the interface\u003C\u002Fli>\n\u003Cli>Start your server to generate the configuration directories\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2>Step 2: Configure Core Features (config.yml)\u003C\u002Fh2>\n\u003Cp>After restarting, a \u003Ccode>\u002Fplugins\u002FEssentials\u002F\u003C\u002Fcode> directory is generated. It contains the primary configuration file, \u003Ccode>config.yml\u003C\u002Fcode>, which can be edited directly inside the panel's File manager. Below are key settings to adapt.\u003C\u002Fp>\n\u003Ch3>1. Maximum Homes per Rank\u003C\u002Fh3>\n\u003Cp>Locate the \u003Ccode>sethome-multiple\u003C\u002Fcode> section to set home quotas for different permission groups.\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>For the VIP group to claim 5 homes, assign them the permission node \u003Ccode>essentials.sethome.multiple.vip\u003C\u002Fcode> using your permission manager like \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch3>2. Chat Formatting (Requires EssentialsXChat)\u003C\u002Fh3>\n\u003Cp>Locate the \u003Ccode>chat\u003C\u002Fcode> section to format chat tags and rank prefixes.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-yaml\">chat:\n  radius: 0\n  format: '<{DISPLAYNAME}> {MESSAGE}'\n  group-formats:\n    default: '&7[Player] {DISPLAYNAME}&7> &f{MESSAGE}'\n    vip: '&e[VIP] {DISPLAYNAME}&f> &a{MESSAGE}'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3>3. Economy Setup\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> features a built-in currency engine. Adjust default values to match your server's balance.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-yaml\">starting-balance: 100\ncurrency-symbol: '$'\nmax-money: 10000000\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>Step 3: Essential Commands and Permissions\u003C\u002Fh2>\n\u003Cp>Below is a summary of widely used commands for server admins and players.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Command\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003Cth>Permission Node\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fv\u003C\u002Fcode> or \u003Ccode>\u002Fvanish\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Toggles administrator invisibility\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>Toggles flight mode\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.fly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fsetwarp [name]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Creates a public warp location\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.setwarp\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fwarp [name]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Teleports player to a warp\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.warp\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fkit [name]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Grants a predefined item kit\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>essentials.kit.[name]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>\u002Fess reload\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Reloads configuration files\u003C\u002Ftd>\n\u003Ctd>Console or Operator\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>By default, server operators (\u003Ccode>\u002Fop\u003C\u002Fcode>) bypass permission checks. For standard players, use a permission plugin like \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong> to delegate command access securely.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Step 4: Create and Distribute Kits\u003C\u002Fh2>\n\u003Cp>Kits allow you to give item packages to players, such as starter gear or daily rewards. Define them under the \u003Ccode>kits\u003C\u002Fcode> section in \u003Ccode>config.yml\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-yaml\">kits:\n  welcome:\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>The \u003Ccode>delay\u003C\u002Fcode> value is measured in seconds. In this example, \u003Ccode>86400\u003C\u002Fcode> seconds equals a 24-hour cooldown before the kit can be claimed again.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ Players cannot use \u003Ccode>\u002Fspawn\u003C\u002Fcode> or \u003Ccode>\u002Fhome\u003C\u002Fcode>\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> restricts most commands for non-operators by default.\u003C\u002Fli>\n\u003Cli>Assign the \u003Ccode>essentials.spawn\u003C\u002Fcode> and \u003Ccode>essentials.home\u003C\u002Fcode> permission nodes to the target group in \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Confirm that players are properly assigned to the rank receiving the nodes.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Changes to \u003Ccode>config.yml\u003C\u002Fcode> do not take effect\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Reload the plugin configuration using \u003Ccode>\u002Fess reload\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Execute the command via the panel console or in-game if logged in as an operator.\u003C\u002Fli>\n\u003Cli>Check your YAML syntax: indentation errors prevent configuration files from loading.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Other plugins do not detect the economy engine\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Install the \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> plugin to act as an economy bridge between \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> and external plugins.\u003C\u002Fli>\n\u003Cli>Restart the server after uploading \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>Review server startup logs to ensure \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> registers \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fessentialsx.net\u002F\">EssentialsX\u003C\u002Fa>\u003C\u002Fstrong> as the economy provider.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best Practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Create Backups:\u003C\u002Fstrong> Take a full server snapshot via the \u003Cstrong>Backups\u003C\u002Fstrong> tab on your panel before performing major configuration edits.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Use Hot Reloads:\u003C\u002Fstrong> Run \u003Ccode>\u002Fess reload\u003C\u002Fcode> after modifying YAML settings rather than restarting the entire server instance.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Use Granular Permissions:\u003C\u002Fstrong> Manage access control through \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong> instead of granting full operator privileges (\u003Ccode>\u002Fop\u003C\u002Fcode>) to staff members.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Validate Setup:\u003C\u002Fstrong> Test kits, warps, and permissions in-game using a non-operator test account to verify actual player permissions.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need Assistance?\u003C\u002Fh2>\n\u003Cp>If you encounter plugin conflicts, syntax errors, or permission issues that persist after following this guide, our technical support team is ready to help.\u003C\u002Fp>\n\u003Cp>Submit a support ticket through \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\u002Flogin\">support Winheberg\u003C\u002Fa>. Our team will help you review your logs and resolve any setup problems! 🎮\u003C\u002Fp>\n",1788993142478]