Universal-Modder：把 Claude Code 对准任何一款游戏，它就能帮你做 Mod

让 AI 写代码已经不稀奇了，但让 AI 真正「改游戏」是另一回事——它得先搞清这是哪款游戏、用的什么引擎、反编译要看哪里、美术资源从哪来，最后还得在真正跑起来的游戏里验证一遍。开源项目 Universal-Modder 把这一整套流程打包成了给 AI 编程智能体用的技能包，2026 年 9 月 30 日建仓，几天内冲到 2600+ 星，MIT 协议开源。

它的定位一句话说清：把你的 AI 智能体指向任何一款你拥有的 PC 游戏，它就能给你做出 Mod。兼容 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode，或者任何能读 AGENTS.md 的智能体。

它解决什么问题

做游戏 Mod 的痛点从来不是「写代码」本身，而是前面那一大堆脏活：这是 Unity 还是 Unreal？是 .NET 还是原生 C++？有没有反作弊？存档在哪？社区以前有没有人搞过？摸清这些之后，才能决定用哪种方式下手。这些「侦察 + 决策 + 踩坑」的工作，以前全靠人类翻论坛、看文档、试错，费时又劝退。

Universal-Modder 把每个环节都变成了智能体可以执行的技能：找游戏、认出引擎、规划路线、读真正的代码、做出能跑的最小切片、生成美术和 3D 资源、在游戏里实测、录演示视频，最后把学到的东西写成「现场笔记」留给下一个智能体。

工作循环

项目内置的核心技能叫 mod-any-game，每次任务都跑同一套九步循环：

先在知识库里搜一遍有没有人做过；
侦察游戏，选出修改路线；
搭一个安全的实验环境（先备份存档）；
读真正的游戏代码；
先做出一个能跑通的切片；
生成美术、3D、音效资源；
在真实游戏里验证；
记录过程；
打包发布，并写一篇现场笔记给下一个智能体。

内含的十一个技能

技能全部采用 Agent Skills 格式，放在 skills/ 目录下：

mod-any-game：完整循环 + 硬性安全规则，外加 12 套引擎剧本，覆盖 Unity、Unreal、.NET/XNA（Terraria、星露谷、Celeste）、Godot、Source 1/2、Bethesda、Minecraft、帝国时代 2 的 Genie 引擎，以及 RE Engine、FromSoft、GTA、赛博朋克、博德之门 3、原生 C++、各种独立引擎（GameMaker、RPG Maker、Ren’Py、Paradox、Doom、HTML5、LÖVE、Java）和复古反编译项目。
game-recon：查历史笔记、识别引擎和版本、判断托管还是原生、有无反作弊、装了什么加载器、存档文件夹在哪、社区有什么现成路线，最后产出 MODDING_PLAN.md。
reverse-engineering：用 ILSpy / Cpp2IL / Vineflower / Ghidra 和 IDA（走 MCP）/ Cheat Engine / Frida / RenderDoc，反编译文件格式并用一次「往返验证」证明它对了。
fal-assets：用 fal 生成带真实透明通道的精灵图、风格一致的变体、像素画、无缝贴图、PBR 材质、图生 3D、自动绑定骨骼、音效、音乐、语音和过场视频。
asset-pipeline：把美术资源处理成引擎能精确使用的帧——抠图、最近邻缩放到目标尺寸、调色板、精灵表、阵营色遮罩、3D 转 8/16 朝向精灵。
game-automation：启动游戏、GPU 安全的截图、安全地点击和输入、窗口化、清理崩溃报告器、游戏内智能体桥接。
showcase-video：只录游戏音频的窗口录制、挑高光时刻、按 EDL 剪出带风格的视频。
mashup-mods：游戏里套游戏——内容移植、直通 Mod（已跑通的例子是 Minecraft × GTA V）、把反编译项目当库用、重新实现。
publish-mod：按平台 lint、打包、写致谢、发帖。
share-field-notes：搜索知识库、写自己的笔记、提 PR。

给 AI 写给 AI 的知识库

项目的 knowledge/ 目录里存的不是文档，而是现场笔记——具体某款游戏实际是怎么被改 Mod、被反编译、被逆向的。每篇笔记都给出：实际能用的精确版本、选了哪条路线以及为什么、引擎真正在做什么、怎么验证的、以及踩过的坑（症状 → 原因 → 修法）。

关键在于：每个做完 Mod 的智能体都可以把自己的笔记提成 PR，于是下一个智能体不用再从零踩同样的坑。已经收录的有帝国时代 2 DE 的新文明、GTA V 里的 Minecraft 直通、以及 Terraria 的两个项目（一个是用强化学习打败克苏鲁之眼的智能体，一个是「Fal Arsenal」武器包）。相关的命令也很直白：

um kb search "grand theft auto"                 # 动手前先查前人成果
um kb new --game "Hades II" --title "A new boon god" --from-scan hades --agent "Codex (gpt-6)"
um kb check knowledge/games/hades-ii/a-new-boon-god.md
um kb pr knowledge/games/hades-ii/a-new-boon-god.md --yes    # 人工确认后再开分支、推 PR

um 命令行工具

除了技能，项目还带一个 Python 写的 um CLI，每个命令都有带示例的 --help。几个主力子命令：

um scan：找出 Steam / Epic / Xbox 的安装位置，识别引擎和版本、.NET 还是原生、反作弊、已装的加载器、存档文件夹，并给出排序后的修改路线。
um fal：调用 fal 做 sprite / image / edit / rmbg / pixelate / upscale / texture / pbr / model3d / rig / sfx / music / voice / video，纯 REST 调用，并留有每次生成的清单。
um sprite：抠图、适配尺寸、像素化、调色板、拼图集、切片、导出帧、阵营色遮罩、无缝化、预览。
um render3d：用 Blender 把 GLB 按游戏的镜头角度渲染成精灵帧，支持 aoe2 / iso8 / trueiso / topdown / side / turntable 等预设。
um win：截图、录制（画面捕获 + 进程回环音频）、只作用于游戏的输入驱动、进程管理、启动、注册表。
um video：生成缩略图、按 EDL 编译成带标题和踩点音乐的成品视频、混流、节拍检测、取首帧。
um backup：快照、对比、还原存档文件夹。
um publish check：发布前拦截游戏文件、反编译代码和泄漏的密钥。

三条已经跑通的实例

Terraria 的 Fal Arsenal：五种武器（追踪导弹发射器、能把地形炸出弹坑的战术核弹、连锁闪电步枪、黑洞枪、轨道打击），三个新敌人和一个两阶段无人机母舰 Boss。所有精灵图都由 fal 生成，做成 tModLoader 的 Mod，在游戏内实测，还录了视频，在 X 上拿到约 40 万播放。
帝国时代 2 DE 的新文明「San Franciscans」：带一个由 fal 图生 3D、再按 AoE2 镜头角度渲染成 16 朝向精灵的机器人出租车特色单位、送货无人机，以及一座泛美金字塔奇观，还顺手写了个逆向出来的 .sld 精灵写入器。
GTA V 里的真·Minecraft：一个 Fabric Mod 加一个 ScriptHookV + ReShade 插件，通过本地 WebSocket 交换镜头、地面和事件；把 Minecraft 的颜色和深度合成进 GTA 的画面里；Minecraft 的 TNT、箭和烟花变成 GTA 的爆炸和子弹，Minecraft 的生物还会和警察对打。

下图是它处理美术资源的两条典型路线——上面是「概念图 → 3D 模型 → 按 AoE2 镜头渲染出 16 个朝向」，下面是「生成图 → 抠图 → 精确适配成 64×26 的 Terraria 像素精灵 → 进游戏」：

它遵守的安全规则

这也是这类「让 AI 碰你电脑」的项目里最值得说的部分：

只面向单机和离线、且是你拥有的游戏。它拒绝注入带反作弊的在线游戏、拒绝写多人游戏外挂、拒绝绕过反作弊、DRM 或所有权校验。
绝不打包游戏文件或反编译代码。Mod 只以代码、你自己的资源、补丁或转换器的形式发布。
动存档前先备份，并且只按 PID 结束进程（避免误杀）。
动手前先问：驱动你的鼠标键盘、往游戏目录装加载器、发布或提 PR，都要先征得同意。

怎么开始

按你用的智能体选一种装法即可。例如 Claude Code 是 /plugin marketplace add rehan-remade/universal-modder 再 /plugin install universal-modder@universal-modder；Gemini CLI 是 gemini extensions install https://github.com/rehan-remade/universal-modder；只想用技能的话，任何智能体都能跑 npx skills add https://github.com/rehan-remade/universal-modder。要用它生成美术资源，需要在 fal.ai 申请一个 API Key。环境上需要 Python 3.10+ 和 ffmpeg，3D 转精灵还需要 Blender。

项目地址：github.com/rehan-remade/universal-modder，MIT 协议。如果你手上正好有一款想改的单机游戏，这大概是最省事的一次尝试入口了。

文章版权归作者所有，未经允许请勿转载。

THE END