Skip to content

Admin UI

elitescouter edited this page Mar 28, 2026 · 2 revisions

Admin UI Panel

EliteEssentials includes a full graphical admin dashboard accessible via the /eeadmin command. The panel provides a centralized interface for server management without needing to remember individual commands.

Opening the Panel

Command: /eeadmin

Permission:

  • Simple Mode: Admin only (OP or eliteessentials.admin.*)
  • Advanced Mode: eliteessentials.admin.adminui

Panel Tabs

The admin dashboard has a sidebar with the following tabs:

Tab Description Permission Required
Dashboard Server overview with quick stats and actions eliteessentials.admin.adminui
Players Online player list with moderation actions Per-action (see below)
Bans Ban, tempban, IP ban, and unban players eliteessentials.admin.ban
Mutes Mute and unmute players eliteessentials.admin.mute
Warnings Warn players, look up warnings, clear warnings eliteessentials.admin.warn
Stats Live server statistics (players, TPS, memory, uptime) eliteessentials.admin.adminui
Activity Audit log of all admin actions eliteessentials.admin.adminui
Economy Manage player balances and view top balances eliteessentials.admin.economy
Teleports View, teleport to, and delete warps and spawns eliteessentials.admin.teleport
Player Data Look up player homes, back history, and kit claims eliteessentials.admin.playerdata

Permission Model

Opening the panel requires the eliteessentials.admin.adminui permission (or admin wildcard). However, each action within the panel checks its own permission before executing. A player with only the adminui permission can browse the panel but will see "No Permission" when clicking actions they lack permission for.

Per-Action Permissions

Action Permission
Kick player eliteessentials.admin.kick
Heal player eliteessentials.admin.heal
Freeze/unfreeze player eliteessentials.admin.freeze
Teleport to/from player eliteessentials.admin.teleport
Ban/tempban/IP ban/unban eliteessentials.admin.ban
Mute/unmute eliteessentials.admin.mute
Warn/clear warnings eliteessentials.admin.warn
Economy management eliteessentials.admin.economy
Teleport to warps/spawns, delete warps/spawns eliteessentials.admin.teleport
View/manage player data (homes, back, kits) eliteessentials.admin.playerdata

The eliteessentials.admin.* wildcard bypasses all individual checks.

Dashboard Tab

The dashboard shows a quick overview of the server:

  • Online player count
  • Server TPS (ticks per second)
  • Memory usage (used / allocated)
  • Server uptime
  • Active bans, mutes, frozen players, warps, and kits count

Quick action buttons let you jump directly to the Players, Bans, or Stats tabs, or reload the plugin configuration.

Players Tab

Lists all online players with a clickable select button. After selecting a player, you can see their info (health, location, status) and perform actions:

  • Teleport To - Teleport yourself to the selected player
  • Teleport Here - Teleport the selected player to you
  • Heal - Restore the player's health
  • Freeze - Toggle freeze on the player (prevents movement)
  • Kick - Disconnect the player from the server
  • UUID Link - View the player's UUID

You can also look up offline players by typing their name in the lookup field.

Bans Tab

Manage all ban types from a single interface:

  • Ban - Permanently ban a player (enter name and optional reason)
  • Temp Ban - Temporarily ban a player (enter name, duration like 30m, 2h, 7d, and optional reason)
  • IP Ban - Ban a player's IP address
  • Unban - Remove a ban by player name

The tab also shows a list of all currently active bans (permanent, temporary, and IP bans) with details.

Mutes Tab

  • Mute - Mute a player with an optional reason
  • Unmute - Remove a mute by player name

Shows a list of all currently muted players with who muted them and when.

Warnings Tab

  • Warn - Add a warning to a player with an optional reason
  • Lookup - View all warnings for a specific player
  • Clear Warnings - Remove all warnings for a player

If warn.autoPunishThreshold is configured, warnings issued through the UI also trigger automatic punishment when the threshold is reached.

Stats Tab

Displays live server statistics:

  • Players online
  • Server TPS
  • Memory used / allocated
  • Free memory
  • Server uptime
  • Java version and OS info

Click Refresh to update the stats.

Activity Tab

Shows a chronological audit log of admin actions performed through both the UI and chat commands. Actions logged include:

  • Bans, tempbans, IP bans, unbans
  • Mutes, unmutes
  • Warns, clear warnings
  • Kicks
  • Freezes, unfreezes
  • Economy changes (set, add, remove balance)
  • Warp/spawn deletions
  • Player data changes (clear back history, reset kits, delete homes)

Each entry shows the action type, admin who performed it, target player, details, and timestamp.

Filter buttons let you view all actions or filter by type (bans, mutes, warns, kicks, economy).

Activity log data is stored in activity_log.json (or the ee_activity_log SQL table when using SQL storage). A maximum of 200 entries are kept.

Economy Tab

Requires the economy system to be enabled in config.

  • Check - View a player's current balance
  • Set - Set a player's balance to a specific amount
  • Add - Add money to a player's balance
  • Remove - Remove money from a player's balance

Also displays:

  • Total server economy (sum of all balances)
  • Average balance
  • Total players with balance data
  • Top 10 richest players leaderboard

Teleports Tab

View and manage all warps and spawn points:

  • Warps list showing name, coordinates, world, and permission level (ALL/OP)
  • Spawns list showing name, coordinates, world, and primary status
  • GO button to teleport yourself to any warp or spawn
  • DEL button to delete a warp or spawn

Player Data Tab

Look up detailed data for any player (online or offline):

  • Player name, home count, back history count, kit claims count
  • Full list of homes with coordinates, world, and buttons to teleport to or delete each home
  • Back location history with coordinates and teleport buttons
  • Clear Back History button to wipe a player's back locations
  • Reset Kits button to clear all kit claims and cooldowns for the player

Configuration

The admin UI is always available (no config toggle). Access is controlled entirely through permissions.

All text labels in the admin UI are translatable through messages.json using keys prefixed with adminui. (e.g., adminui.dashboard.title, adminui.players.kick, etc.).

Notes

  • The admin UI does not check the config "enabled" flag for features (e.g., ban.enabled). If a player has the permission, the action works regardless of the config toggle. This differs from chat commands which respect the enabled flag.
  • All moderation actions performed through the UI are logged to the activity log, just like chat commands.
  • The UI closes automatically when you teleport to a location (warps, spawns, homes, back locations).

See Also

Clone this wiki locally