
Authority Admin
一套专为 Paper 服务器打造的完整管理与审查套件,围绕单一控制面板构建,而非依赖需要记忆的命令列表。
所有审查操作——封禁、静音、警告、冻结、物品栏检查、经济系统管理、举报处理——均可通过一个图形界面(GUI)访问,同时它们也作为标准命令供偏好键入指令的管理员使用。处罚数据存储在 SQLite 或 MySQL 中,异步应用,并缓存在内存中,以确保权限检查在关键路径上永远不会直接触及数据库。
控制面板
/admin 打开主面板:显示实时 TPS、内存和玩家数量、待处理举报数量,并可一键进入各个子系统。
从这里,管理员可以访问十四个屏幕,包括:
- 玩家管理 — 浏览在线玩家,打开任意玩家的行动面板
- 玩家操作 — 对单个目标执行 24 种操作:封禁、临时封禁、踢出、IP 封禁、静音、临时静音、警告、查看物品栏、末影箱、统计信息、药水效果、冻结、治疗、传送、拉取、飞行、给予物品、经济管理、处罚历史、解封、解除静音
- 服务器管理 — 时间、天气、实体清理、广播、控制台命令
- 举报 — 处理玩家举报,关闭或驳回举报
- 处罚历史 — 分页显示,按玩家分类
- 在线管理员 — 当前在岗人员
- 管理员审计日志 — 记录团队的所有操作
该面板并非命令的简单包装器。需要输入的操作(如理由、持续时间、广播内容)会在聊天窗口中提示,并在完成后返回原位。
处罚系统
| 类型 |
永久 |
临时 |
| 封禁 |
/ban |
/tempban |
| 静音 |
/mute |
/tempmute |
| IP 封禁 |
/ipban |
— |
| 警告 |
/warn |
— |
| 踢出 |
/kick |
— |
持续时间支持 30s、10m、2h、7d、1w、1mo。每次处罚都会记录执行的管理员、理由、时间戳和过期时间,即使过期后仍可通过 /history 查询。
自动升级。 警告可在配置的阈值触发命令:
settings:
max-warnings: 3
warn-actions:
3: "tempban {player} 1d Accumulated {count} warnings"
绕过权限。 authorityadmin.bypass.ban、.kick、.mute 和 .freeze 可保护特定玩家免受惩罚,而 respect-permission-hierarchy 会阻止管理员惩罚比自己权限更高的玩家。
管理员工具
- 管理员模式 —
/adminmode 将你的快捷栏替换为九个工具(玩家查找、隐身、冻结、动作工具、物品栏检查、矿石视觉、举报、员工聊天、退出),离开时恢复你原有的物品
- 旁观者模式 —
/spectator 进行隐形巡逻:飞行、隐藏、无法破坏方块,但快捷栏实时更新。右键点击一名玩家即可当场打开其物品栏。退出后,你的游戏模式和位置都会恢复,即使是在断线之后也是如此
- 隐身 — 支持配置假的加入和离开消息,并设有单独的权限,控制哪些人仍然能看到你
- 冻结 — 阻止移动和执行命令,同时提供命令白名单,使被冻结的玩家仍可使用
/report
- 员工聊天 —
/sc,或面板按钮
- 举报 — 玩家通过
/report 提交举报,工作人员在专用图形界面中进行处理
矿石视觉与透视检测
矿石视觉 会隐藏普通石头,使矿石在岩石中更加突出。服务器端没有任何变化:方块仅在管理员客户端进行重写,因此其他玩家看到的依然是未经修改的世界,且不会有任何方块被实际更改。
X 射线检测判断玩家如何发现矿石,而非数量。单纯统计矿石数量毫无意义——一名挖掘八小时的玩家所获得的资源远超仅游玩一小时的作弊者。由于任何一面均无空气接触的矿石无法透过实心岩石被看见,因此合法玩家只能通过偶然挖掘才能触及此类矿石。若玩家的发现物大多处于埋藏状态,则并非运气不佳。
每枚被开采的矿石都会记录其是否暴露。一旦超过阈值,工作人员将收到游戏内警报、审计日志条目,以及可选的 Discord 消息。
/minestats 按埋藏发现量对过去 24 小时进行排名。/minestats <player> 打开一个面板,显示裁决结果、钻石数量、各矿石细分数据,以及可在 1 小时至 7 天之间切换的时间窗口。authorityadmin.bypass.mining 权限可豁免那些本不应被追踪的玩家。
工作人员审计日志
通过面板执行的所有操作都会被记录:控制台命令、广播、物品栏与末影箱访问、余额变动、物品发放、传送、治疗、飞行开关、药水效果、冻结、隐身、世界控制、实体清理及惩罚。
可通过 /stafflog [staff] [page] 或从面板中查看。条目会在可配置的保留期后自动裁剪。
控制台命令在执行之前写入日志,因此即使某条命令导致服务器停止,记录依然得以保留。
跨服务器支持
将多个服务器指向同一个 MySQL 数据库并启用同步功能。在大厅服务器(lobby)上发布的封禁将在数秒内生效于生存模式,而解封也会在所有服务器上立即清除。
database:
type: mysql
sync:
enabled: true
poll-interval: 5
每个服务器通过 server-id 标识自身,该 ID 同时用于审计日志中标记其条目。同步功能默认关闭;单服务器设置无需进行任何配置。
自定义
菜单。 管理面板和服务器面板的定义位于 menus.yml。你可以移动按钮、更改图标、重写文本、通过权限限制某个按钮或移除它——无需重新编译。按钮携带的是命名操作而非槽位编号,并且像 {tps}、{online}、{memory_percent} 和 {open_reports} 这样的动态值可以在任何标题、名称或描述中使用。
语言。 插件自带十种翻译:英语、西班牙语、葡萄牙语(巴西)、德语、法语、简体中文、俄语、日语、韩语和意大利语。启用 auto-locale 即可为每位玩家提供其客户端对应的语言。自定义文件可放入 lang/ 目录中。
格式化。 所有文本均使用 MiniMessage,因此渐变、悬停提示和 RGB 颜色可在任何地方生效。
配置升级。 来自未来版本的新选项会自动合并到现有的 config.yml 和语言文件中,而不会覆盖您所做的任何更改。
集成支持
| 插件 |
添加的功能 |
| Vault |
通过面板进行经济管理 |
| PlaceholderAPI |
为计分板和聊天提供八个占位符 |
| LiteBans |
读取现有的处罚数据 |
| EssentialsX / FroskyVanish |
隐身状态共享而非冲突 |
| Discord |
Webhook 日志记录,按事件开启/关闭开关 |
占位符:%authorityadmin_is_banned%、is_muted、is_frozen、is_vanished、is_adminmode、ban_reason、ban_staff、economy_balance。
命令
| 命令 |
别名 |
权限节点 |
/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 |
权限节点
authorityadmin.* 授予所有权限。独立的节点与上述命令名称匹配,此外还包括:
| 节点 |
授予的权限 |
authorityadmin.vanish.see |
查看隐身玩家 |
authorityadmin.inventory |
查看和编辑玩家物品栏 |
authorityadmin.potion |
施加药水效果 |
authorityadmin.economy |
管理余额 |
authorityadmin.server |
服务器管理面板 |
authorityadmin.give |
通过面板给予物品 |
authorityadmin.stafflog |
读取审计日志 |
authorityadmin.spectator |
使用隐形巡逻模式 |
authorityadmin.orevision |
透过固体方块查看矿石 |
authorityadmin.minestats |
查看挖矿活动和 X 射线分析 |
authorityadmin.mining.alerts |
接收游戏内 X 射线警报 |
authorityadmin.reload |
重新加载配置 |
authorityadmin.keepinventory |
死亡时保留物品栏和经验值 |
authorityadmin.bypass.ban |
无法被禁封 |
authorityadmin.bypass.kick |
无法被踢出 |
authorityadmin.bypass.mute |
无法被静音 |
authorityadmin.bypass.freeze |
无法被冻结 |
authorityadmin.bypass.mining |
挖矿行为永远不会被追踪或标记 |
authorityadmin.report 默认为 true,以便玩家可以举报。其他所有权限默认仅对操作员(OP)开放。
要求
- Paper 1.21.4 或更高版本,或者 Paper 分支如 Purpur 或 Pufferfish。不支持 Spigot —— 该插件使用了 Paper 的 Adventure API 和玩家 API。
- Java 21 或更高版本
- 可选:Vault、PlaceholderAPI
已在单个构建版本中测试从 1.21.4 到 26.2 的范围。
安装
- 将 jar 文件放入
plugins/ 目录并重启服务器。
- 如果需要 MySQL、不同的语言或不同的警告阈值,请编辑
plugins/AuthorityAdmin/config.yml。SQLite 无需任何配置即可工作。
- 将
authorityadmin.* 授予你的工作人员等级,或使用独立节点以实现更精细的控制。
从早期版本升级只需直接替换文件:新表、配置部分和语言键会自动创建,且您的现有设置将被保留。

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
- Drop the jar into
plugins/ and restart.
- Edit
plugins/AuthorityAdmin/config.yml if you want MySQL, a different language, or
different warning thresholds. SQLite works with no configuration at all.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧