universal-modder

📌 核心价值：让任意 AI 编码 Agent 改你玩过的 PC 游戏——读真代码、造 mod、用 fal 出素材、在真游戏里验证，还沉淀一份知识库给下一个 Agent

你告诉 Claude 或 Codex"给我做个能在 Terraria 里发射导弹的武器"，它不再让你写几千行 modding 代码，而是自己把游戏引擎摸清楚、写出可用切片、调 fal 画武器皮、在游戏里跑通，最后录下演示。这就是 universal-modder：一套 Agent Skill + 知识库 + CLI，把"AI 改游戏"从玄学变成一条 10 步可复制的流水线。

---

🚀 什么是 universal-modder？

universal-modder 不是一个游戏 mod，而是一盒"让 AI Agent 会改游戏"的工具。它把 Agent Skills（mod-any-game、game-recon、fal-assets 等 11 个 skill）、一个 共享知识库（AI 写的 field note，记录每个游戏到底怎么被改过、踩了哪些坑）和 um CLI（Python）打包在一起，配合 fal.ai 的生成 API，让 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 这类"读 AGENTS.md"的 agent 都能：

• 找到你本地装的游戏（Steam/Epic/Xbox），识别引擎、版本、是否有 anti-cheat、save 在哪、有没有现成 loader；
• 判断走哪条 modding 路线（Unity 打、.NET 反编译、GODOT 脚本、Minecraft Fabric、GTA V ScriptHookV 等）；
• 读游戏真代码，写出一个可用切片，再用 fal 生成贴图、3D、音效；
• 在正在运行的游戏里验证，录演示视频，把成果发布；
• 最后写一份 field note，开 PR 回知识库，让下一个 Agent 站在前人的坑上。

仓库地址：https://github.com/rehan-remade/universal-modder

它最大的卖点不是"AI 能改游戏"，而是"Agent 之间的知识能累积"——改过一次 Terraria 的坑，下次改 Minecraft 就不用重新试错。

---

✨ 核心功能一览

它装的不是一堆 API，而是 11 个 Agent Skill + 一个 CLI：

• mod-any-game：整个 10 步闭环 + 硬安全规则 + 12 个引擎 playbook（Unity、Unreal、.NET/XNA、Godot、Source 1/2、Bethesda、Minecraft、AoE2/Genie、RE Engine/FromSoft/GTA/Cyberpunk/BG3、原生 C++、独立引擎、复古解包）；
• game-recon：查已有 field note、引擎与版本、是否 managed/native、anti-cheat、loader、save 文件夹、社区路线 → 产 MODDING_PLAN.md；
• reverse-engineering：ILSpy / Cpp2IL / Vineflower / Ghidra / IDA + Cheat Engine / Frida / RenderDoc 走 MCP 反编译文件格式，并用"回传"证明；
• fal-assets + asset-pipeline：fal 生成带真透明底道的贴图、像素画、无缝纹理、PBR、image-to-3D、自动 rigging、音效、音乐、语音、cutscene 视频；再把 art 裁成引擎要的一帧帧；
• game-automation：启动游戏、GPU 安全截图、安全点击/输入、窗口模式、崩溃报告清理、游戏内 agent bridge；
• showcase-video：录窗口（只留游戏原音）、挑片段、从 EDL 剪出带标题和节拍切点的视频；
• publish-mod + share-field-notes：lint、按平台打包、署名、发 post；查知识库、写 note、开 PR。

um CLI 的常用命令（uv tool install 后就在 PATH 上）：

命令	干什么
um scan	找 Steam/Epic/Xbox 安装，识别引擎/版本/anti-cheat/save 文件夹，排好 modding 路线
um fal	sprite/image/edit/rmbg/pixelate/upscale/texture/pbr/model3d/rig/sfx/music/video 等，带生成清单
um sprite	cutout/fit/pixelate/palette/sheet/frames/seamless/preview
um render3d	Blender 把 GLB 沿游戏相机渲成 sprite 帧（aoe2/iso8/trueiso/topdown/side/turntable）
um win	shot/record（gfxcapture + 进程回环音）、drive（输入只进游戏）、launch、kill
um backup	save 文件夹 snapshot / diff / restore
um publish check	拦截发货游戏本体、反编译代码、泄的密钥
um kb	知识库：search / new / check / sync / pr

---

🛠️ 快速上手：5 分钟跑通示例

安装 / 注册

# 1. 装 CLI（uv tool install，或 pipx install）
uv tool install git+https://github.com/rehan-remade/universal-modder

# 2. 配 fal API key（fal 负责画贴图/3D/音效/视频）
export FAL_KEY=...

# 3. 依赖：Python 3.10+、ffmpeg；3D→sprite 渲染需 Blender
#    Windows 游戏原生驱动，或从 WSL 驱动

核心代码示例

它的工作方式一句话：查知识库 → 侦察 → 备份 → 读真代码 → 造一个切片 → 生成素材 → 真游戏验证 → 录视频 → 打包发布 → 回写 field note。下面这段是"改一个新游戏"的标准动作（来自 README）：

# 先查有没有人改过同一款游戏（field note = 前人的踩坑记录）
um kb search "grand theft auto"

# 开始一个新 mod：给游戏名 + note 标题
um kb new --game "Hades II" --title "A new boon god" --from-scan hades --agent "Codex (gpt-6)"

# 校验 note 格式/完整性
um kb check knowledge/games/hades-ii/a-new-boon-god.md

# 你（人）确认 OK 之后，才让它建分支、推送、开 PR
um kb pr knowledge/games/hades-ii/a-new-boon-god.md --yes

注意：um kb pr 需要你（人）点头才推送——它是刻意设计成"AI 写、人来把关"的。um publish check 还会直接拦截任何要发游戏本体、反编译代码或密钥的行为。

---

📊 与引擎框架的对比

传统 modding 是一引擎一套坑：改 Unity 要 Unity，改 Godot 要 Godot，改原生 C++ 游戏要 Ghidra 手搓，改 Minecraft 要 Fabric/BepInEx。你换个游戏，经验基本归零。universal-modder 把这套知识固化成 12 个引擎 playbook，让 Agent 换游戏时不是从零开始，而是"查一下知识库这条路线怎么走"：

引擎/平台	典型代表	modding 路线（playbook 覆盖）
.NET / XNA	Terraria、Stardew Valley、Celeste	反编译 + tModLoader 类 loader
Unity	大量独立游戏	Unity 脚本/asset 注入
Godot	独立游戏	Godot 脚本直接改
Source 1/2	CS/HL2	Source SDK / 脚本 hook
Bethesda	Skyrim	BepInEx / SKSE 类
Minecraft	Minecraft	Fabric / Forge
AoE2 / Genie	AoE2 DE	场景解析 + 反编译 sprite 写
RE Engine / FromSoft / GTA / Cyberpunk / BG3	GTA V、Cyberpunk 2077	ScriptHookV / REFramework 类
原生 C++ / 独立 / 复古	各类老游戏	Ghidra/IDA + Cheat Engine/Frida

关键差异：它不承诺"改所有游戏"，而是把"12 类引擎的改法"变成 Agent 可查的 playbook，并用知识库让经验跨游戏复用——这是纯框架给不了的。

---

💡 适用场景

场景 1：给老游戏加新武器/新文明

功能说明：这是它最出效果的一类用法。README 里三个已跑通的例子：Terraria（tModLoader） 里加了一把追踪导弹发射器、一枚能炸裂地形的战术核弹、链闪步枪、黑洞枪和轨道打击，还加了 3 个新怪和一只两阶段 Drone Mothership boss，每张贴图都来自 fal；AoE2 DE 里造了一个全新文明"San Franciscans"，有从 3D 渲成的 Robotaxi 独特单位和 Delivery Drones、一座 Transamerica Pyramid 奇迹，还反编译了 .sld sprite 写入器。输入要求：一个你拥有的、可单玩的 PC 游戏 + 一个 fal API key。 输出效果：能运行、能出效果、能录演示视频的 mod，且附一份带"每个不寻常的坑"的 field note。 适用场景：想给老游戏加新玩法、想学习某个引擎的 modding、想让 AI 帮你搭一套"可复制的改游戏流程"。

场景 2：跨游戏 mashup（把 A 游戏塞进 B 游戏）

功能说明：这是它最野的能力——mashup-mods 技能做的"游戏里的游戏"。README 的压轴例子是把真正的 Minecraft 塞进 GTA V 的剧情模式：用 Fabric mod + ScriptHookV/ReShade 加-on，通过本地 WebSocket 交换相机、地面和事件；Minecraft 的颜色和深度被 depth-composite 进 GTA 的帧；Minecraft 的 TNT、箭矢和烟火变成 GTA 里的爆炸和子弹，Minecraft 的怪还会跟 GTA 的警察打架。 输入要求：两个本地游戏 + 两个引擎各自的 loader（Minecraft 的 Fabric、GTA 的 ScriptHookV）。 输出效果：一个能在 GTA V 里打开 Minecraft、互相交互的 passthrough mod。 适用场景：想搞跨游戏融合、想试 mashup-mods 的 content port / passthrough / 解包库/重实现能力。

场景 3：让 AI 帮你把游戏 mod 变成可发布内容

功能说明：showcase-video + publish-mod 配合，让 Agent 不只改完就完事，而是录下演示、剪出带标题/节拍切点的视频、lint + 按平台打包 + 署名 + 发 post。publish check 会在发布前拦截游戏本体/反编译代码/密钥。 输入要求：一个已验证、可运行的 mod。 输出效果：可发布的 mod 包 + 演示视频 + 一篇带 field note 的说明。 适用场景：想把自己改的游戏 mod 真正发出去（modding 社区/展示），不想自己剪视频和打包。

用户群体总结

• ✅ 独立/老游戏 modding 爱好者：想快速加内容、不想啃引擎
• ✅ AI Agent 玩家/研究者：想验证"Agent 能否真正完成一个工程"
• ✅ 内容创作者：改完直接出演示视频可发
• ❌ 不适合：在线多人游戏、anti-cheat 环境、想改你不拥有的游戏、想绕过 DRM

---

💰 定价方案

开源协议： MIT（完全免费可商用）。

生成类素材（贴图、3D、音效、视频）走 fal.ai（GPT Image 2 / Nano Banana 2 / FLUX / Trellis 2 / ElevenLabs 等），按 fal 的付费生成计费——工具本身免费，画东西的钱算 fal 的。

新用户福利：工具 + 11 个 skill + um CLI 全免费；只需一个 fal API key 就能开始画素材，先拿免费额度试一把。

---

🎯 总结

universal-modder 不是"AI 改游戏"的口号，而是一条真正跑通、可复制、且带知识累积的流水线：它把 12 类引擎的改法写成 playbook、用 fal 出素材、在真游戏里验证、录视频、发布，还逼着 AI 写 field note 开 PR。GitHub 上 24 小时 914 星、当前 1,326★ 的热度，说明"让 Agent 真正能干工程"的需求是实的。它的边界也很清楚：只单玩家、只你拥有的游戏、不碰 anti-cheat、不发反编译代码——这些限制是它值得用的理由，不是缺点。

推荐指数： ⭐⭐⭐⭐（4/5）

适合人群： 想改自己 PC 游戏的 modding 玩家、想验证 Agent 工程能力的研究者、以及想做出"AI 改游戏"内容的创作者。

立即体验： https://github.com/rehan-remade/universal-modder（装 uv 后 uv tool install git+... 即可）

GitHub 仓库： rehan-remade/universal-modder

---

数据截至 2026-10-02，最新信息请以仓库 README 为准。