DevLink - 7 Days to Die 的 AI 辅助模组工具包

DevLink - 7 Days to Die 的 AI 辅助模组工具包

为 Claude Code 构建的《七日杀》模组开发知识库,外加一座桥梁,让它能够看到正在运行的游戏:截图、实时状态,以及就地重新加载 XML 和资源包。需要热重载。面向模组作者,而非玩家。

[size=4][b]查看运行中游戏的内部状态,并操控它——通过脚本、终端或 AI 编程助手。[/b][/size]

[b]需要 [url=https://www.nexusmods.com/7daystodie/mods/12649]Hot Reload[/url]。[/b] DevLink 作为可重载核心在其下运行,这意味着 DevLink 可以在你使用它的同时热重载自身。

[size=4][b]不再猜测你的修改是否生效[/b][/size]

这款游戏中最典型的故障是静默的。匹配不到任何内容的 XPath 不是错误。无法解析的 buff 名称会让整个文件失效,却不发出任何提示。一个补丁可以验证通过、加载成功、报告成功,却什么也没做。

DevLink 让你直接询问运行中的游戏:

[list]
[][b]iteminfo[/b] / [b]blockinfo[/b] - 直接从实时注册表读取属性,从而确认修改确实生效[/]
[][b]locinfo[/b] - 实时本地化字符串,以及该键是否真的存在[/]
[][b]buffs[/b] - 玩家身上有哪些 buff,以及指定的 buff 类是否从 buffs.xml 中解析出来。这一区分可以分辨“我的 XML 坏了”和“我的 XML 没问题但没有任何东西挂载它”[/]
[][b]cvar[/b] - 以数值方式读取你自己的值。从 HUD 条上读像素无法区分 0/0 和 100/100[/]
[][b]helditem[/b] - 手持物品为什么无法开火:物品动作拒绝使用的每一道静默关卡,以及手实际所在的位置[/]
[][b]xmlprobe[/b] - 非破坏性。运行真实的补丁管线并在打补丁后的文档中统计出现次数,不触碰任何注册表,从而可以区分“我的补丁是否应用了”和“重建是否存活了”[/]
[][b]screenshot[/b] - 通过 Unity 自身捕获的全分辨率 PNG,不受窗口焦点、最小化和 alt-tab 影响[/]
[/list]
[size=4][b]就地重载几乎任何内容[/b][/size]

[list]
[][b]配置 XML[/b] - 物品、方块、buff、配方、进度、战利品、entityclasses……[i]并应用你自己的 XPath 补丁[/i]。这不是引擎自带的 reloadxml,后者直接读取 Data/Config,并静默还原每个模组补丁。[/]
[][b]AssetBundles[/b] - 网格、预制体、材质[/]
[][b]Localization.csv[/b] - 原版加上每个模组的补丁文件[/]
[][b]UI 图集[/b] - 物品图标和 HUD 精灵,引擎刻意拒绝在游戏内重载这些[/]
[][b]重新生成世界网格[/b] - 使方块和材质修改出现在已存在几何体上,而不会像 chunkreset 那样删除已保存的区块数据[/]
[/list]
这些也会以按钮形式出现在 Hot Reload 的游戏内页面上,因此你不需要终端就能使用它们。

[size=4][b]操控游戏[/b][/size]

移动和视角,使用手持物品(按下和释放分开,以便可以保持拉弓),选择和填充快捷栏槽位,手动添加 buff,设置 CVar,直接按下 XUi 控件,关闭出生提示,切换飞行模式。控制调用游戏自身处理器,而不是注入操作系统输入,因此无论窗口是否有焦点都能工作。

[size=4][b]模组知识库,位于 Files 标签页[/b][/size]

单独下载:一份为配合 [b]Claude Code[/b] 使用而构建的 7 Days to Die 模组参考。

[list]
[][b]25 份参考文档,约 68,000 行[/b] - 针对真实安装编写并经过对抗性复核。XPath 补丁、物品、方块、buff、实体、进度、XUi、世界生成、载具、音频、粒子、AssetBundles、Harmony、网络代码、本地化、打包,以及一份完全转换操作手册。[/]
[][b]约 55 个机器提取的基准事实文件[/b] - 每个被动效果名称、每个触发器和需求、原版中每个 XML 元素路径和属性值、控制台命令列表、Unity 标签和层顺序、战利品表、着色器映射、载具物理。[/]
[][b]ENGINE_TRAPS.md[/b] - 收集的静默故障。每一条都是游戏接受你的修改、不报告错误、却什么也没做的案例。这是最能节省时间的文件。[/]
[][b]START_HERE.md[/b] - 一份你交给 Claude Code 一次的设置文档。它会测量你实际的游戏版本,生成游戏代码的完整可 grep 反编译,写出针对你机器定制的 CLAUDE.md,安装一个模组技能,并证明开发循环可用。[/]
[/list]
前提是:模型对这款游戏的预训练知识并不可靠,而解决办法不是更好的提示词——而是磁盘上可搜索的基准事实语料库,外加一个能对照运行中游戏检查声明的工具。

[size=4][b]安装知识库——它不是一个模组[/b][/size]

[b]不要把它解压到你的 Mods 文件夹中。[/b]游戏从不读取其中任何内容,所以放在那里完全没用。它应放在你编写模组的文件夹中,与你的文件放在一起。

[list=1]
[]选择一个或创建一个用于模组工作的文件夹——任意位置均可,例如 [b]C:\Users\You\Documents\MyModProject\[/b][/]
[]将知识库文件解压到那里。你最终应得到 [b]MyModProject\claude-code\START_HERE.md[/b][/]
[/list]
[b]如果你使用 Claude Code[/b]([url=https://claude.com/claude-code]claude.com/claude-code[/url],Anthropic 的 AI 编程工具)——在该项目文件夹中打开它,并原样发送:

[code]Read START_HERE.md and set this project up. Work through it top to bottom.[/code]
十到二十分钟,大部分无需人工干预。它会找到你的游戏安装位置,从二进制文件中读取真实版本,生成游戏自身代码的可搜索反编译(约 800,000 行),以便它可以查找而不是猜测,写出记录其所测量内容的 CLAUDE.md,安装一个模组技能,并检查开发循环可用。在任何需要决策的地方它都会先询问。

反编译内容刻意不包含在下载中——它必须匹配你已安装的游戏版本,并且可以通过一条命令重新生成。

[b]如果你不使用 Claude Code[/b],它仍然值得拥有,并且你完全可以忽略 START_HERE.md。所有内容都是纯 Markdown:从 [b]kb/README.md[/b] 查看索引,从 [b]kb/ENGINE_TRAPS.md[/b] 了解陷阱。其他 AI 助手也能很好地使用它。

[size=4][b]需求[/b][/size]

[list]
[][url=https://www.nexusmods.com/7daystodie/mods/12649][b]Hot Reload[/b][/url] - 没有它 DevLink 什么也做不了[/]
[][b]关闭 EasyAntiCheat[/b] - 它包含一个 DLL,而游戏在启用 EAC 时会静默跳过 DLL 模组[/]
[][b]Python[/b],仅当你想要使用附带的 bridge.py 客户端时需要。协议是输入一行 ASCII,输出带长度前缀的负载,因此在任何东西中重新实现都很简单。[/]
[/list]
7 Days to Die [b]V 3.2.0 (b10)[/b]。

[size=4][b]安装[/b][/size]

[list=1]
[]关闭 EasyAntiCheat。[/]
[]先安装 [url=https://www.nexusmods.com/7daystodie/mods/12649]Hot Reload[/url]。[/]
[]下载并解压此文件,将 [b]DevLink[/b] 文件夹放入你的 Mods 文件夹。[/]
[]启动游戏,然后检查:[b]python bridge.py ping[/b] 应回答 [b]pong[/b]。[/]
[/list]
[size=4][b]它不能做什么[/b][/size]

一个限制未被记录的工具会被误用到超出其能力的地方。这些是经过测量的,不是猜测的。

[list]
[][b]它不能驱动相机俯仰。[/b]只能偏航。两种显而易见的实现都是错的,而第二种比无用更糟——它让视角保持水平而身体俯仰,导致第一人称手臂摆出武器视锥,手持物品消失。该工具制造了你正在调查的那个确切 bug。在能够正确实现之前,俯仰被刻意设为不可驱动。[/]
[][b]重载 items.xml 每次调用会保留 80-380 MB 托管堆内存。[/b]这是安全的——id 被固定,因此世界中没有任何东西被重新指向——但它不是免费的。在一次会话中约四十次调用后达到 22 GB。[/]
[][b]重载 AssetBundle 每次会话安全两次,不是三次。[/b]第三次会使该 bundle 中的每个材质渲染为洋红色,直到你重新启动。[/]
[][b]注入的操作系统点击无法到达 IMGUI 覆盖层。[/b]其点击命令只对 XUi 控件有效。[/]
[][b]一张截图耗时约 0.8 秒[/b],因此连续帧的接触表在第一格之后就是假的。[/]
[][b]普通 XML 重载不会重新派生所有内容[/b]——图标图集、纹理数组和 id 分配不会。真正的新物品或新 bundle 内容仍然需要重启。[/]
[/list]
[size=4][b]安全性——请阅读这一条[/b][/size]

DevLink 绑定 127.0.0.1:7780,[b]无身份验证[/b],其控制台命令可执行任意游戏控制台命令。你机器上任何能打开回环套接字的程序都可以操控你的游戏。

对于本地开发工具来说这是可接受的权衡,对于其他任何用途都不可接受。[b]不要将它打包进他人运行的模组中,也不要在公共服务器上运行它。[/b]

[size=4][b]不适合玩家[/b][/size]

它包含一个 DLL,是开发工具,发布模组前应将其移除。不要让你的模组依赖它。

[size=4][b]许可[/b][/size]

可以用它开发任何你喜欢的东西,包括你商业发布的模组——你用它的任何产出都不受其许可证约束,也不需要署名。为协议编写你自己的客户端,并通过文档化契约给你的模组提供命令接口;两者都可以自由实现。阅读、改编并引用知识库用于你自己的模组工作,包括你发布的笔记,但需注明出处。请不要重新上传它、分发修改副本,或将其打包进整合包。参见 LICENSE.txt。