universal-modder

项目简介

universal-modder 是一套让 AI 编码代理面向你拥有的 PC 游戏工作的工具集。它把 Agent Skills、三人代理团队、Python 编写的 um CLI、共享的现场笔记知识库和 fal MCP 组合起来，使代理能够执行侦察、逆向工程、资产生成、游戏内测试、录制、打包与发布。它支持 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 以及仅使用技能的配置方式。

核心功能

• Agent Skills 捆绑引擎操作手册与工作流，覆盖侦察、逆向工程、资产生成、游戏自动化、展示视频、发布、移植和分享现场笔记。
• um CLI 可扫描 Steam、Epic 和 Xbox 安装，识别引擎与版本、.NET 或原生、反作弊、已安装加载器、存档目录，并给出排序后的模组路线。
• fal MCP 与 um fal 可生成精灵、图像、纹理、PBR 贴图、3D 模型、绑定、音效、音乐、语音和视频，并支持本地 ComfyUI 以及独立的 Sprixen 和 Voidless 集成。
• 知识库保存由代理为代理编写的现场笔记，记录实际可用版本、所选路线、引擎行为、验证方式和常见陷阱，并提供搜索、创建、检查和发起 PR 的命令。
• 三人代理团队支持耗时较长的模组：协调者、接触运行中游戏的游戏工作者，以及研究数据并编写生成器和补丁的离线工作者。
• 安全规则会在修改前备份存档，避免反作弊和在线作弊，绝不随模组分发游戏文件或反编译代码，并在控制输入、安装加载器或发布前询问。

适用场景

• 为 Terraria、Age of Empires II DE 等游戏添加新武器、敌人、Boss、文明、单位、精灵或纹理。
• 在游戏之间移植内容，例如把 Halo 武器和载具移植到 Minecraft，或把真正的 Minecraft 放进 GTA V 故事模式。
• 调查未知游戏安装，识别其引擎、已有模组工作和可行的模组路线。
• 生成图像、3D 模型、音频和展示视频，并处理成引擎可直接使用的资源。

快速开始

• 为 Claude Code、Codex、Gemini CLI、VS Code/Copilot、Cursor 或 OpenCode 安装插件或扩展；也可以使用仅技能安装器，或克隆仓库并在其中启动代理。
• 如需生成资产，创建 fal API key 并用 um fal key set 保存，或在启动代理前在环境中设置 FAL_KEY。
• 如果代理安装没有把 um 加入 PATH，可用 uv tool install 或 pipx 从仓库安装一次。
• 从 mod-any-game 技能开始；代理会搜索知识库、侦察、备份存档、阅读代码、构建可运行切片、生成资产、在游戏中验证、录制、打包，并编写现场笔记。

部署与要求

• 需要 Git、Python 3.10+ 和 ffmpeg；推荐使用 uv。3D 转精灵渲染需要 Blender。
• Windows 游戏可原生驱动，也可从 WSL 驱动。
• fal API key 用于 fal MCP 服务器和 um fal；没有 key 时可通过 fal OAuth 浏览器登录，um comfy 可在本地 ComfyUI 服务器上生成图像。
• Sprixen 和 Voidless 是独立付费服务，某些 2D 精灵工作流需要它们各自的 API key。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。