Skip to main content

命令与监控

本页汇总 NekoAntiXray 的管理命令、权限体系、监控指标与常用操作，方便值班人员快速排障。

/nax 主命令​

子命令用途默认权限
reload重载配置与语言资源nekoantixray.reload
ban <player> [reason]执行插件内封禁流程nekoantixray.ban
replay <player>打开近实时回放 GUI / 控制界面nekoantixray.replay
resetviolation <player>清空玩家违规值nekoantixray.resetviolation
orestats <player>查看玩家矿物统计与命中率nekoantixray.orestats
oretrack <player>实时追踪玩家挖矿（GUI/Chat）nekoantixray.oretrack
announcement <...>控制公告系统（stats/announce/test 等）nekoantixray.admin
cleanup清理回放盔甲架残留nekoantixray.cleanup
realseed [world]查看真实世界种子nekoantixray.realseed
showhwid <player>输出玩家硬件指纹nekoantixray.showhwid
massexcavation ...管理大规模挖掘检测nekoantixray.massexcavation
alerts切换个人告警推送nekoantixray.alerts
internalbypass ...授予/移除临时豁免nekoantixray.admin 或自定义

/nax status、/nax secureseed status、/nax togglemassexcavation status 是日常巡检最常用的状态命令。

独立命令​

命令用途权限
/nekoantixrayupdate检查/下载在线更新nekoantixray.update
/seed向玩家展示伪造种子，OP 可查看真实值默认为空；真实种子需 fakeseed.viewreal
/fakeseedreload重载 FakeSeed 配置fakeseed.reload
/nax record <player> <start|stop> [label]采集合法/作弊样本用于 AI 训练nekoantixray.admin

玩家管控与豁免​

  • 封禁与复核：/nax ban 调用配置中的处罚链路，可包含 %player%、%vl%、%world% 等占位符；/nax resetviolation 用于人工核查后清空 VL。
  • 内部豁免：/nax internalbypass grant <player> <seconds> [reason] 为基建、录制或性能排查提供临时豁免，务必在使用结束后通过 remove/clear 收回。
  • 回放/记录：
    • record <player> <start|stop> [label]：采集挖矿序列，label 建议写 cheater|legit。
    • replay <player> + forward/backward/pause/tp：复盘玩家轨迹。

种子与安全模式​

  • /seed：普通玩家仅看到伪造值；具备 fakeseed.viewreal、nekoantixray.realseed 的人员可查看真实或安全种子。
  • /nax secureseed <status|info|generate|stats|reload|test|teststructure>：操作安全种子系统，需 nekoantixray.secureseed。
  • /nax realseed [world]：直接回读真实种子，配合安全审计使用。

公告与统计​

/nax announcement stats
/nax announcement stats history
/nax announcement announce
/nax announcement announce custom <MiniMessage>
  • stats 输出全局封禁/警告次数，可用 history 查看时间线。
  • announce custom 支持 MiniMessage，先用 test 预览格式。
  • /nax alerts 允许巡查成员单独开启/关闭告警推送。

工具与维护​

命令说明
/nax togglemassexcavation [status]查看或切换大规模挖掘检测状态，排查误报
/nax cleanup清除回放盔甲架：玩家执行仅当前世界，控制台执行全局
/nax showhwid输出玩家硬件指纹，辅助排查多号行为

权限节点速查​

权限描述默认
nekoantixray.admin获得所有 NAX 管理功能op
nekoantixray.bypass完全绕过检测（慎授）false
nekoantixray.alerts接收/切换告警提示op
nekoantixray.ban使用插件封禁命令op
nekoantixray.cleanup执行 /nax cleanupop
nekoantixray.locate.bypass不拦截 /locate 指令op
nekoantixray.massexcavation控制大规模挖掘检测op
nekoantixray.orestats查看矿物统计op
nekoantixray.oretrack启动实时追踪op
nekoantixray.realseed读取真实种子op
nekoantixray.reload重载配置op
nekoantixray.replay访问回放系统op
nekoantixray.resetviolation重置违规值op
nekoantixray.showhwid查看 HWIDop
nekoantixray.update执行在线更新op
fakeseed.reload重载 FakeSeed 配置op
fakeseed.viewreal查看真实种子op

建议利用 LuckPerms/Sponge 权限树为巡查组建立独立组，确保 nekoantixray.bypass 仅授予技术或性能排查账号。

监控与日志​

  • 控制台出现 [NekoAntiXray] 插件已启用！ 代表模块加载完成，若缺少依赖会在此阶段报错。
  • 推荐将 plugins/NekoAntiXray/logs/ 接入集中日志系统，常规运行保持 WARN 级别，需要排障时再切换 DEBUG。
  • 若启用 Prometheus 采集，可关注 nekoxray_players_flagged、chunk_time_ms、raytrace_threads_busy 等指标，遇到突增及时排查外挂或世界生成问题。