!Banner

Authority Admin

A complete moderation and administration suite for Paper servers, built around a single control panel instead of a list of commands to memorise.

Every moderation action — bans, mutes, warnings, freezes, inventory inspection, economy, reports — is reachable from one GUI, and every one of them is also a proper command for staff who prefer typing. Punishments are stored in SQLite or MySQL, applied asynchronously, and cached in memory so permission checks never touch the database on the hot path.

---

The control panel

/admin opens the root panel: live TPS, memory and player counts, the open report count, and one click into every subsystem.

From there staff reach fourteen screens, including:

• Player management — browse online players, open any player's action panel
• Player actions — 24 operations on a single target: ban, tempban, kick, IP ban, mute, tempmute, warn, inventory, enderchest, stats, potion effects, freeze, heal, teleport, bring, flight, give items, economy, punishment history, unban, unmute
• Server management — time, weather, entity cleanup, broadcasts, console commands
• Reports — triage player reports, close or dismiss them
• Punishment history — paginated, per player
• Online staff — who is on duty right now
• Staff audit log — everything your team has done

The panel is not a wrapper around commands. Actions that need input (a reason, a duration, a broadcast) prompt in chat and return you to where you were.

Punishments

Type	Permanent	Temporary
Ban	/ban	/tempban
Mute	/mute	/tempmute
IP ban	/ipban	—
Warning	/warn	—
Kick	/kick	—

Durations accept 30s, 10m, 2h, 7d, 1w, 1mo. Every punishment records the staff member, reason, timestamp and expiry, and stays queryable through /history long after it expires.

Automatic escalation. Warnings can trigger a command at a configurable threshold:

settings:
  max-warnings: 3
  warn-actions:
    3: "tempban {player} 1d Accumulated {count} warnings"

Bypass permissions. authorityadmin.bypass.ban, .kick, .mute and .freeze protect specific players, and respect-permission-hierarchy stops staff from punishing anyone above them.

Staff tools

• Admin mode — /adminmode swaps your hotbar for nine tools (player finder, vanish, freeze, action tool, inventory inspector, ore vision, reports, staff chat, exit) and restores your original items when you leave
• Spectator mode — /spectator patrols invisibly: flying, hidden, block breaking off, hotbar live. Right-click a player to open their inventory on the spot. Your game mode and position are restored on exit, even after a disconnect
• Vanish — with configurable fake join and leave messages, and a separate permission for who can still see you
• Freeze — blocks movement and commands, with a command whitelist so a frozen player can still use /report
• Staff chat — /sc, or the panel button
• Reports — players submit with /report, staff triage in a dedicated GUI

Ore vision and X-ray detection

Ore vision hides ordinary stone so ores stand out through rock. Nothing changes on the server: the blocks are rewritten on the staff member's client only, so other players see the world untouched and no block is ever modified.

X-ray detection judges how players find ores, not how many. Counting ores catches nobody — a player who mines for eight hours out-mines a cheater who plays for one. An ore with no air touching any of its six faces cannot be seen through solid rock, so a legitimate player only reaches one by tunnelling into it by chance. A player whose finds are mostly buried is not lucky.

Every mined ore is stored with whether it was exposed. Cross the threshold and staff get an in-game alert, an audit log entry and optionally a Discord message.

/minestats ranks the last 24 hours by buried finds. /minestats <player> opens a panel with the verdict, diamond counts, a per-ore breakdown and a switchable window from one hour to seven days. authorityadmin.bypass.mining exempts anyone who should never be tracked.

Staff audit log

Every action taken through the panel is recorded: console commands, broadcasts, inventory and enderchest access, balance changes, item grants, teleports, heals, flight toggles, potion effects, freezes, vanish, world control, entity purges and punishments.

Read it with /stafflog [staff] [page] or from the panel. Entries are trimmed automatically after a configurable retention window.

Console commands are written to the log before they execute, so the record survives a command that stops the server.

Cross-server support

Point several servers at one MySQL database and enable sync. A ban issued on the lobby applies on survival within seconds, and an unban clears everywhere.

database:
  type: mysql
  sync:
    enabled: true
    poll-interval: 5

Each server identifies itself through server-id, which also labels its entries in the audit log. Sync is off by default; single-server setups need no configuration.

Customisation

Menus. The admin panel and server panel are defined in menus.yml. Move buttons, change icons, rewrite text, restrict a button with a permission, or remove it — no recompiling. Buttons carry named actions rather than slot numbers, and live values like {tps}, {online}, {memory_percent} and {open_reports} work in any title, name or lore.

Languages. Ten translations ship with the plugin: English, Spanish, Portuguese (BR), German, French, Chinese (Simplified), Russian, Japanese, Korean and Italian. Enable auto-locale to serve each player their own client language. Custom files drop into lang/.

Formatting. All text is MiniMessage, so gradients, hover text and RGB work everywhere.

Config upgrades. New options from future versions are merged into your existing config.yml and language files automatically, without overwriting anything you changed.

Integrations

Plugin	What it adds
Vault	Economy management from the panel
PlaceholderAPI	Eight placeholders for scoreboards and chat
LiteBans	Reads existing punishment data
EssentialsX / FroskyVanish	Vanish state is shared instead of fought over
Discord	Webhook logging, per-event toggles

Placeholders: %authorityadmin_is_banned%, is_muted, is_frozen, is_vanished, is_adminmode, ban_reason, ban_staff, economy_balance.

Commands

Command	Aliases	Permission
/admin [reload]	aa, authorityadmin	authorityadmin.admin
/adminmode	am, amode	authorityadmin.adminmode
/ban <player> [reason]	pban, permban	authorityadmin.ban
/tempban <player> <duration> [reason]	tb	authorityadmin.tempban
/unban <player>	pardon	authorityadmin.unban
/ipban <player|ip> [reason]	banip	authorityadmin.ipban
/kick <player> [reason]	—	authorityadmin.kick
/mute <player> [reason]	silence	authorityadmin.mute
/tempmute <player> <duration> [reason]	tm	authorityadmin.tempmute
/unmute <player>	—	authorityadmin.unmute
/unbanip <player|ip>	unipban, pardonip	authorityadmin.unbanip
/warn <player> [reason]	—	authorityadmin.warn
/unwarn <player> [amount]	removewarn, delwarn	authorityadmin.unwarn
/clearwarns <player>	cw	authorityadmin.clearwarns
/revoke <id>	unpunish	authorityadmin.revoke
/history <player>	punishments, ph	authorityadmin.history
/freeze <player>	ss	authorityadmin.freeze
/vanish	v, invisible	authorityadmin.vanish
/spectator	spec, patrol	authorityadmin.spectator
/minestats [player]	xray, oremeter	authorityadmin.minestats
/sc <message>	staffchat, staff	authorityadmin.staffchat
/report <player> <reason>	—	authorityadmin.report
/reports	reportlist, rp	authorityadmin.reports
/stafflog [staff] [page]	auditlog, salog	authorityadmin.stafflog

Permissions

authorityadmin.* grants everything. Individual nodes match the command names above, plus:

Node	Grants
authorityadmin.vanish.see	See vanished players
authorityadmin.inventory	View and edit player inventories
authorityadmin.potion	Apply potion effects
authorityadmin.economy	Manage balances
authorityadmin.server	Server management panel
authorityadmin.give	Give items through the panel
authorityadmin.stafflog	Read the audit log
authorityadmin.spectator	Use invisible patrol mode
authorityadmin.orevision	See ores through solid blocks
authorityadmin.minestats	View mining activity and X-ray analysis
authorityadmin.mining.alerts	Receive in-game X-ray alerts
authorityadmin.reload	Reload configuration
authorityadmin.keepinventory	Keep inventory and XP on death
authorityadmin.bypass.ban	Cannot be banned
authorityadmin.bypass.kick	Cannot be kicked
authorityadmin.bypass.mute	Cannot be muted
authorityadmin.bypass.freeze	Cannot be frozen
authorityadmin.bypass.mining	Mining is never tracked or flagged

authorityadmin.report defaults to true so players can report. Everything else defaults to operators.

Requirements

• Paper 1.21.4 or newer, or a Paper fork such as Purpur or Pufferfish. Spigot is not supported — the plugin uses Paper's Adventure and player APIs.
• Java 21 or newer
• Optional: Vault, PlaceholderAPI

Tested from 1.21.4 through 26.2 on a single build.

Installation

1. Drop the jar into plugins/ and restart.
2. Edit plugins/AuthorityAdmin/config.yml if you want MySQL, a different language, or different warning thresholds. SQLite works with no configuration at all.
3. Grant authorityadmin.* to your staff rank, or individual nodes for finer control.

Upgrading from an earlier version is a drop-in replacement: new tables, config sections and language keys are created automatically and your existing settings are preserved.