-
Notifications
You must be signed in to change notification settings - Fork 0
Permissions Reference
Staff permissions are granular and per-feature. ADMIN has all of them implicitly; STAFF accounts get only what you grant on the Staff page; DEMO gets a read-only subset and is additionally blocked from all non-GET requests.
| Permission | Unlocks | Page |
|---|---|---|
PLAYERS_VIEW |
Browse the player list & profiles | [[Players |
PLAYERS_MANAGE |
Edit players (balance, nickname, homes, mail, gamemode, teleport, etc.) | [[Players |
ECONOMY_VIEW |
View baltop & economy stats | [[Economy |
ECONOMY_MANAGE |
Bulk give/take and balance changes | [[Economy |
ECONOMY_LOG_VIEW |
View the transaction ledger | [[Economy |
BANS_VIEW |
View bans & mutes lists | [[Bans, Mutes & Warnings |
BANS_MANAGE |
Ban/unban/mute/unmute/warn; edit templates & escalation | [[Bans, Mutes & Warnings |
KITS_VIEW |
View kits | [[Kits & Warps |
KITS_MANAGE |
Create/edit/delete kits | [[Kits & Warps |
WARPS_VIEW |
View warps | [[Kits & Warps |
WARPS_MANAGE |
Create/edit/delete warps; teleport to a warp | [[Kits & Warps |
MAIL_MANAGE |
Send player mail and mail-all | [[Players |
INVENTORY_VIEW |
View player inventory/ender chest | [[Players |
INVENTORY_MANAGE |
Edit inventory slots | [[Players |
CONSOLE_VIEW |
Watch live console output | [[Live Console |
CONSOLE_EXECUTE |
Run commands from the console | [[Live Console |
CONFIG_VIEW |
View the EssentialsX config | [[Configuration |
CONFIG_MANAGE |
Edit the EssentialsX config | Config page |
SERVER_MANAGE |
Whitelist, worlds, save/stop, spawn, jails | [[Server Controls |
MODULES_VIEW |
View module status | [[EssentialsX Modules |
MODULES_MANAGE |
Edit Chat/Protect/Discord configs | [[EssentialsX Modules |
SCHEDULER_VIEW |
View scheduled tasks | [[Scheduler |
SCHEDULER_MANAGE |
Create/edit/delete & run tasks | [[Scheduler |
CHAT_VIEW |
View live chat & history | [[Chat Moderation |
CHAT_MODERATE |
Delete chat lines & act on players | [[Chat Moderation |
BROADCAST |
Send broadcasts | [[Broadcast & Mail |
AUDIT_LOG |
View the audit log | [[Audit Log |
27 permissions in total.
The Overview, Analytics and Security pages are available to any logged-in user regardless of permissions.
These require the ADMIN role and ignore staff permissions:
Staff & Permissions, Branding, and the
moderation-settings page (/moderation). The read-only DEMO account may also view these three
pages for evaluation (see below); regular STAFF cannot.
DEMO is a showcase role designed to let prospective users see almost the entire panel while being
strictly read-only — JwtMiddleware blocks every non-GET request for demo accounts, so nothing can
be created, edited, executed or deleted no matter what is granted.
Demo accounts automatically receive view access to every standard feature page:
PLAYERS_VIEW, INVENTORY_VIEW, ECONOMY_VIEW, ECONOMY_LOG_VIEW,
BANS_VIEW, KITS_VIEW, WARPS_VIEW, CONSOLE_VIEW, CHAT_VIEW,
CONFIG_VIEW, MODULES_VIEW, SCHEDULER_VIEW, AUDIT_LOG,
SERVER_MANAGE, BROADCAST, MAIL_MANAGE, BANS_MANAGE
The four *_MANAGE/BROADCAST entries are included only because those pages (Server Controls, Tools,
Moderation settings, and ban actions) have no separate "view" permission — they unlock viewing
only; the actual write requests are still blocked. Execute-type permissions like CONSOLE_EXECUTE,
PLAYERS_MANAGE, CONFIG_MANAGE, KITS_MANAGE, etc. are deliberately not granted.
For demo viewers, IP addresses are masked everywhere they would otherwise appear — player
profiles, GeoIP, login timeline, alt-account detection, active sessions, the audit log, and the live
console stream. Each address is replaced with a stable, non-reversible token (e.g. ip#a1b2c3), so
correlations still demonstrate value (two accounts sharing an IP map to the same token) without
revealing the real address. GeoIP country/city is still shown.
EssentialsX Dashboard v1.1.0 · GitHub · Web control panel for EssentialsX
Getting Started
Features
- Dashboard & Analytics
- Players
- Economy
- Bans, Mutes & Warnings
- Chat Moderation
- Kits & Warps
- Live Console
- Server Controls
- EssentialsX Modules
- Scheduler
- Broadcast & Mail
Administration
Reference