Set up EssentialsX

EssentialsX is the plugin that gives your server the commands people assume every server has: /home, /warp, /spawn, /msg, kits, and a starter economy. It's usually the single biggest quality-of-life jump you can make, and it's the second plugin most owners install (after a permissions plugin). This guide gets it running and shows you the handful of settings worth touching.

New to installing plugins? Start with Install Minecraft plugins — this guide assumes you know that flow.

1. Install it

From the Plugins page, search EssentialsX, install it, and restart. Confirm it loaded with /plugins — it should show green.

One naming quirk to know: the plugin is called EssentialsX, but its config folder on disk is /plugins/Essentials/ (no X). That's normal and correct.

🎯 Good to know: EssentialsX ships as a base plugin plus optional add-ons — EssentialsX Chat (chat prefixes/formatting), EssentialsX Spawn (spawn and join behaviour), EssentialsX AntiBuild, EssentialsX Protect, EssentialsX GeoIP, and EssentialsX Discord. Install the base first. Add an add-on only when you actually want what it does — Chat and Spawn are the two most people add.

2. The commands you just unlocked

Most of these work out of the box for everyone; a few are admin-only. This is the stable core that has worked the same way for years:

3. The config file, and what to actually change

EssentialsX's settings live in /plugins/Essentials/config.yml. It's long, but you only need a few keys to start. Open it in the File Manager editor, change these, and restart:

# Starting money for new players
starting-balance: 1000

# The symbol shown in front of money
currency-symbol: '$'

# Teleport delay in seconds (0 = instant /home, /spawn, etc.)
teleport-delay: 0

# How many homes a player without a specific permission can set
# (per-rank limits are done with permissions — see below)

Those four cover most first-day questions. Everything else in config.yml is safe to leave at its defaults until you have a reason to change it.

⚠️ Heads up: YAML cares about spacing. Indent with spaces, never tabs, and keep a value on the same line as its key (starting-balance: 1000). One stray tab and EssentialsX will refuse to load — the console tells you the line.

4. Homes, warps, and kits per rank

The number of homes a player gets isn't a single config number — it's a permission, which is why EssentialsX pairs with LuckPerms. The stable nodes:

essentials.sethome.multiple.default   # lets a rank use the "default" home limit
essentials.warp                        # use /warp
essentials.kit.<name>                  # claim a specific kit

You set the actual numbers for each named tier in config.yml under sethome-multiple:, then grant the matching permission to a rank in LuckPerms. If you haven't set ranks up yet, everyone just gets the base limit — that's fine to start.

Kits are defined in a kits: section. In current EssentialsX builds that section lives in its own file, /plugins/Essentials/kits.yml; older builds kept it inside config.yml. Check which file your install has and edit that one. A kit is a name, a cooldown, and a list of items — the file has a commented example to copy.

Verify it works

Join your server and run /sethome, walk away, then /home — you should teleport back. Run /balance and you should see your starting money. If both work, EssentialsX is live.

The honest limits

EssentialsX does a lot, but it is deliberately not everything:

• It is not a permissions plugin. It reads permissions but doesn't manage ranks. For "who is an admin, who can use /warp", you need LuckPerms.
• It is not a protection plugin. It won't stop griefing or protect regions — that's WorldGuard and CoreProtect.
• Its economy is basic — single currency, meant for simple /pay and shop use. It registers through Vault so other plugins can use it.
• Chat prefixes need EssentialsX Chat (the add-on) plus a permissions plugin — the base plugin alone won't show [Admin] in front of names.

For anything version-specific — the exact list of config keys, or a command that changed — check EssentialsX's current documentation; the details above are the parts that have stayed stable for years.

Troubleshooting

• Essentials shows red in /plugins — almost always a config.yml YAML error (a tab, or bad indentation). The console names the line; fix it and restart. See editing configs safely.
• /home says you don't have permission — a permissions plugin is denying it. Grant essentials.home to your rank in LuckPerms, or check you're an operator.
• Money commands say "economy not enabled" — install Vault so the economy registers, then restart.
• A config change didn't apply — you have to restart after editing; a reload isn't always enough for EssentialsX.

Next steps

• LuckPerms basics
• Vault and economy
• Protect regions with WorldGuard
• Editing plugin configs safely