Skip to main content

NekoAntiXray 介绍

适用版本：Folia / Paper 1.20+（构建目标 1.21.10），Java 17，需搭配 ProtocolLib。

NekoAntiXray（简称 NAX）是 NekoSoft 推出的主动式反矿透方案，结合 Algo 行为分析、传统假矿钓鱼与 HeavyMode 射线隐藏，并内置 Seed 防护、公告、回放等治理工具，帮助服务器在高并发环境下维持公平矿物生态。

核心特性​

  • 混合检测链路：AlgoAntiXray / MinerTrack 对挖矿路径聚类，传统 check.xray 负责诱导验证，HeavyMode 在底层控制可见方块，三者可按场景自由组合。
  • 假矿 + 行为回放：自动生成诱饵矿石并记录玩家破坏路径，可通过 /nax replay 回看、/nax orestats 统计矿脉命中率，为人工复核提供证据。
  • 深度学习实验模块：可加载自训练 model.onnx 与 feature_stats.json，对玩家挖矿序列进行 AI 评分，并按配置映射为 VL。
  • 多层种子保护：fake-seed 伪造 /seed 输出，secure-seed 与 antiSeedCracker 修改末地结构与响应，阻断 Seed 破解与定位。
  • 周边治理能力：公告系统、违规统计、反大规模挖掘确认、回放盔甲架清理、HWID / real seed 查询等辅助功能贯穿巡查流程。
  • 高性能实现：面向 Folia/Paper 的异步补丁、多线程射线追踪与缓存使得在 200+ 在线场景依旧保持稳定 TPS。

支持平台与要求​

组件要求
Minecraft1.20+（Folia / Paper 推荐，兼容 Spigot 系列）
Java17（与 Folia 1.21.10 构建兼容）
依赖ProtocolLib，Maven 3.9+（打包时）
硬件至少 8 GB 可用内存，SSD 以支撑回放与日志

若启用 HeavyMode、深度学习或海量假矿，建议额外预留 2C4G 以上资源。

工作原理概览​

  1. 假矿钓鱼：在可疑玩家附近生成诱饵矿石，通过其命中率给出基础 VL。
  2. Algo/MinerTrack：聚类玩家挖矿路径，分析转向次数、矿脉连续性、空气比例等指标判断是否“精准挖矿”。
  3. HeavyMode：多线程射线追踪隐藏真实矿石，玩家必须破坏周边方块才可观察矿脉，进一步降低透视收益。
  4. 种子与定位防护：拦截 /seed、扰动末地结构数据，并可在 /nax realseed 等命令下由可信角色读取真实值。
  5. 告警与回放：违规链路通过命令映射触发公告、封禁或回放采集，形成闭环治理。

快速上手流程​

  1. 构建或下载插件：git clone 后执行 mvn clean package，获取 target/NekoAntiXray-<version>.jar（及 target/libs/ 依赖）。
  2. 部署与初始化：将 Jar 与依赖复制至服务器 plugins/，首次启动生成 config.yml，填入后台获得的 api-key。
  3. 选择检测策略：
    • 轻量：关闭 check.AlgoAntiXray，只保留 check.xray。
    • 行为分析：开启 check.AlgoAntiXray，可视情况关闭传统检测避免重复处罚。
    • 全量：三种检测 + HeavyMode + deeplearn，用于大型或高风险服务器。
  4. 配置检测范围：在 check.AlgoAntiXray.worlds、blacklist.worlds、antiBrightness.enabledWorlds 指明开启/豁免世界。
  5. 下发权限：巡查组授予 nekoantixray.alerts、nekoantixray.oretrack、nekoantixray.replay 等节点，普通玩家保持默认。
  6. 监控效果：通过 /nax orestats <player>、/nax replay <player>、/nax announcement 等命令观察实时输出。

支持与资源​

文档会随版本迭代更新，若升级 Folia / Paper 主版本，请及时查看 Release Notes 并调优配置。*** End Patch