
DevLink - 面向7 Days to Die的AI辅助模组制作工具包
一个为Claude Code构建的《七日杀》模组开发知识库,以及一座让Claude Code能够查看运行中游戏的桥梁:截图、实时状态,以及就地重载XML和资源包。需要Hot Reload。面向模组作者,而非玩家。Claude可以测试实时修改、读取错误日志,甚至游玩游戏。
查看大图[size=4][b]查看正在运行的游戏内部,并操控它——通过脚本、终端或 AI 编程助手。[/b][/size]
[b]需要 [url=HOTRELOAD_URL]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 类到底有没有从 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 并静默还原每个 mod 补丁。[/]
[][b]AssetBundle[/b] — 网格、预制体、材质[/]
[][b]Localization.csv[/b] — 原版加上每个 mod 的补丁文件[/]
[][b]UI 图集[/b] — 物品图标和 HUD 精灵图,引擎有意拒绝在游戏内重载它们[/]
[][b]重新网格化世界[/b] — 使方块和材质修改出现在已存在几何体上,且不像 chunkreset 那样删除已保存的区块数据[/]
[/list]这些也作为按钮出现在 Hot Reload 的游戏内页面上,因此你不需要终端就能使用它们。
[size=4][b]操控游戏[/b][/size]
移动和视角、使用手持物品(按下和松开分开,因此你可以保持拉弓)、选择和填充工具带槽位、手动添加 buff、设置 CVar、直接按下 XUi 控件、关闭生成提示、切换飞行模式。控制调用的是游戏自身的处理器,而非注入 OS 输入,因此无论窗口是否有焦点都能工作。
[size=4][b]位于 Files 标签页的 mod 制作知识库[/b][/size]
一个单独的下载:一份为配合 [b]Claude Code[/b] 使用而构建的《7 Days to Die》mod 制作参考。
[list]
[][b]25 份参考文档,约 68,000 行[/b] — 基于真实安装编写并经过对抗性复核。XPath 补丁、物品、方块、buff、实体、进度、XUi、世界生成、载具、音频、粒子、AssetBundle、Harmony、网络代码、本地化、打包,以及一份完全转换操作手册。[/]
[][b]约 55 份机器提取的真实基准文件[/b] — 每个被动效果名称、每个触发器和需求、原版中每个 XML 元素路径和属性值、控制台命令列表、Unity 标签和层顺序、战利品表、着色器映射、载具物理。[/]
[][b]ENGINE_TRAPS.md[/b] — 收集的静默失败。每一条都是游戏接受你的修改、不报告错误、也不做任何事的情况。这是最能节省时间的文件。[/]
[][b]START_HERE.md[/b] — 一份一次性交给 Claude Code 的设置文档。它会测量你实际的游戏版本,生成游戏代码的完整可 grep 反编译,写出针对你机器定制的 CLAUDE.md,安装一个 mod 制作技能,并证明开发循环可用。[/]
[/list]前提:模型对这款游戏的预训练知识并不可靠,而解决办法不是更好的提示词——而是磁盘上可搜索的真实基准语料库,外加一个能对照运行中的游戏检验说法的工具。
[b]将知识库解压到你的 mod 项目文件夹,而不是 Mods。[/b]
[size=4][b]要求[/b][/size]
[list]
[][url=HOTRELOAD_URL][b]Hot Reload[/b][/url] — 没有它 DevLink 什么也不做[/]
[][b]关闭 EasyAntiCheat[/b] — 它包含一个 DLL,而游戏在开启 EAC 时会静默跳过 DLL mod[/]
[][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=HOTRELOAD_URL]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]注入的 OS 点击无法到达 IMGUI 覆盖层。[/b]它的 click 命令只对 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]不要把它打包进其他人运行的 mod 中,也不要在公共服务器上运行它。[/b]
[size=4][b]不面向玩家[/b][/size]
它包含一个 DLL,它是一个开发工具,发布 mod 前应将其移除。不要让你的 mod 依赖它。
[size=4][b]许可[/b][/size]
用它开发任何你喜欢的东西,包括你商业发布的 mod——你用它所制作的东西不受其许可证约束,也不要求署名。为协议编写你自己的客户端,并通过文档化的契约给你自己的 mod 提供一个命令接口;两者都可以自由实现。阅读、改编和引用知识库用于你自己的 mod 制作工作,包括你发布的笔记,需注明出处。请不要重新上传它、分发修改后的副本,或将其打包进整合包。见 LICENSE.txt。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。