Getting Started
Get EssentialsC running on your Paper or Folia server in a few minutes.
Requirements
Before installing, make sure your server meets the minimum requirements. EssentialsC targets modern Paper builds - legacy Spigot is not supported.
| Dependency | Version | Required |
|---|---|---|
| Paper | 1.20.6 or newer | Required |
| Folia | 1.20.6 or newer | Optional |
| Purpur | 1.20.6 or newer | Optional |
| Java | 21 or newer | Required |
| Vault | Any recent build | Optional |
| LuckPerms | Any recent build | Optional |
| PlaceholderAPI | Any recent build | Optional |
Installation
Installation is a standard plugin drop-in. No build step required.
Download the jar
Grab the latest release from Modrinth or GitHub Releases. Always prefer the Modrinth release for stable builds.
Drop it into your plugins folder
Copy EssentialsC-x.x.x.jar into your server's /plugins directory.
Start the server
Start or restart your server. EssentialsC will generate its configuration files under /plugins/EssentialsC/ on first run.
Verify it loaded
Run /plugins or check the console for the EssentialsC startup banner confirming all managers initialised correctly.
/migration essentialsx after first boot to import your player data, homes, warps, nicks, economy balances, bans, and mutes. See the Migration page for all options and flags.
Integrations
EssentialsC detects supported plugins at startup and hooks into them automatically. Simply have the plugin loaded before EssentialsC starts - in most cases no extra configuration is required. The one exception is DiscordSRV, which ships disabled by default and needs to be enabled in config.yml.
Vault
When Vault is present, EssentialsC registers itself as the economy provider. Any plugin that reads balances through Vault will automatically use EssentialsC's economy. If you have another economy plugin registered with Vault, remove it to avoid conflicts.
LuckPerms
LuckPerms is used for prefix and suffix resolution in chat formatting, tab list, and the TAB integration. Chat and tab formats are configured under the luckperms section in config.yml. EssentialsC falls back gracefully if LuckPerms is absent.
PlaceholderAPI
Installing PlaceholderAPI automatically registers the EssentialsC expansion, exposing placeholders for balance, homes, warps, nicknames, AFK state, and more. Use %essc_<placeholder>% in any PAPI-compatible plugin. See the Integrations page for the full placeholder list.
TAB
When the TAB plugin is present, EssentialsC hands player tab-list names over to TAB, applying nicknames and the AFK indicator. Without TAB, EssentialsC manages player prefixes, suffixes, and names itself via Minecraft scoreboard teams.
DiscordSRV
DiscordSRV integration forwards moderation and admin events to your Discord server. EssentialsC sends notifications for bans, IP bans, kicks, mutes, kit claims, home creation and deletion, plus shop purchases and sales (/shop, /quicksell and the /sell GUI). Enable and configure it under discordsrv in config.yml.
Floodgate
Floodgate support lets Bedrock players use EssentialsC commands and features. Bedrock players are detected automatically, and EssentialsC resolves Bedrock name prefixes so commands like /ban, /mute, and /seen target them correctly.