Universal Modder 怎么用：AI 做游戏 Mod 的安装、费用与反作弊红线

Universal Modder 是 GitHub 上的开源项目 rehan-remade/universal-modder：一组装进 AI 编程智能体的技能、一个叫 um 的命令行工具、fal 的托管 MCP 服务，再加一份由智能体写给智能体的“现场笔记”知识库。它自己不会打开游戏改东西，真正干活的是装了它的智能体，比如 Claude Code 或 Codex。能不能用起来，主要看三件事：你的智能体账号能不能用，让智能体自己进游戏测试主要靠 Windows 或 WSL，游戏本身不能是带反作弊的联网游戏。

先说清楚下文的证据范围。所有标着“实际运行”的命令输出，都来自 2026 年 10 月 6 日在一台 macOS 电脑上的真实运行：Claude Code 插件安装成功，um 的存档备份、贴图处理和发布检查在自建的测试文件上跑通。没有在任何真实游戏里扫描或做 Mod，没有装加载器，没有进游戏验证，也没有调用 fal 生成素材。文中出现的导弹、核弹、Boss 和新文明，都是作者仓库里的展示。

Universal Modder 是什么：给 AI 编程智能体用的游戏 Mod 工具包

截至 2026 年 10 月 6 日，这个仓库创建于 2026 年 9 月 30 日，MIT 许可，有 4,225 个 star，pyproject.toml 里的版本是 0.2.0，几乎每天都有新提交。仓库的自我介绍是：让 AI 编程智能体给你拥有的几乎任何 PC 游戏做 Mod。

它由四部分组成：

mod-any-game 每次都按同一套流程走：先搜知识库，侦察游戏并选路线，备份存档搭一个安全的实验环境，读游戏真实的代码，先做出一个能跑的最小改动，然后才生成素材、进游戏验证、录屏、打包，最后写一条现场笔记留给下一个智能体。

所以它不是“点一下就改游戏”的软件。你要用自然语言告诉智能体想做什么，智能体照着这些技能去查、去写、去试，每一步的结果取决于游戏引擎、现有 Mod 生态和智能体本身的能力。

作者在仓库里放了三个示例：Terraria 的 tModLoader 模组“Fal Arsenal”（追踪导弹发射器、会炸出弹坑的战术核弹、连锁闪电步枪、黑洞枪、轨道打击，3 种新敌人和一个两阶段 Boss，贴图全部由 fal 生成）；《帝国时代 II 决定版》的新文明“San Franciscans”，特色单位是 Robotaxi；以及把真正的 Minecraft 放进 GTA V 故事模式的联动 Mod。这些都是作者自己的展示。

两个容易混的名字：名字相近的“Claude Mods”是 Claude Code 自身的功能，和改游戏无关；GitHub 上的 drago-suzuki58/universal_modloader 是另一个项目。

实际运行范围：插件装上了，没有在任何游戏里做 Mod

下面是 2026 年 10 月 6 日的运行环境与结果。环境是 macOS 26、Python 3.12.1、Claude Code 2.1.288，仓库提交 76b9c7e。

没有做的事：扫描或修改真实游戏、安装 Mod 加载器、进游戏验证、调用 fal 生成任何素材（没有用 API key，也没有产生费用）、在 Windows 或 WSL 上运行、Blender 渲染、um video、在 Codex、Gemini CLI、Cursor 等其他智能体里安装。插件装好后也没有开对话让模型实际调用这些技能。

能不能用：先看智能体账号、Windows 和反作弊三个条件

依赖和 Windows 说明出自 universal-modder 的 README；Claude Code 的账号和系统要求出自 Claude Code 官方安装文档，它支持 macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+ 等系统，内存 4 GB 以上。

在国内能用吗

截至 2026 年 10 月 6 日，Anthropic 支持地区列表里没有中国大陆和香港，而 Claude Code 要求在支持地区使用，所以“装 Claude Code 版插件”这条路在国内首先卡在账号上。国内怎么接入 Claude Code，见 Claude Code 国内使用指南：安装、注册、中转和稳定接入怎么选。README 列出的 Codex、Gemini CLI、Copilot、Cursor、OpenCode 各有自己的账号和地区规定，需要按你实际用的那个分别确认。

Mac 和 Linux 能用到哪一步

在 Mac 上，插件安装、um kb、um backup、um sprite、um publish check 都能正常运行；卡住的是让智能体自己操作游戏这一步。实际运行（macOS，2026 年 10 月 6 日）：

$ um win ps
um: `um win` drives Windows games (native Windows or WSL). On Linux use xdotool/ydotool + ffmpeg x11grab/pipewire; on macOS use screencapture + ffmpeg avfoundation (see skills/game-automation).
# exit=1

负责游戏自动化的 game-automation 技能自己写明“以 Windows 为主（也支持 WSL），附有 Linux 和 macOS 的说明”。也就是说，在 Mac 和 Linux 上，智能体只能改用 screencapture、xdotool 这类工具去截图和输入，或者干脆由你进游戏试。很多 PC 游戏本来就只有 Windows 版，这一点在选游戏时也要算进去。

在 Claude Code 里安装插件：两条命令和实际输出

还没装 Claude Code 的话，先看 Claude Code 安装教程：全平台完整设置指南（2026）。

README 给出的命令（在 Claude Code 会话里输入）：

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

实际运行的是终端里的等效子命令（Claude Code 2.1.288，macOS，2026 年 10 月 6 日，输出有删节）：

$ claude plugin marketplace add rehan-remade/universal-modder
Adding marketplace…Cloning via SSH: git@github.com:rehan-remade/universal-modder.git
...
✔ Successfully added marketplace: universal-modder (declared in user settings)

$ claude plugin install universal-modder@universal-modder
✔ Successfully installed plugin: universal-modder@universal-modder (scope: user)

$ claude plugin list
  ❯ universal-modder@universal-modder
    Version: 76b9c7e77ead
    Scope: user
    Status: ✔ enabled

这三条命令都不需要先登录 Claude 账号；但要让插件里的技能真正干活，还是得登录后开会话。这台电脑配置了 GitHub SSH 密钥，所以克隆走的是 SSH；没有配 SSH 密钥的电脑会怎样，这次没有测到，如果卡在克隆这一步，可以先检查 GitHub 连接。插件缓存目录里自带的 bin/um 在没有 uv、只有系统 python3 的情况下也能运行，--version 输出 universal-modder 0.2.0。

插件带来的技能和 Claude Code 自己的 hooks、斜杠命令有什么区别，可以参考 Claude Code Hooks、Skills 与斜杠命令：区别、选型和最小配置。

其他智能体和只装命令行的方式

以下全部是 README 原文，都没有实际运行：

设置 fal API key

生成素材要在 fal 的 API key 页面创建 key，然后按 README 的写法 export FAL_KEY=...。没设置 key 时，um fal 会直接退出，不会产生费用。实际运行：

$ um fal price fal-ai/trellis-2
um: FAL_KEY is not set. Create a key at https://fal.ai/dashboard/keys and `export FAL_KEY=...` (or put FAL_KEY=... in a .env file here)
# exit=1

改游戏之前：用 um scan 查路线，用 um backup 备份存档

um scan --list 会找本机 Steam、Epic、Xbox 装的游戏；按源码，它在 Mac 和 Linux 上也会去 Steam 的默认目录找。运行的那台 Mac 没装游戏，所以结果是空的。实际运行（末尾的路径占位符用省略号代替）：

$ um scan --list
no Steam/Epic/Xbox installs found; pass a game folder to `um scan ...`

动手前先搜知识库，看别人在这款游戏上走过什么路。实际运行（输出有删节）：

$ um kb search terraria
games/terraria/fal-arsenal-tmodloader.md
   Fal Arsenal: missiles, a tactical nuke, new enemies and a boss for Terraria  [Terraria | xna-fna | loader-api | working]
games/terraria/eye-of-cthulhu-rl-agent.md
   An RL agent that beats the Eye of Cthulhu: decompiled boss AI to a simulator, then back into the real game  [Terraria | xna-fna | loader-api | working]
techniques/driving-real-games-safely.md
...

拿仓库里的 Terraria 示例文件夹跑 um scan，它给出的第一条路线是 tModLoader（Steam 上的免费应用 1281930），第二条是代理 DLL 加函数钩子。这里扫的是示例源码而不是游戏安装目录，所以引擎显示为未知，路线是按游戏名匹配出来的。实际运行（路径已简化，输出有删节）：

$ um scan universal-modder/examples/terraria-tmodloader
  engine:    Unknown native engine  [10%]  evidence: no known engine signature
  anti-cheat: none found
  loaders:   none installed
  routes:
    1. tModLoader (free Steam app 1281930): C# ModItem/ModNPC/ModProjectile/ModSystem, hot reload from ModSources  (known game; read references/engines/dotnet-xna.md)
    2. proxy-DLL loader + function hooks (MinHook/SafetyHook), memory reading; Ghidra/IDA + x64dbg + Cheat Engine  (engine: Unknown native engine; read references/engines/native.md)

备份存档是这套工具要求在改动前必须做的一步。下面是在一个装着假存档文件的 saves 文件夹上跑的完整往返：先备份，然后改动 world1.wld、新增 world2.wld，再对比、还原。实际运行（路径已替换为通用写法，diff 只保留对比结果字段）：

$ um backup create saves --name demo-saves
~/.universal-modder/backups/demo-saves/20261006-210035.zip  (1 files, 0.0 MB)

$ um backup diff demo-saves saves
{
 "added": ["world2.wld"],
 "removed": [],
 "changed": ["world1.wld"]
}

$ um backup restore demo-saves --yes
restore 20261006-210035.zip -> saves: 1 changed, 0 missing, 1 new since (new files kept)
~/.universal-modder/backups/demo-saves-pre-restore/20261006-210112.zip  (2 files, 0.0 MB)
restored 1 files

有两个细节值得记住。还原前它会先把当前状态另存为 demo-saves-pre-restore，所以还原本身也能撤销；备份之后新出现的文件默认保留，只有加 --clean 才会删除。快照放在你用户目录下的 ~/.universal-modder/backups/，不在游戏文件夹里。

要花多少钱：智能体订阅另算，fal 默认一张贴图 $0.211

仓库本身是 MIT 开源、免费的，但真正用起来有两笔钱。

第一笔是智能体。Claude Code 需要付费套餐或 Console 账号，Claude.ai 免费版不包含 Claude Code。各套餐怎么选，见 Claude Code 价格 2026：Pro、Max、Team、API 和额外用量怎么选。用 Codex 等其他智能体，同样按那家的规则计费。

第二笔是 fal 素材费，按次计价。下面是 2026 年 10 月 6 日 fal 模型页上的美元标价，对应 um fal 当前提交里的默认模型：

价格来自 fal 的模型页面：Nano Banana 2、GPT Image 2、Trellis 2、ElevenLabs Sound Effects v2。这些页面不标日期，价格和默认模型都可能变，um fal price 加模型名可以在设置 key 后查当前价格。

按这些标价算一个小型 Mod 的素材预算：10 张贴图、1 张主视觉图、1 个 3D 模型（按 $0.30 的中间档）、5 段各 2 秒的音效。

• 默认设置：10 × $0.211 + $0.08 + $0.30 + 5 × 2 × $0.002 = $2.51
• 贴图改用 --quality medium：10 × $0.053 + $0.08 + $0.30 + $0.02 = $0.93
• 贴图改用 --quality low：10 × $0.006 + $0.08 + $0.30 + $0.02 = $0.46

这是一次性生成、不重画的标价，不是实际账单。素材通常要重画几次才满意，重画两三次，贴图那部分就是两三倍。贴图占了默认预算的大头，而 Terraria 这类像素游戏最后要把 1024×1024 的图缩成几十像素见方的小图，先用 medium 试效果再决定要不要 high，是比较省钱的顺序。

fal-assets 技能也要求智能体：批量生成 3D、视频或长音乐之前先查价格，超过约 20 次生成或涉及视频时，先把大致费用告诉你。视频和音乐的价格上表没有列出，跑这两类之前务必先查。

哪些游戏不能碰：带反作弊的联网游戏和 DRM 校验

README 的规则写得很直接：只做你拥有的游戏，单机、多人或你自己架的服务器都可以；拒绝往带反作弊的联网游戏里注入代码，拒绝写针对其他玩家的作弊，拒绝绕过反作弊、DRM 或所有权校验。

仓库里的 safety.md 安全规则把下面这些反作弊列为“停止注入”的信号：EasyAntiCheat、BattlEye、Vanguard、EA Javelin、Ricochet、ACE、nProtect、XIGNCODE、mhyprot。允许的做法有两种：游戏官方的 Mod 渠道（创意工坊、地图编辑器、官方 Mod 工具），以及官方提供、本身不带反作弊的离线模式。规则里的例子是《艾尔登法环》通过 ModEngine2 或 me3 在关闭 EAC 的离线状态下启动，称这是社区通行做法。Valve 的 VAC 会封禁在 VAC 服务器上使用改动客户端的账号，规则要求本地测试用 -insecure 启动，注入状态下绝不进公共服务器。

其他几条会直接影响你的电脑和存档：

• 改存档前先备份，结束进程只按 PID 精确结束。
• 操作你的鼠标键盘、往游戏目录里装加载器、发布 Mod（包括提 PR）之前，都要先问你。
• 不发布游戏文件、提取出来的素材或反编译代码；Mod 只以你自己的代码、素材、补丁或转换器的形式发布。
• 加载器只从官方仓库和正式发布页下载，规则原话提醒：爆火 Mod 的“下载”经常是恶意软件。

发布前的检查是能实际跑的。下面在一个放了 .env（里面写着 FAL_KEY）、没有 README 的测试文件夹上运行：

$ um publish check mymod
FAIL  env file (secrets?): .env
FAIL  FAL_KEY assignment in .env
WARN  no README (install steps, requirements, credits)
FAIL: 3 files, 2 failures, 1 warnings
# exit=1

要注意，这些规则是写给智能体的指令，靠智能体遵守技能来执行，不是技术上锁死的开关；智能体会不会在每种情况下都拒绝，这次没有测试。规则文件也写明“这些都不是法律建议”，并举了两个例子：Take-Two 在 2021 年让 GitHub 下架了逆向还原的 GTA III 和 Vice City 代码 re3、reVC，Activision 在 2024 年向 H2M 模组发了停止侵权函。涉及收费、商用或泄露内容时风险更高，发布之前先看这款游戏发行商的 Mod 政策。

universalmodder.org 是官网吗：GitHub 仓库没有指向它

universalmodder.org 这个域名的 whois 注册日期是 2026 年 10 月 5 日，比仓库创建晚 5 天。GitHub 仓库的主页字段是空的，仓库文件里也没有提到这个域名。截至 2026 年 10 月 6 日，这个网站的介绍文字与 README 大体相同，链接回 GitHub 仓库，另有订阅和联系表单，没有单独的下载。

谁在运营它无法确认，也没有证据说它有恶意。但官方仓库没有指向它，安装只认 GitHub 上的 rehan-remade/universal-modder，不要从任何网站下载“安装包”或加载器。

第一次用的顺序：先做一个能跑的小改动，再花钱生成素材

1. 选一款自己拥有、没有联网反作弊的单机游戏，最好是知识库里已经有现场笔记的那种。
2. 只从 GitHub 安装插件，确认 claude plugin list 显示已启用。
3. 让智能体先跑 um scan 和 um kb search，看它识别出的引擎、反作弊和推荐路线；路线需要绕过保护时就停。
4. 用 um backup create 备份存档，并记下还原命令。
5. 先让智能体做出一个能跑的最小改动，比如一件新物品，用占位贴图进游戏确认能加载。
6. 确认能跑之后再设置 FAL_KEY 生成正式素材，贴图先用 medium 试。
7. 想发布时先跑 um publish check，再看游戏发行商的 Mod 政策。

README 里给的示例指令是这样写的（原文为英文）：“给 Terraria 做 Mod：加一个追踪导弹发射器和一个能把世界炸出弹坑的战术核弹，贴图用 fal 生成。”第一次用，可以把需求缩得更小，只要一件武器。

如果你想先了解 Claude Code 通用的技能和 MCP 怎么挑，可以看 Claude Code 最值得先用的 Skills（2026）：按工作流选官方起步路径 和 Claude Code 最值得先加的 MCP（2026）：按工作流选第一批集成。

Universal Modder 的几个具体问题：Minecraft、封号和免费用法

Claude Code 能用 Universal Modder 做 Minecraft Mod 吗？

技能里有 Minecraft 的引擎打法，作者的 Minecraft × GTA V 联动示例用的是 Fabric 模组，知识库里也有 Halo、Bloons TD 6 等内容移植进 Minecraft 的社区笔记。这些都是仓库里的记录，能不能在你的版本上复现，要看智能体实际读代码和测试的结果。

用 Universal Modder 改游戏会被封号吗？

单机游戏和你自己架的服务器风险最低；带 EasyAntiCheat、BattlEye、Vanguard 等反作弊的联网游戏，仓库的安全规则写明，往这类联网客户端里注入代码违反服务条款、会导致封号，所以要求智能体在这类情况下停手。VAC 游戏本地测试要用 -insecure 启动，注入状态下不要进公共服务器。

Universal Modder 能完全免费用吗？

仓库免费，但智能体本身要付费账号（Claude Code 不含在 Claude.ai 免费版里）。素材方面，不设 fal key 时，um comfy 可以调用你本机的 ComfyUI 生成图片，不走 fal 计费；3D、音效、视频仍要靠 fal 或你自己准备。

新手先拿哪款游戏练手比较好？

Terraria 是现成资料最多的一个：知识库里有完整的现场笔记，um scan 给出的路线是免费的 tModLoader，作者的“Fal Arsenal”示例代码也在仓库里。用自己正版的 Terraria，先照着做一件小物品，比直接挑战 GTA V 这类大型游戏更容易看清整个流程。