Authority Admin 3.1.0

Patrol and X-ray detection. An invisible patrol mode with a working tool hotbar, ore vision, and X-ray detection that judges how players find ores rather than how many.

Spectator mode

/spectator — or the button in the panel — drops you into an invisible patrol: flying, hidden from players, with the admin hotbar equipped and block breaking disabled. Your game mode, position and flight state are saved on entry and handed back when you leave, including if you disconnect while patrolling.

A note on how this works. It does not use vanilla's spectator game mode, and it can't: a spectator's right-click is consumed by the client to attach the camera to an entity, so no interact event ever reaches the server and every hotbar tool goes dead. The mode uses adventure mode plus vanish, flight and invisibility instead. From your side it behaves like spectator; unlike spectator, clicking a player actually works.

Ore vision

A hotbar toggle that hides ordinary stone so ores stand out through the rock.

Nothing changes on the server. The blocks are rewritten on your client only, so other players see the world untouched and no block is ever modified — turning it off replays the real data. Only natural filler is hidden; ores, chests, and anything players built keep their real appearance.

ore-vision:
  radius: 16          # clamped to 4-24; the scanned volume grows with the cube of this
  mask-material: GLASS
  refresh-ticks: 30
  move-threshold: 6   # rebuild only after moving this far

X-ray detection

Counting ores catches nobody: a player who mines for eight hours out-mines a cheater who plays for one. This tracks something better.

An ore with no air touching any of its six faces cannot be seen through solid rock. A legitimate player only reaches one by tunnelling into it by chance. A player whose finds are mostly buried is not lucky — that is what X-ray looks like from the server's side.

Every mined ore is recorded with whether it was exposed. When a player's buried-find share crosses the threshold, staff with authorityadmin.mining.alerts get an in-game alert and the event is written to the audit log and optionally to Discord.

mining-analytics:
  enabled: true
  min-ores-before-alert: 12      # no verdict on a lucky first diamond
  hidden-ratio-threshold: 0.55   # 55% buried is suspicious
  hidden-ore-threshold: 8
  alert-cooldown-seconds: 300
  retention-days: 14

/minestats lists the players with the most buried finds in the last 24 hours. /minestats <player> opens a panel with the verdict, diamond counts, per-ore breakdown and a switchable time window (1 hour to 7 days). Grant authorityadmin.bypass.mining to anyone who should never be tracked.

Inventory: give as well as take

The inventory inspector could take items and delete them, but never hand anything back. Shift-click an empty slot to give the player the item you are holding. Left-click still takes, right-click still deletes, and all three are now recorded in the audit log.

The new inventory tool on the admin hotbar opens a player's inventory by right-clicking them directly, which is the point of patrolling.

New hotbar layout

The admin hotbar gained two tools: inventory inspector and ore vision. Server management and economy moved off the hotbar into the panel to make room — both are still one click away from /admin.

Also in this release

/unwarn <player> [amount] — removes a player's most recent warnings. Omit the amount to clear them all. Previously the only option was /clearwarns, which wipes the entire record: a moderator who warned the wrong person had to erase that player's whole history to fix it.
A warning button in the player panel — left-click removes the newest warning, right-click removes all, with the live count shown on the player's head.
/revoke <id> — lifts one specific punishment by the ID shown in /history.
/unbanip <ip|player> — lifts an IP ban. This was previously impossible: the method existed in the code but nothing called it, so the only way to undo an IP ban was editing the database by hand.
Fixed five broken English messages. en.yml declared the inventory: section twice, so the YAML parser silently discarded the first one. Taking, deleting or clearing items printed [Missing: inventory.item-stolen] instead of a real message in the default language.
All ten languages are complete. Every bundled locale was missing the entire report: section and the update notice; the files are now verified to cover the same 157 keys.
Staff chat from the admin-mode tool now takes the same path as /sc instead of formatting its own message.

Upgrading from 3.0.x

Drop in the new jar and restart. The aa_mining table and the new config sections are created automatically, and your existing settings are preserved.

If you customised menus.yml, the two new panel buttons (spectator, mining analytics) are merged into your file without touching what you changed.

Authority Admin