ZTool

ZTool

一套简单的控制台基础命令,用于修复POI僵尸故障

ZTool

《7 Days to Die》的游戏导航与诊断实用工具。

ZTool 是一套面向《7 Days to Die》的开源小型游戏玩法与诊断工具集合。

v0.02 的主要功能是 ZMark——一个简单的命令,用于显示游戏自带的橙色清剿任务沉睡者区域导航标记,让你能够找到仍需前往的遭遇点,而无需盲目搜索整个 POI。

ZMark 不会主动生成僵尸、唤醒沉睡者、改变僵尸 AI 或更改沉睡者生命周期状态。

ZMARK——找到你遗漏的沉睡者

正常开始一个商人清剿任务或取回/清剿任务,然后运行:

zm

ZMark 会使用原版橙色导航标记显示当前未清剿的沉睡者区域。

这些标记会出现在:

  • 罗盘上
  • 3D 世界中(可见时)
  • 带有原版高度指示器,显示遭遇点位于你上方还是下方

然后只需正常游玩 POI 即可。

这在大型 T4、T5 和 T6 POI 中尤其有用,因为遗漏一个沉睡者遭遇点可能意味着需要重新搜索整栋建筑。

橙色标记与红点

橙色标记代表沉睡者区域遭遇位置,而不是单个僵尸。

当遭遇点激活时,游戏可能会在显示红色敌人标记期间暂时隐藏橙色导航标记。

典型的 progression 如下所示:

橙色导航
    ↓
接近遭遇点
    ↓
沉睡者出现
    ↓
红点
    ↓
击杀遭遇点
    ↓
区域清剿

剩余的橙色标记通常会在遭遇之间恢复显示。

一个遭遇点可能包含普通僵尸、秃鹫或其他沉睡者区域占用者。

ZMARK 命令

zm
zmarker

标记当前 POI 中所有当前未清剿的沉睡者区域。

zm <volume>

标记一个特定的沉睡者区域索引。

zm clear

请求移除当前 POI 的沉睡者区域导航标记。

zm refresh

移除现有标记,并重新标记所有当前 wasCleared 状态为 false 的沉睡者区域。

诊断命令

zc
zcount

显示当前 POI 僵尸和沉睡者区域状态。

za
zzombie

显示当前已加载僵尸的统计信息。

zi
zinspect

检查内部沉睡者区域及相关游戏状态。

示例:

zi vol <n>
zi vols

zi vols 会为当前 POI 中的每个沉睡者区域生成一行紧凑的状态报告。

zrgn
zregion

显示玩家位置、区块坐标、区域坐标以及对应的 .7rg 区域文件名。

实验性 / 调试工具

ZWake

zw
zwake

在配置的半径内强制沉睡者区域实体化/激活。

可选的一次性半径:

zw <meters>

警告: ZWake 会主动与沉睡者生命周期状态交互。

它对于研究、测试和恢复异常沉睡者情况很有用,但不建议作为正常的清剿任务工作流程。

请优先使用 ZMark。

ZRain

zr
zrain

将当前存活的僵尸按配置的偏移量垂直提升。

可选的一次性偏移量:

zr <meters>

ZRain 可作为诊断/恢复工具,用于处理被困在几何体中的僵尸,或用于试验无法到达的已生成敌人。

设置 / 状态

zt
ztool

显示当前 ZTool 设置。

zt radius <meters>

设置默认 ZWake 半径。

zt vofs <meters>

设置默认 ZRain 垂直偏移量。

控制台 + 日志输出

所有 ZTool 命令输出都会同时写入:

  • 游戏内控制台
  • 持久的《7 Days to Die》游戏日志

这样既能提供即时反馈,也能保留相同的诊断信息以供后续分析。

安装

如果游戏正在运行,请先退出游戏。

将 ZTool 文件夹解压到:

...\steam\steamapps\common\7 Days To Die\Mods\

然后你应该得到:

Mods\
    ZTool\
        ModInfo.xml
        ZTool.dll
        README.txt
        ZTool.cs

已知限制

ZMark 使用原版清剿任务沉睡者区域标记系统,但预制体的沉睡者区域状态并不总是与清剿目标所需的确切遭遇点集合完全一致。

观察到的边缘情况包括:

  • 即使清剿任务完成,某个沉睡者区域仍可能保持 wasCleared=0
  • 任务完成后,罕见情况下可能残留过时的橙色标记
  • 原版标记移除偶尔可能保留 HUD 标记

任务完成状态仍然是权威依据。

ZMark 本身不会主动调用 TouchGroup、生成沉睡者、唤醒僵尸或改变僵尸 AI。

要求

测试环境:

7 Days to Die v3.2

未在更早版本上测试。

源代码

ZTool 是开源的。

当前 ZTool C# 源代码为 Riitoken 的原创作品。现有的 C# 注入模组为特定游戏 API 和集成技术提供了有用的参考。