EssentialsX Permissions Setup Guide - All Commands & Groups
What is EssentialsX?
EssentialsX is the most popular Minecraft server plugin, providing essential commands for teleportation, warps, kits, homes, economy, and more. It requires a permission plugin like LuckPerms to control which players can access which commands. This guide covers every EssentialsX permission node and how to set them up correctly.
Installing EssentialsX
EssentialsX comes pre-installed on all CyberNex Minecraft servers. If you need to install it manually, download EssentialsX, EssentialsXChat, and EssentialsXSpawn from the SpigotMC website. Place all three JAR files in your plugins folder and restart your server. The first startup generates the config.yml file where you can customize all settings.
Setting Up LuckPerms (Recommended)
LuckPerms is the modern standard for Minecraft permissions. Download LuckPerms from SpigotMC, install it in your plugins folder, and restart. Use the following commands in-game or via console: /lp creategroup default, /lp creategroup vip, /lp creategroup mod, /lp creategroup admin. Then set up inheritance: /lp group default parent set default, /lp group vip parent add default, /lp group mod parent add vip, /lp group admin parent add mod.
Essential Permission Nodes
Here are the most important EssentialsX permission nodes:<ul><li><strong>essentials.home</strong> - Allow players to set and use /home (limit set in config)</li><li><strong>essentials.tpa</strong> - Allow teleport requests (/tpa, /tpahere, /tpaccept, /tpdeny)</li><li><strong>essentials.warp</strong> - Allow using warps (/warp, /warps list)</li><li><strong>essentials.kit</strong> - Allow claiming kits (/kit)</li><li><strong>essentials.spawn</strong> - Allow using /spawn</li><li><strong>essentials.balance</strong> - Allow checking balance (/balance, /bal)</li><li><strong>essentials.pay</strong> - Allow paying other players (/pay)</li><li><strong>essentials.fly</strong> - Allow toggling flight mode</li><li><strong>essentials.god</strong> - Allow god mode (admins only)</li><li><strong>essentials.msg</strong> - Allow private messaging (/msg, /r, /reply)</li><li><strong>essentials.back</strong> - Allow returning to last death location</li><li><strong>essentials.hat</strong> - Allow putting any block on your head</li></ul>
Assigning Permissions with LuckPerms
Use the following LuckPerms command syntax to assign EssentialsX permissions: /lp group default permission set essentials.home true, /lp group default permission set essentials.tpa true, /lp group vip permission set essentials.fly true, /lp group admin permission set essentials.god true. You can also use wildcards: /lp group admin permission set essentials.* true gives admins all EssentialsX permissions. Always use the most specific permission possible - avoid wildcards for non-admin groups. After setting permissions, run /lp sync to apply changes, or have affected players rejoin.
Common Permission Setups by Server Type
For SMP servers, give default players: essentials.home, essentials.tpa, essentials.spawn, essentials.balance, essentials.pay, essentials.kit, essentials.back, essentials.msg. For Factions servers, add: essentials.fly (for donators), essentials.hat, essentials.afk, essentials.sethome (multiple homes for ranks). For minigame servers, keep permissions minimal: essentials.spawn, essentials.msg, essentials.balance. Unnecessary permissions on minigame servers can lead to exploits.
Troubleshooting Permission Issues
If a player can't use a command: (1) Check /lp user <player> permission check essentials.<command> to see if they have the node. (2) Verify the command isn't disabled in essentials/config.yml. (3) Check for conflicting permissions from other plugins. (4) Ensure EssentialsX is fully loaded (no errors on startup). (5) Try /essentials reload to reload EssentialsX config. (6) If using vault, ensure Vault is installed and up to date. The most common issue is forgetting to run /lp sync after making changes.
FAQ
Related Tutorials
From the Blog
Was this guide helpful?
Join our Discord for more guides and direct help from our engineering team.