universal‑modder.dev
★ 5.8k
ZH

独立指南 · 数据实时来自 GitHub

Universal Modder：让你的 AI Agent 去改你拥有的任何游戏。

universal-modder 是一个免费的开源工具包，教 Claude Code、Codex、Cursor 和 Gemini CLI 如何给 PC 游戏做 Mod：识别引擎、逆向代码、用 fal 生成美术、3D 和音效、在运行中的游戏里测试，并为下一个 Agent 留下笔记。

安装教程浏览 42 款游戏GitHub ↗
  • 5.8kGitHub 星标
  • 78篇游戏实战笔记
  • 12套引擎手册
  • 6种支持的 Agent

已与 GitHub 同步 2026年10月9日

由 AI Agent 借助 universal-modder 制作的 Mod。片段来自项目 README（MIT）。

它是什么

一套 Agent 能照着做的 Mod 方法，而不是“一键生成 Mod”按钮

Universal Modder 由 11 个 Agent Skills、um 命令行工具、fal MCP 服务和一个由 Agent 写给 Agent 的共享知识库组成。作者 Rehan 把 Claude Code 实际改 Terraria、帝国时代 II 和 GTA V × Minecraft 的经验整理成了它，并于 2026年9月30日 以 MIT 协议开源。

真正干活的仍然是你的 Agent。工具包给它提供引擎手册、工具和前人经验，让它不再瞎猜：该用哪个加载器、存档在哪、引擎实际怎么运作、怎么确认 Mod 真的生效了。

AI Modder 是怎么工作的 →

安装

选择你的 Agent

每种安装方式都会得到同样的技能、fal MCP 服务和 um 命令行工具。

Claude Code

/plugin install universal-modder@universal-modder

分步教程 →

Codex

codex plugin add universal-modder@universal-modder

分步教程 →

Gemini CLI

gemini extensions install https://github.com/rehan-remade/universal-modder

分步教程 →

Cursor

Cursor Marketplace，或克隆仓库

分步教程 →

VS Code / Copilot

Chat: Install Plugin From Source

分步教程 →

OpenCode

克隆后在目录里运行 opencode

分步教程 →
claude code · 最快上手
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

工作原理

每个游戏都走同样的 10 步流程

无论你提什么需求，mod-any-game 技能都会按这个流程走。

  1. 检索知识库从其他 Agent 已经摸清的游戏或引擎经验出发。
  2. 侦察并选路线引擎、版本、加载器、反作弊和存档 → 生成 MODDING_PLAN.md。
  3. 搭建安全实验环境先备份存档，用独立配置，固定窗口大小。
  4. 阅读真实代码用 ILSpy、Ghidra、Cpp2IL、Frida 看代码，而不是猜。
  5. 先做通一个切片一个物品、单位或机制先端到端跑通，再扩展。
  6. 生成素材用 fal 生成精灵图、贴图、3D、音效和音乐，并适配引擎格式。
  7. 在真实游戏里验证在运行中的游戏里截图、看日志、跑测试场景。
  8. 录制只录游戏窗口和游戏本身的声音。
  9. 打包检查是否夹带游戏文件、反编译代码和泄露的密钥，然后发布。
  10. 写实战笔记把踩过的坑和确切版本写回知识库。
3D 路线：fal 概念图 → fal 3D 模型 → um render3d 渲染出帝国时代 II 的 16 个朝向。2D 路线：fal 美术 → 抠图 → 64x26 精灵图 → 在 Terraria 中生效。
素材管线：fal 美术 → 抠图 → 引擎精确尺寸的精灵图，或 fal 3D → 渲染 16 个朝向。图片来自 universal-modder README（MIT）。

游戏库

42 款游戏，78 篇实战笔记

每个游戏页面都列出 Agent 实际做出了什么、哪些版本可用、踩了哪些坑。

全部游戏 →

World of Warcraft

10 篇笔记 · 9 个可用 · 最近 2026-10-04

Custom AzerothCore modules for a solo-with-bots WotLK server: offline gathering, auction payout and restock, mail and progression fixes

Test Drive Unlimited 2

7 篇笔记 · 1 个可用 · 最近 2026-10-06

TDU2 vehicle physics: the Havok 5.5.0 packfile format inside .bnk containers

Baldur's Gate 3

6 篇笔记 · 6 个可用 · 最近 2026-10-05

Weapons: porting a Skyrim dagger and scabbard, fixing a modded sword's sheath height with a Dummy_Sheath bone, and visible stowed shields for modded shields

Minecraft

6 篇笔记 · 6 个可用 · 最近 2026-10-07

Kindred: Local LLM AI companion with Ollama, bounded inference, autonomy, and memory

Watch Dogs

4 篇笔记 · 1 个可用 · 最近 2026-10-06

Watch Dogs 1: editing .feu/.gfx UI components and rebuilding entitylibrary_rt.fcb

Assassin's Creed IV Black Flag

2 篇笔记 · 1 个可用 · 最近 2026-10-06

A visible, driven second character in AC4 single-player (co-op ghost avatar)

Dragon's Dogma 2

2 篇笔记 · 2 个可用 · 最近 2026-10-05

Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)

Half-Life

2 篇笔记 · 1 个可用 · 最近 2026-10-05

Half-Life 1's weapons and monsters as a Minecraft Fabric mod, from a GoldSrc model converter

Naruto Shippuden: Ultimate Ninja Storm 4

2 篇笔记 · 1 个可用 · 最近 2026-10-05

Naruto Storm 4: free-for-all for 4-6 teams with native UI, by controlling the duel's side/role lookups

Palworld

暂无实战笔记 · 虚幻引擎 5

该从哪里入手，以及它和 UEVR“通用 VR Mod”有什么不同。

费用

代码免费，素材按量付费

在 fal 上一张默认精灵图约 $0.21，一个 3D 模型 $0.25–0.35，音效 $0.002/秒。一个小 Mod 的素材费通常只要几美元。

费用计算器 →

安全

只改你自己的游戏，不碰别人的对局

不绕过反作弊、不做针对其他玩家的外挂、不发布游戏文件，先备份存档，接管鼠标键盘前会先问你。

规则与封号风险 →

对比

对比普通 Agent、加载器和同名项目

它和直接用 Claude Code、BepInEx/UE4SS、Vortex/MO2 以及名字相近的 universal-game-modder 有什么区别。

查看对比 →

GitHub 最新动态

最近有哪些更新

完整更新日志 →

常见问题

Universal Modder 是什么？

Universal Modder（GitHub 上叫 universal-modder）是一个开源工具包，包含一组 Agent Skills、名为 um 的 Python 命令行工具、用于生成美术/3D/音频的 fal MCP 服务，以及一个共享的实战笔记知识库。它们一起教 AI 编程 Agent 如何给你拥有的 PC 游戏做 Mod：识别引擎、选择路线、阅读真实代码、构建 Mod、在运行中的游戏里测试，并把经验记录下来。

Universal Modder 免费吗？

工具包本身免费，MIT 协议。你仍需为 AI Agent 付费（例如用 Claude Code 需要 Claude Pro 或 Max 套餐）；如果要生成精灵图、3D 模型或音效，还需要支付 fal API 费用。一个小 Mod 的素材通常只要几美元。详见费用说明。

Universal Modder 支持哪些 AI Agent？

Claude Code、OpenAI Codex、Gemini CLI、VS Code 中的 GitHub Copilot、Cursor 和 OpenCode 都有官方说明的安装方式。其他 Agent 也可以通过克隆仓库或 npx skills add 安装技能来使用。详见安装教程。

它真的能改任何游戏吗？

没有工具能真正改动每一款游戏。它内置 12 套引擎手册（Unity、Unreal、.NET/XNA、Godot、Source、Bethesda、Minecraft、帝国时代 II、RE 引擎/FromSoft/GTA 等）和一个真实尝试的知识库。能做到什么程度，取决于引擎、是否有现成的 Mod 加载器，以及游戏的防护程度。带反作弊的联网游戏按设计不在范围内。

用它会被封号吗？

技能会要求 Agent 拒绝修改带反作弊的联网游戏、拒绝做针对其他玩家的外挂和绕过 DRM，并在动存档前先备份。请留在单机、离线模式或你自己架设的服务器里。这些是给 Agent 的指令，而不是技术锁，所以最终责任仍在你。详见安全页。

Universal Modder 能在 Mac 或 Linux 上用吗？

安装、知识库、精灵图处理、备份和发布检查都能在 macOS 和 Linux 上运行。游戏自动化部分（um win：启动、截图、输入、录制）只支持 Windows，原生或通过 WSL。反正大多数 PC 游戏本来就是 Windows 游戏。

universal-modder.dev 是官方网站吗？

不是。这是一份独立指南。唯一的官方来源是 GitHub 仓库 rehan-remade/universal-modder，项目没有列出官方网站。请从那里安装；本站不会向你索要任何密钥、付款或单独下载。

它和 universal-game-modder 或“通用 VR Mod”是一回事吗？

不是。universal-game-modder 是发布在 npm 上的一个无关的 MCP 服务；大家给 Palworld 用的“通用 VR Mod”是 UEVR。详见 Universal Modder 与 universal-game-modder 对比。