Skip to main content

高级调优指南

本节汇总了 NekoAntiXray 主要参数与可选功能，帮助你针对不同规模和玩法进行细化调优。

预设与世界绑定​

presets:
  default:
    biomeWeights:
      plains: balanced
      badlands: aggressive
    stoneDepth: 24
    hideFluids: true
  competitive:
    stoneDepth: 32
    hideFluids: true
    delayRevealTicks: 20

worlds:
  survival:
    preset: default
  factions:
    preset: competitive
  • biomeWeights：在富矿区（如 badlands）使用 aggressive，普通区使用 balanced，可降低误判。
  • stoneDepth：越大表示假矿延伸越深；在资源服提升深度可更好掩盖远地下矿脉。
  • delayRevealTicks：延迟真实矿物的露出时间，针对 “看到就跳” 的透视行为。

算法模式 (AlgoAntiXray)​

核心目标：通过路径数据判断玩家是否“精准挖矿”。重点调参：

参数说明
warning-vl / kick-vl / ban-vl警告、踢出、封禁阈值，需结合服内 VL 噪音调节
smooth-path.base-turn-threshold路径转向越多越可疑，适当降低可提高检测灵敏度
fishbone-detection.max-main-tunnel-turns-base限制鱼骨式分支，常配合 path-size-divisor 使用

实战建议：

  1. 先仅开启警告与踢出，并记录一段时间的 VL 分布。
  2. 结合 /nax record、/nax replay 采集合法/作弊样本，微调 vl-multiplier 等参数。
  3. 确认误报率可接受时再开启 enable-ban。

HeavyMode 射线隐藏​

world-settings:
  default:
    enabled: true
    anti-xray:
      ray-trace-third-person: true
      ray-trace-distance: 80.0
      rehide-blocks: true
      max-ray-trace-block-count-per-chunk: 100
    ray-trace-threads: 4
  • ray-trace-distance：影响玩家能提前探测矿物的距离；在 PvP 资源服建议保持 70+。
  • rehide-blocks：重复隐藏已被破坏的方块，可防止宏工具沿一个洞察看远处矿脉。
  • ray-trace-threads：跟随 CPU 核心调整；若出现上下文切换飙升，可降低线程数。

大规模挖掘 (mass-excavation)​

在生电服或世界吞噬器场景用于识别异常采掘。

mass-excavation:
  enabled: true
  detection-time-window: 60
  block-count-threshold: 80
  min-volume-threshold: 500
  min-density-threshold: 0.7
  min-horizontal-area-threshold: 100
  bypass-duration: 180
  • 当大型基建需要短期密集挖掘时，为玩家下发 /nax internalbypass grant，或延长 bypass-duration。
  • min-density-threshold 可防止普通 strip mining 触发告警。

AntiBrightness & 亮度限制​

antiBrightness:
  enable: false
  lightThreshold: 2
  targetOres:
    - DIAMOND_ORE
    - ANCIENT_DEBRIS
  message: "&c[NekoAntiXray] Light level is too low to break this ore!"

结合材质包透视常见做法，在低光照条件下禁止破坏稀有矿。与传统模式不同，此配置直接拦截破坏行为。

深度学习 (deeplearn)​

deeplearn:
  enable: true
  sequence_length: 50
  prediction_threshold: 0.5
  cooldown_ms: 5000
  violations:
    enable-punishment: true
    vl-multiplier: 10.0
    min-vl-increase: 1
    max-vl-increase: 15
  • 需要额外的 model.onnx 与 feature_stats.json 文件。
  • 若模型训练集与当前版本差异大，可暂时只记录预测数据而不执行处罚。

种子保护与黑名单​

fake-seed:
  enable-fake-seed: true
  show-real-seed-to-op: false

blacklist:
  ores:
    - COAL_ORE
  worlds:
    - world_the_end
  • fake-seed：伪造 /seed 输出，可搭配 antiSeedCracker.modifyEndStructures 彻底扰乱推算。
  • blacklist：为低价值矿石或特定世界禁用检测，减少噪音。

性能与监控​

  • ray-trace-threads、pipelineThreads 决定 CPU 利用率，建议逐级提升并观察 TPS。
  • 通过 /nax togglemassexcavation status 或内部指标判断是否需要调整阈值。
  • 大型服建议开启 announcement-system，实时播报封禁数量以震慑作弊者。

进阶功能与实践​

  • 回放系统：replay 模块会在启用的世界生成临时盔甲架并记录最近 record-duration 秒的轨迹，用 /nax replay / /nax cleanup 管理；遇到盔甲架残留可执行 cleanup 或缩短记录时间。
  • 大规模挖掘确认：mass-excavation 触发后会向玩家弹出确认按钮，防止大型工程被误判；若施工频繁可提前发放 /nax internalbypass grant 并延长 bypass-duration。
  • 深度学习训练：使用仓库中的 train_model.py --data <csv_dir> 在含 PyTorch 2.x、pandas、scikit-learn 的虚拟环境训练模型，得到 model.onnx 与 feature_stats.json 后放入插件根目录，与 sequence_length、prediction_threshold 等参数保持一致。

高阶调参前务必备份 config.yml，并在测试服或低峰期验证后再推广到生产环境。