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

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

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

Commands

Permissions

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

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.