Universal Modder教程：让Claude Code/Codex自动给游戏做Mod，12套引擎攻略一键上手

哎，说到给游戏打 Mod，你是不是也头大？想给《泰拉瑞亚》加个新武器，得先学 tModLoader；想给《帝国时代2》换个文明，又得啃 Genie 引擎的文件格式；网上找教程，十篇有九篇是三年前的，版本早对不上了。

更别提美术资源了——没有像素画功底，做个新贴图歪歪扭扭，进游戏一眼假。

那有没有一种可能：把这事直接丢给 AI，你只负责说"我要一个能追踪敌人的导弹发射器"？

还真有。今天要讲的 Universal Modder（GitHub 开源，MIT 协议），就是干这个的——让 Claude Code、Codex、Cursor 这些 AI 编程助手，自动给你电脑上的单机游戏做 Mod：侦察游戏、逆向分析、写代码、生成贴图/3D/音效、进游戏实测、打包发布，一条龙全包。

一、它到底是什么来头？

先看基本盘：

说白了，它不是"一键改游戏"的傻瓜软件，而是一套给 AI 用的 Mod 技能包 + 工具链。你把任务描述给 AI，AI 按它内置的流程干活。它自带三样东西：

• Skills（技能）：10 个 Agent Skills 格式的技能文件，教 AI 怎么侦察游戏、怎么逆向、怎么做资产、怎么打包发布；
• um 命令行工具：Python 写的 CLI，负责扫描游戏、生成素材、截图录像、备份存档；
• knowledge 知识库：一份"AI 写给 AI"的实战笔记库，记录每款游戏具体怎么改的、踩过什么坑。

二、安装：两行命令的事

以最主流的 Claude Code 为例，打开 Claude Code 直接敲：

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

用别的助手也一样简单（官方 README 有完整对照表）：

还有几个前置条件别漏了：

# 1. um 命令行（插件安装会自动带上，手动装则用这行）
uv tool install git+https://github.com/rehan-remade/universal-modder

# 2. 生成素材需要 fal 的 API Key（官方 fal.ai/dashboard/keys 免费领）
export FAL_KEY=你的key

# 3. 基础依赖：Python 3.10+、ffmpeg；3D 转精灵图还需要 Blender

没 Key 也有退路：um comfy 可以走你本地的 ComfyUI 出图，一分钱不花。

三、上手实操：第一步先"侦察"你的游戏

装好后，打开 AI 助手，直接说人话就行：

> Mod Terraria：加一个追踪导弹发射器和一颗能炸出陨石坑的战术核弹，贴图用 fal 生成
> 给帝国时代2做一个新文明，独特单位用3D模型渲染成精灵图
> C:\Games\Foo 这游戏是什么引擎？以前有人改过它吗？

AI 会从 mod-any-game 技能起步，按固定套路走完这 10 步：

1. 查知识库（有没有人改过这游戏）
2. 侦察：识别引擎、版本、反作弊、加载器
3. 搭安全实验环境（存档先备份）
4. 读真实代码（不是瞎猜）
5. 先做出一个能跑的小切片
6. 生成素材（贴图/3D/音效）
7. 进游戏验证
8. 录屏
9. 打包
10. 写一份"田野笔记"留给下一个 AI

其中最实用的当属 um scan——它会自动扫你 Steam/Epic/Xbox 的安装目录，识别引擎指纹、.NET 还是原生、有没有反作弊、存档在哪，并给出推荐的改法路线。

四、核心能力：12 套引擎攻略 + 资产流水线

这套东西最狠的地方，是把 12 类引擎的改法攻略（playbook）直接写进了技能文件：

素材生成这块（um fal + um sprite）也很全：带真透明通道的像素贴图、无缝纹理、PBR 贴图、图片转 3D、自动绑骨、音效、BGM、配音，甚至过场视频。做完还能用 um render3d 借 Blender 按游戏视角把 3D 模型渲染成 8 方向/16 方向精灵图——这活以前没点美术功底根本做不了。

知识库里已经有社区用它跑出来的实战案例，含金量挺高：

• 把真的 Minecraft 塞进《传送门2》（相机跟随、TNT 能炸飞 GTA 的车是另一篇）
• 《光环3》的武器、载具、地图搬进 Minecraft
• 《艾尔登法环》离线版 CS2 风格改装（原生 Rust DLL）
• 泰拉瑞亚 tModLoader 的"法老军火库"：追踪导弹、战术核弹、黑洞枪、轨道打击

五、安全边界：哪些事它不碰

游戏 Mod 工具，大家最怕的就是封号和法律问题。这个项目在设计上划了几条线：

• 只针对自己拥有的、离线的单机游戏——不做多人作弊，知识库贡献规则明确写着"禁止作弊其他玩家"；
• 存档自动备份：um backup 支持快照、对比、一键还原；
• AI 动鼠标键盘前必须先问你，装加载器、发布 Mod 也要你点头；
• 发布前检查：um publish check 会拦截游戏原始文件、反编译源码、泄露的 Key，避免你无意中传播侵权内容。

说实话，这套"先备份、先确认、先检查"的设计，比市面上一堆来路不明的"一键修改器"靠谱多了。

六、常见问题

Q：完全不懂编程能用吗？
能，但前提是你会用 Claude Code / Cursor 这类 AI 编程工具。你负责描述需求，AI 负责干活。完全没接触过 AI 编程助手的，建议先花半小时熟悉一下这类工具再来。

Q：一定要付费的 fal Key 吗？
生成素材才需要。只想让 AI 改代码、改配置、不生成新美术，可以不配 Key；或者用本地 ComfyUI 替代。

Q：支持网游吗？
官方定位是"自己拥有的、离线的 PC 单机游戏"。带反作弊的网游不建议碰，风险自负。

下载地址

仓库源码包我已经下好传到自己网盘了，直接转存即可（当天所有软件都在这个文件夹里）：

官方仓库：https://github.com/rehan-remade/universal-modder