Skip to main content

NekoAntiXray 用户手册

中文用户指南 - 服务器管理员快速上手

目录​

  1. 快速开始
  2. 检测系统说明
  3. 配置指南
  4. 命令参考
  5. 常见问题

快速开始​

安装要求​

  • 服务端: Paper 1.21.10+ 或 Folia 1.20.6+
  • Java: Java 17 或更高版本
  • 前置插件: ProtocolLib 5.3.0+

安装步骤​

  1. 下载插件

    • 下载 NekoAntiXray-AllPlatform-2.1.1.jar

  2. 安装前置插件

  3. 安装本插件

    • 将 NekoAntiXray-AllPlatform-2.1.1.jar 放入 plugins/ 目录

  4. 启动服务器

    • 启动服务器
    • 插件将在 plugins/NekoAntiXray/ 生成配置文件

  5. 配置 (可选)

    • 编辑 plugins/NekoAntiXray/config.yml
    • 使用 /nax reload 重载配置

检测系统说明​

检测层级​

NekoAntiXray 使用多层检测系统，可独立启用/禁用：

层级系统名称检测方式推荐配置
1AlgoAntiXray挖矿行为模式分析开启
2XRayCheck假矿石陷阱检测开启其一
3Enhanced数据包修改隐藏矿石配合Paper反矿透
4DeepLearnAI深度学习检测可选

工作原理​

AlgoAntiXray (行为分析)​

  • 追踪玩家挖矿路径
  • 分析矿脉聚类模式
  • 检测可疑行为特征（频繁转向、直线穿矿）
  • 在自然环境（洞穴、水域）中降低误报

XRayCheck (假矿石)​

  • 当玩家连续挖矿时，在周围生成隐形假矿石
  • 监控玩家是否挖掘了这些假矿石
  • 正常玩家不会看到假矿石，作弊玩家会直奔假矿

Enhanced (数据包修改)​

  • 拦截区块数据包
  • 通过射线追踪计算矿石可见性
  • 隐藏不可见的矿石

配置指南​

推荐配置模板​

生存服 (严格模式)​

check:
  mining-behavior-analyzer:
    active: true
    environment-filters:
      apply-filters: true
      cave:
        reduce-vl: true
    violation-system:
      auto-decay:
        enabled: true
        interval-minutes: 3
        amount: 1
      threshold-commands:
        10: 'say %player% 触发初级检测'
        20: 'say %player% 触发中级检测'
        30:
          - 'kick %player% 检测到异常挖矿'

  xray:
    enable: true
    vl:
      ban:
        enable: true
        threshold: 10.0

生电服 (宽松模式)​

check:
  mining-behavior-analyzer:
    active: true
    pattern-analyzer:
      turning-limit: 15
      branching-limit: 10
      y-shift-limit: 6
    environment-filters:
      apply-filters: true

  xray:
    enable: false
    mass-excavation:
      enabled: true
      block-count-threshold: 80

世界配置​

check:
  mining-behavior-analyzer:
    world-configs:
      world:           { enabled: true, y-limit: 32 }
      world_nether:    { enabled: true, y-limit: 128 }
      world_the_end:   { enabled: false, y-limit: -1 }
      _default:        { enabled: false, y-limit: -1 }

黑名单配置​

blacklist:
  # 不检测的矿石 (降低误报)
  ores:
    - COAL_ORE
    - IRON_ORE
    - COPPER_ORE

  # 不检测的世界
  worlds:
    - world_creative
    - world_test

封禁配置​

ban-announcement:
  message: "§c玩家 %player% 因使用作弊被封禁！"
  detail: "§7原因: §f%reason%"

ban-reason: "使用作弊客户端 (VL: %vl%)"
ban-duration: 30  # 天数, -1 为永久

enable-ban-announcement: true

命令参考​

主命令: /nax​

命令用法说明
reload/nax reload重载配置
ban/nax ban <玩家> [原因]封禁玩家
resetviolation/nax resetviolation <玩家>清零违规值
orestats/nax orestats <玩家>查看挖矿统计
oretop/nax oretop挖矿排行榜
oretrack/nax oretrack <玩家>追踪玩家挖矿
replay/nax replay回放管理

回放命令​

命令说明
/nax replay打开回放GUI
/nax replay play <文件>播放回放
/nax replay stop停止回放
/nax replay pause暂停/继续
/nax replay forward快进
/nax replay backward回退

绕过管理​

命令说明
/nax internalbypass grant <玩家> <秒数> [原因]授予检测豁免
/nax internalbypass remove <玩家>移除豁免
/nax internalbypass list列出所有豁免
/nax internalbypass clear清除所有豁免

权限列表​

权限说明默认
nekoantixray.admin所有管理命令OP
nekoantixray.bypass绕过检测false
nekoantixray.alerts接收警告OP
nekoantixray.replay回放功能OP
nekoantixray.orestats统计查看OP

常见问题​

Q: 插件无法加载​

可能原因:

  1. Java版本低于17
  2. 未安装ProtocolLib
  3. 服务端版本不兼容

解决方案:

# 检查Java版本
java -version  # 需要17+

# 确认ProtocolLib已安装
ls plugins/ | grep ProtocolLib

Q: 误报率太高​

解决方案:

  1. 启用环境过滤器

    environment-filters:
      apply-filters: true
      cave:
        reduce-vl: true

  2. 提高检测阈值

    pattern-analyzer:
      turning-limit: 15
      branching-limit: 10

  3. 将常见矿石加入黑名单

    blacklist:
      ores:
        - COAL_ORE
        - IRON_ORE

Q: 服务器卡顿​

解决方案:

  1. 减少射线追踪线程数

    world-settings:
      default:
        ray-trace-threads: 2

  2. 减小追踪距离

    anti-xray:
      ray-trace-distance: 50.0

  3. 在非重要世界禁用增强反矿透

    world-settings:
      world_the_end:
        enabled: false

Q: 如何查看可疑玩家​

  1. 实时追踪

    /nax oretrack <玩家名>

  2. 查看统计

    /nax orestats <玩家名>

  3. 查看回放

    /nax replay

Q: 如何与Paper反矿透配合​

  1. Paper paper.yml 配置:

    anticheat:
      anti-xray:
        enabled: true
        engine-mode: 1

  2. NekoAntiXray 配置:

    check:
      xray:
        heavy-mode: true

Q: 深度学习模块如何使用​

  1. 收集训练数据

    /nax record <作弊玩家> start cheater
    /nax record <正常玩家> start legit

  2. 训练模型 (需要Python环境)

    python train_model.py --data plugins/NekoAntiXray/training_data/

  3. 部署模型

    将 model.onnx 和 feature_stats.json 放入插件目录

  4. 启用深度学习

    deeplearn:
      enable: true

技术支持​

用户手册 - NekoAntiXray v2.1.1