原创 工具 JxiOpGuard — UUID 管理员白名单与高危命令防护 1.0.1

JxiOpGuard · 今夕管理员防护
为 Paper 1.12.2 提供 UUID 管理员白名单、OP 扫描和高危命令防护。免费分享，无在线授权、遥测或自动下载。

功能概述​

• UUID 白名单：名字仅作备注，按 UUID 判断管理员身份；启动、加入和定期扫描非法 OP。
• 命令防护：支持精确与前缀规则、命名空间和 1.12 execute 嵌套检查；白名单增删只允许本地控制台执行。
• 可选二次认证：BCrypt 哈希、会话超时、失败锁定、连接地址白名单，以及认证前操作限制。
• 可选 LuckPerms 检查：识别在线用户当前上下文中的高危授权，按配置处理违规者。
• 异步审计：记录保护事件，隐藏本插件认证参数；配置与提示语可调整。

运行环境​

已验证：Paper 1.12.2 / Java 8。无必装前置，LuckPerms 为可选对接。其他游戏版本、核心及 Folia 尚未验证。

安装前必读​

默认管理员白名单为空，启动扫描会撤销全部现有 OP。请在首次启动前填好管理员 UUID，避免误撤自己的管理权限。

1. 停服，将 JAR 放入 plugins。
2. 创建 plugins/JxiOpGuard，把包内 config.example.yml 复制为 config.yml。
3. 编辑 security.authorized-operators，填写服务器实际识别的管理员 UUID。
4. 启动后从本地控制台执行 opguard status、opguard list、opguard scan 核对。

二次认证与 LuckPerms 检查默认关闭，需要时再按说明启用。

命令与权限​

/opguard status 查看状态
/opguard scan 立即扫描
/opguard list 查看白名单
/opguard reload 校验并重载
/opguard auth 口令 二次认证
opguard add UUID / opguard remove UUID 增删白名单，仅本地控制台。

权限为 jxiopguard.command.status、jxiopguard.command.scan、jxiopguard.command.list、jxiopguard.command.reload、jxiopguard.command.auth，默认 OP。add/remove 默认不授予，且权限节点不能绕过本地控制台检查；玩家管理指令仍检查 UUID。

配置要点​

• 二次认证只接受 BCrypt $2a$ 哈希，工作因子 04–12，推荐 10。用可信的本地工具生成，勿将正式口令提交给在线网站。
• IP 白名单按当前连接地址精确匹配。UUID 与地址依赖服务器或代理提供的可信身份信息，本插件不提供正版身份验证。
• LuckPerms 检查为只读，不会删除权限节点；普通 plugin.* 通配授权也按现有策略视为高危，启用前请核对权限配置。
• 无效配置重载会保留上一份正常保护；首次启动即配置无效时进入保护模式。

保护边界​

本插件是管理防护工具，不能隔离同一 JVM 内的恶意插件。自定义命令别名、sudo 等包装入口需自行配置；未承诺拦截所有命令方块或插件直接 API 调用。扫描撤销 OP 存在扫描间隔。

二次认证计算仍为同步路径。本插件的日志脱敏不代表核心、代理和其他插件也会隐藏认证命令。异步审计采用有界队列，过载时可能丢弃记录。

1.0.1 验证与修复​

Java 8 下 85 项测试通过，隔离 Paper 1.12.2 的 11 项运行检查通过。修正根通配权限误判、默认停服/重载命令尾参漏检，补齐认证前方块操作事件，限制 BCrypt 成本并取消初始化哈希计算，加入严格 YAML 校验。

下载与反馈​

免费发布包包含插件 JAR、配置示例、中文使用说明和第三方组件许可。反馈请在本资源讨论区附核心版本、Java 版本、脱敏配置与复现步骤；不要提交口令、真实 IP 或玩家资料。