Essentials config.yml
Main settings
Reloaded with /essentials reload
| Key | Setting | Type | Allowed | Default |
|---|---|---|---|---|
| debug | Debug Extra output in the console to diagnose problems. advanced |
boolean | ||
| auto-afk AFK |
Auto AFK after Seconds of inactivity before a player is marked AFK. 0 disables it. |
integer | 0 – 86400 | |
| near-radius Teleport |
/near radius Default radius in blocks for /near. |
integer | 1 – 100000 | |
| heal-cooldown | Heal cooldown Seconds between uses of /heal. |
integer | 0 – 86400 | |
| ops-name-color Nicknames |
Operator name color Color code for operator names in chat, for example 4 for dark red. Use none to disable. |
string | up to 8 characters | |
| spawnmob-limit | /spawnmob limit Most mobs one /spawnmob can create. |
integer | 1 – 1000 | |
| teleport-delay Teleport |
Teleport delay Warm-up before the teleport happens. Moving cancels it. |
integer | float | 0 – 3600 | 0 |
| backup.interval | Backup interval (minutes) How often the backup command runs. 0 disables it. advanced |
integer | 0 – … | |
| max-nick-length Nicknames |
Max nickname length Longest nickname players can set with /nick. |
integer | 1 – 64 | |
| nickname-prefix Nicknames |
Nickname prefix Shown before nicknames so players can tell them apart from real usernames. |
string | up to 16 characters | |
| teleport-safety Teleport |
Teleport safety Move players to a safe spot if the destination is dangerous. |
boolean | true | |
| auto-afk-timeout AFK |
Kick AFK players after Seconds of inactivity before an AFK player is kicked. -1 disables it. |
integer | -1 – 86400 | |
| per-player-locale | Per-player language Show Essentials messages in each player's client language when a translation exists. |
boolean | ||
| teleport-cooldown Teleport |
Teleport cooldown Seconds a player must wait between /home, /tpa and similar commands.? |
integer | float | 0 – 86400 | 0 |
| allowed-nicks-regex Nicknames |
Allowed nickname pattern Regular expression a nickname must match. advanced |
string | ||
| item-spawn-blacklist | Blocked items for /item and /give Comma-separated item names players can't spawn, for example lava_bucket,tnt. |
— | ||
| message-colors.primary Chat |
Primary message color Main color of Essentials messages (hex like #ffaa00 or a color name). |
string | ||
| message-colors.secondary Chat |
Secondary message color Highlight color of Essentials messages. |
string | ||
| teleport-invulnerability Teleport |
Invulnerability after teleport Seconds players can't take damage after teleporting. 0 disables it. |
integer | float | 0 – 600 |
Keys with * match several settings (for example every kit). Paths use dots between levels.