一句话到成品 MOD：universal-modder 的 AI 游戏 MOD 工具链，3 条接入路径讲全-优快云博客

一句话到成品 MOD：universal-modder 的 AI 游戏 MOD 工具链，3 条接入路径讲全

【免费下载链接】universal-modder Point 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 代理自己侦察引擎、用 fal 生成美术 3D 与音效、进游戏实测，最后剪出展示视频。universal-modder 就是这样一套游戏模组制作工具包，让任意 AI 代理替你给拥有的 PC 游戏做 AI 游戏 MOD。

它替你做完的活

你只负责出点子，后面这条流水线由代理自己跑完。起点是 um scan：定位游戏安装、判定引擎与版本、分辨托管代码（.NET 这类可脚本化的）还是原生代码（C/C++，得逆向）。接着做逆向分析，读真实代码，在数据修改、加载器挂钩、原生注入几条路线里选一条。素材环节交给 fal：精灵图（游戏里会动的小图）、PBR 贴图、3D 模型、音效一次备齐。最后启动游戏实测 MOD、录屏、剪出带标题的展示视频，并把经验写成笔记。

装机清单

分三档装，用到再补：

必需：Python 3.10+（跑 um 命令行工具）和 ffmpeg（录制、剪辑展示视频）。
推荐：uv，Python 环境的快速管理器，后文的 um 安装命令靠它。
按需：Blender，仅当要把 3D 模型转成游戏精灵时用；fal API Key，仅当要生成素材时用。

💡 只让代理写 MOD 代码的话，Blender 和 fal 密钥都可以先不配，真到生成素材那天再补。

给代理挑一条接入路径

给 AI 代理接入有 3 条路：Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 等六大代理拿到的内容完全一致——同一套 Skills（Agent Skills 格式，任何代理都读得懂）、fal MCP 服务器（MCP 是让代理调用外部工具的标准协议，这里接的是 fal 的生成服务）和 um 命令行。

插件市场类（Claude Code / Codex / VS Code·Copilot），各给两条命令：

Claude Code：执行 /plugin marketplace add rehan-remade/universal-modder，再执行 /plugin install universal-modder@universal-modder。
Codex：执行 codex plugin marketplace add rehan-remade/universal-modder，再执行 codex plugin add universal-modder@universal-modder。
VS Code / Copilot：开启 chat.plugins.enabled 设置，运行 Chat: Install Plugin From Source，粘贴仓库地址。

扩展安装类（Gemini CLI）：执行 gemini extensions install，输入仓库地址即可，扩展定义在 gemini-extension.json。

克隆即用类（Cursor 或任意代理），最通用的一条路：

git clone https://gitcode.com/gh_mirrors/un/universal-modder

克隆之后，代理会在各自约定的位置自动找到技能：.agents/skills（Codex 等）、.claude/skills、.gemini/skills、.github/skills 都指向 skills/ 目录；AGENTS.md（由 CLAUDE.md 与 GEMINI.md 指向）是代理的工作总入口。只想装技能不装全套，跑 npx skills add 并输入仓库地址就行。

fal MCP 的配置预置于 .mcp.json、.codex/config.toml、.cursor/mcp.json、.vscode/mcp.json，内容对应根目录的 mcp.json：

{
  "mcpServers": {
    "fal": {
      "type": "streamable-http",
      "url": "https://mcp.fal.ai/mcp",
      "headers": { "Authorization": "Bearer ${FAL_KEY}" }
    }
  }
}

密钥配在这一节一起说清：去 fal 控制台申请 API Key，然后 export FAL_KEY=你的密钥。这一个 FAL_KEY 同时驱动 fal MCP 服务器和 um fal 命令，覆盖真透明背景的精灵图、PBR 贴图、图生 3D、自动绑定、音效、音乐、配音，直到过场视频。

30 秒自检

装没装好，30 秒见分晓，终端里跑两条：

um scan --list
um scan "Terraria"

第一条列出找到的已装游戏，第二条对单款游戏做体检：什么引擎、什么版本、代码托管还是原生、有没有反作弊、已装哪些 MOD 加载器、存档放在哪，以及推荐哪条 MOD 路线。每个命令组都带 --help 示例，随手可查。

顺手翻翻共享知识库，看别的代理有没有踩过同一个坑：

um kb search "terraria"

知识库是代理写给代理看的地方：收录了 4 篇真实游戏笔记（泰拉瑞亚、帝国时代 2、GTA V × Minecraft）和 3 篇通用技术笔记，每一篇都是 AI 代理做完实际任务后回写的，下一个人（或代理）接手时直接站在前人经验上，省去重复绕路。

下第一单

打开代理，直接说人话，比如：

给泰拉瑞亚加一枚追踪导弹，素材用 fal 生成。

代理从 skills/mod-any-game/SKILL.md 的主循环出发，固定走 10 步：

搜知识库：有没有现成路线和已知坑；
侦察选路线：用 um scan 的结果定 MOD 方案；
备份存档，建安全环境：动手之前先做快照；
读真实代码：只信引擎的实际实现，不信印象；
最小可跑切片：先让一个最小功能跑起来再扩张；
生成素材：AI 生成游戏素材——精灵、3D、音效全走 fal；
游戏内验证：在真实游戏里证明它成立；
录屏：抓带游戏音频的画面；
打包：把 MOD 整理成可分发形态；
写回笔记：把这次实战沉淀成字段笔记。

三个能直接跑的成品

仓库里附了三个装完就能翻的完整示例：

examples/terraria-tmodloader：泰拉瑞亚 Fal Arsenal——追踪导弹、能炸出坑的战术核弹、新敌人和双阶段 Boss，精灵全部来自 fal。
examples/aoe2-de-civ：帝国时代 2 新文明，单位经 fal 图生 3D，再按游戏机位渲染出 16 向精灵。
examples/minecraft-gta5-passthrough：GTA V 画面里跑真的 Minecraft，镜头跟随，Minecraft 的 TNT 能炸掉 GTA 的车。

边界与排错

⚠️ 安全红线内置在工具链里：只改你拥有、单机的游戏；拒绝带反作弊的在线客户端；动存档前自动备份；驱动你的鼠标键盘、发布内容之前会先征求同意。完整推理见 skills/mod-any-game/references/safety.md。

几个常见故障，按症状对：

um: command not found——插件安装或克隆会把它加进 PATH；找不到时执行 uv tool install git+https://gitcode.com/gh_mirrors/un/universal-modder，或临时 export PATH="$PWD/bin:$PATH"。
fal 调用报鉴权错误——检查 FAL_KEY 是否已导出、密钥是否还有效。
3D 转精灵失败——确认装了 Blender。
想给六大之外的代理接入——克隆仓库、在仓库内启动代理读 AGENTS.md 即可，或 npx skills add 只装技能。

开工

打开你的 AI 代理，说出想改的游戏和点子，剩下的交给它。贡献规则——笔记格式、硬性红线——在 CONTRIBUTING.md 里，更多模块细节看 README.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考