尧图网站建设 
universal-modder贡献者指南如何提交字段笔记、编写um CLI模块与维护引擎Playbook【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址: https://gitcode.com/gh_mirrors/un/universal-modderuniversal-modder 贡献者指南手把手教你向这个让 AI 给任意 PC 游戏做 Mod的开源工具提交三大类贡献——字段笔记field notes、umCLI 新模块、引擎 Playbook。无需深厚逆向背景跟着本文步骤走新手也能顺利发出第一个 PR。项目是什么先花1分钟看懂结构universal-modder 由三部分构成你的贡献会落在其中一个目录内容贡献类型knowledge/AI 写给 AI 的字段笔记知识库 最常见人人可写um/Python 写的um命令行工具️ 工具开发skills/AI 技能与 12 份引擎 Playbook 经验沉淀完整规则见 CONTRIBUTING.mdAI 和人类贡献者都适用。一、提交字段笔记最推荐的入门贡献字段笔记记录某款游戏是怎么被真正 Mod 的精确版本号、选用的路线、引擎真相、验证方式、踩坑清单。下一个 AI 读到它就不用再踩同样的坑。例如这份 Terraria Fal Arsenal 笔记 就记录了从 tModLoader 加载到内存泄漏修复的全部细节。第 1 步先搜索确认不重复um kb search grand theft auto如果已有笔记去改进它补版本、补 gotcha、纠错不要另开一篇。第 2 步用脚手架生成模板um kb new --game Hades II --title A new boon god --from-scan hades --agent Codex (gpt-6)--from-scan会自动预填引擎、反作弊、已装加载器等扫描结果。生成后按 knowledge/TEMPLATE.md 的章节逐段填写。写作对象是从未见过这款游戏的 AI重点写三块Setup精确版本。最新对谁都没用Verification用什么预言机验证过以及没验证什么Gotchas编号列出症状 → 原因 → 修复这是整篇笔记最有价值的部分。第 3 步校验、更新索引、开 PRum kb check knowledge/games/hades-ii/a-new-boon-god.md um kb index um kb pr knowledge/games/hades-ii/a-new-boon-god.md --yesum kb pr不加--yes是干跑dry run会打印将要执行的 git/gh 命令。PR 是公开的、挂在你的账号下执行前请先让人类搭档看过笔记内容。二、编写 um CLI 模块工具类贡献um是纯 Python3.10CLI架构约定非常简洁新贡献者容易上手一个 CLI 组 一个模块。现有模块如 um/kb.py、um/sprite.py、um/scan.py每个文件实现一个register(sub)函数挂到 um/cli.py 的GROUPS列表模块 docstring 兼作--help帮助文案所以 docstring 要写好命令示例必须补测试在 tests/test_um.py 中添加用例本地跑uv run --with pytest pytest -q tests全部通过Windows 侧 PowerShell 工具有特殊约束um/ps1/ 内嵌的是 C# 5Windows PowerShell 5.1 编译器不能用字符串插值、out var等新语法。CI 每个 PR 都会跑测试、um kb check --index和 CLI 帮助页检查本地先跑通能少返工。三、维护引擎 Playbook把踩坑经验写进手册引擎 Playbook 位于 skills/mod-any-game/references/engines/每个文件覆盖一类引擎如 dotnet-xna.md、godot.md、unreal.md结构统一章节写什么Identify如何识别该引擎文件特征、magic 头Read the game用什么反编译/解析工具输出放哪Routes按优先级排列的 Mod 路线社区加载器 → 内容覆盖 → 重编译Pitfalls版本陷阱、32/64 位、常见错误维护建议链接到权威社区项目但注明版本会变请查当前发布别写死版本号写法对 AI 中立说 the agent不点名某个具体产品深水区细节放references/SKILL.md保持精炼。贡献红线碰了 PR 直接关闭以下规则来自 CONTRIBUTING.md 和um kb check的自动校验不上传游戏内容游戏文件、提取资源、ROM/ISO不粘贴反编译代码用自己的话描述逻辑、点名符号即可自有代码片段超 60 行警告、150 行直接失败不做联机作弊不写联机内存偏移、不绕过反作弊/DRM仅限单机与离线不含密钥API key、token、.env文件um kb check与 um/publish.py 都会拦截✅诚实标注agents:写明代理模型status如实填in-progress、abandoned也欢迎——死路也是知识。提交前检查清单[ ] 跑过 um kb check或 pytest 全绿 [ ] 版本号、验证方式、未验证项都写清楚了 [ ] 无游戏文件 / 无大段反编译代码 / 无密钥 [ ] 让人类看过 PR 内容参考 examples/aoe2-de-civ 里帝国时代 II 新文明这类完整案例你会发现一份好的字段笔记一个干净的 PR就是对这个项目最有价值的贡献。准备好了就 fork 一份仓库git clone https://gitcode.com/gh_mirrors/un/universal-modder从一篇字段笔记开始吧 【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址: https://gitcode.com/gh_mirrors/un/universal-modder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 universal-modder贡献者指南：如何提交字段笔记、编写um CLI模块与维护引擎Playbook
universal-modder贡献者指南如何提交字段笔记、编写um CLI模块与维护引擎Playbook【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址: https://gitcode.com/gh_mirrors/un/universal-modderuniversal-modder 贡献者指南手把手教你向这个让 AI 给任意 PC 游戏做 Mod的开源工具提交三大类贡献——字段笔记field notes、umCLI 新模块、引擎 Playbook。无需深厚逆向背景跟着本文步骤走新手也能顺利发出第一个 PR。项目是什么先花1分钟看懂结构universal-modder 由三部分构成你的贡献会落在其中一个目录内容贡献类型knowledge/AI 写给 AI 的字段笔记知识库 最常见人人可写um/Python 写的um命令行工具️ 工具开发skills/AI 技能与 12 份引擎 Playbook 经验沉淀完整规则见 CONTRIBUTING.mdAI 和人类贡献者都适用。一、提交字段笔记最推荐的入门贡献字段笔记记录某款游戏是怎么被真正 Mod 的精确版本号、选用的路线、引擎真相、验证方式、踩坑清单。下一个 AI 读到它就不用再踩同样的坑。例如这份 Terraria Fal Arsenal 笔记 就记录了从 tModLoader 加载到内存泄漏修复的全部细节。第 1 步先搜索确认不重复um kb search grand theft auto如果已有笔记去改进它补版本、补 gotcha、纠错不要另开一篇。第 2 步用脚手架生成模板um kb new --game Hades II --title A new boon god --from-scan hades --agent Codex (gpt-6)--from-scan会自动预填引擎、反作弊、已装加载器等扫描结果。生成后按 knowledge/TEMPLATE.md 的章节逐段填写。写作对象是从未见过这款游戏的 AI重点写三块Setup精确版本。最新对谁都没用Verification用什么预言机验证过以及没验证什么Gotchas编号列出症状 → 原因 → 修复这是整篇笔记最有价值的部分。第 3 步校验、更新索引、开 PRum kb check knowledge/games/hades-ii/a-new-boon-god.md um kb index um kb pr knowledge/games/hades-ii/a-new-boon-god.md --yesum kb pr不加--yes是干跑dry run会打印将要执行的 git/gh 命令。PR 是公开的、挂在你的账号下执行前请先让人类搭档看过笔记内容。二、编写 um CLI 模块工具类贡献um是纯 Python3.10CLI架构约定非常简洁新贡献者容易上手一个 CLI 组 一个模块。现有模块如 um/kb.py、um/sprite.py、um/scan.py每个文件实现一个register(sub)函数挂到 um/cli.py 的GROUPS列表模块 docstring 兼作--help帮助文案所以 docstring 要写好命令示例必须补测试在 tests/test_um.py 中添加用例本地跑uv run --with pytest pytest -q tests全部通过Windows 侧 PowerShell 工具有特殊约束um/ps1/ 内嵌的是 C# 5Windows PowerShell 5.1 编译器不能用字符串插值、out var等新语法。CI 每个 PR 都会跑测试、um kb check --index和 CLI 帮助页检查本地先跑通能少返工。三、维护引擎 Playbook把踩坑经验写进手册引擎 Playbook 位于 skills/mod-any-game/references/engines/每个文件覆盖一类引擎如 dotnet-xna.md、godot.md、unreal.md结构统一章节写什么Identify如何识别该引擎文件特征、magic 头Read the game用什么反编译/解析工具输出放哪Routes按优先级排列的 Mod 路线社区加载器 → 内容覆盖 → 重编译Pitfalls版本陷阱、32/64 位、常见错误维护建议链接到权威社区项目但注明版本会变请查当前发布别写死版本号写法对 AI 中立说 the agent不点名某个具体产品深水区细节放references/SKILL.md保持精炼。贡献红线碰了 PR 直接关闭以下规则来自 CONTRIBUTING.md 和um kb check的自动校验不上传游戏内容游戏文件、提取资源、ROM/ISO不粘贴反编译代码用自己的话描述逻辑、点名符号即可自有代码片段超 60 行警告、150 行直接失败不做联机作弊不写联机内存偏移、不绕过反作弊/DRM仅限单机与离线不含密钥API key、token、.env文件um kb check与 um/publish.py 都会拦截✅诚实标注agents:写明代理模型status如实填in-progress、abandoned也欢迎——死路也是知识。提交前检查清单[ ] 跑过 um kb check或 pytest 全绿 [ ] 版本号、验证方式、未验证项都写清楚了 [ ] 无游戏文件 / 无大段反编译代码 / 无密钥 [ ] 让人类看过 PR 内容参考 examples/aoe2-de-civ 里帝国时代 II 新文明这类完整案例你会发现一份好的字段笔记一个干净的 PR就是对这个项目最有价值的贡献。准备好了就 fork 一份仓库git clone https://gitcode.com/gh_mirrors/un/universal-modder从一篇字段笔记开始吧 【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址: https://gitcode.com/gh_mirrors/un/universal-modder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考