universal-modder - 让 AI 编程代理为任意 PC 游戏制作 Mod 的技能与知识库

universal-modder 是一个面向 AI 编程代理的开源工具集，由 rehan-remade 维护。按项目自述，它提供一套技能（Skills）、工具和一个共享知识库，让任意 AI 编程代理能够为自己拥有的 PC 游戏制作 Mod：代理先定位游戏、判断引擎与可行路线，再阅读真实代码、构建 Mod，借助 fal 生成美术、3D 与音效素材，在运行中的游戏里验证，最后剪辑展示视频，并把经验写成笔记留给下一个代理。它适合已经使用 Claude Code、Codex、Gemini CLI、Cursor 等代理工具，希望把「改游戏」这件事流程化的玩家与 Mod 作者。

维护者与状态

项目仓库为 rehan-remade/universal-modder，维护者是 rehan-remade，许可证为 MIT。仓库创建于 2026-09-30，最后提交时间为 2026-10-28。截至 2026-10-28，项目获得 9121 个星标。事实表显示，该项目尚无正式 release，因此目前没有可引用的版本号，使用方式以仓库中的安装说明为准。

主要能力

以下内容据项目 README 自述整理，属于维护者对能力的描述，并非第三方评测结论。

• 统一的 Mod 工作流：代理从 mod-any-game 技能起步，按固定循环推进——检索知识库、侦察并选择路线、搭建带存档备份的安全实验环境、阅读实际代码、先做出一个可运行的最小切片、生成素材、在真实游戏中验证、录制、打包，最后写一份现场笔记。
• 引擎覆盖面：README 列出的引擎手册包括 Unity、Unreal、.NET/XNA（Terraria、Stardew、Celeste）、Godot、Source 1/2、Bethesda、Minecraft、AoE2/Genie、Bannerlord、Binding of Isaac，以及 RE Engine、MT Framework、FromSoft、GTA、Hedgehog Engine、Cyberpunk、BG3 等，另含原生 C++、多种独立引擎与复古反编译场景。
• 侦察与研究：game-recon 技能整理既有笔记、引擎与版本、托管或原生代码、反作弊、加载器、存档目录与社区路线，产出 MODDING_PLAN.md；game-research-websearch 技能则通过 Wayback、archive.today、GitHub、Nexus、Workshop、Thunderstore 接口、Reddit 与 YouTube 等渠道做开放网络调研。
• 逆向工程：reverse-engineering 技能涉及 ILSpy、Cpp2IL、Vineflower、Ghidra、IDA、Cheat Engine、Frida、RenderDoc 等工具，并强调用往返验证来证明对文件格式的理解。
• 素材生成：fal-assets 技能覆盖带真实透明通道的精灵图、像素画、无缝贴图、PBR 贴图、图生 3D、自动绑定、音效、音乐、配音与过场视频；asset-pipeline 技能负责把美术转成引擎精确帧，包括 3D 转 8/16 方向精灵图。
• 自动化与展示：game-automation 负责启动、截图、点击输入与窗口化处理；showcase-video 只录制游戏音频并按 EDL 剪辑成片；mashup-mods 处理「游戏中套游戏」的内容移植；publish-mod 与 port-a-mod 分别负责打包发布和把旧 Mod 迁移到新版本或新加载器。
• 面向 AI 的知识库：knowledge/ 目录存放现场笔记，记录可用版本、路线及理由、引擎真实行为、验证方式与常见坑（症状→原因→修复）。完成 Mod 的代理可以提交 PR 贡献笔记，让后来者不必重复踩坑。README 称贡献规则禁止提交游戏文件与反编译转储、禁止作弊影响其他玩家，并要求如实标注状态与验证情况。
• 多代理协作：agents/ 目录提供由三个子代理组成的团队，用于耗时数天的 Mod 项目；README 提醒三代理的 token 消耗是单代理的数倍，建议只用于长周期任务。

使用入口

仓库地址：rehan-remade/universal-modder。

据项目说明，安装方式按所用代理区分：Claude Code 通过插件市场添加并安装；Codex 使用 codex plugin marketplace add 与 codex plugin add；Gemini CLI 使用 gemini extensions install 指向仓库地址；VS Code / Copilot 需启用 chat.plugins.enabled 后从源安装插件；Cursor 可从其市场安装或直接克隆仓库；OpenCode 可克隆后在目录内运行，或在 OpenCode 2 上用 opencode plugin add 安装插件。只想用技能的话，可执行 npx skills add 指向仓库地址；其他代理则克隆仓库并在其中启动。

um 命令行工具在 Claude Code 插件安装或克隆后由钩子加入 PATH，其他代理的插件安装不会自动完成这一步，README 建议用 uv tool install 或 pipx install 从仓库地址安装一次。素材生成需要 fal API key，可用 um fal key set 保存，Linux 下写入桌面密钥环，其他平台写入仅所有者可读的文件；也可通过环境变量 FAL_KEY 提供。没有密钥时，README 称 fal 的 OAuth 端点可通过浏览器登录，um comfy 可在本地 ComfyUI 服务器上生成图片。此外 um sprixen 与 um voidless 分别对接两个独立付费服务，各自需要单独的 API key。

运行前置条件据 README 包括 Git、Python 3.10+ 与 ffmpeg，推荐使用 uv；3D 转精灵图渲染需要 Blender；Windows 游戏可原生驱动或从 WSL 驱动。

许可与限制

项目采用 MIT 许可证。使用前需要了解的边界条件，据项目自述包括：素材生成依赖 fal 等外部服务及其密钥，其中 Sprixen 与 Voidless 为独立付费服务；3D 到精灵图的流程需要 Blender；多代理模式会显著增加 token 消耗；知识库贡献明确禁止提交游戏文件、反编译转储以及影响其他玩家的作弊内容。README 中部分代理集成（如 Cursor 插件与 Gemini CLI 扩展读取 agents/ 目录）被标注为未在此处测试，Gemini CLI 的子代理也无法再启动子代理。项目尚无正式 release，接口与安装方式可能随仓库提交变化，实际使用应以仓库内文档为准。