AIBit-探索开源项目 AIBit-探索开源项目

Universal Modder：让 AI 代理几乎可以修改任何 PC 游戏

Universal Modder 为 Claude Code 和其他 AI 代理提供一套可重复的工作流，用于侦察、逆向工程、资产创建、测试和游戏模组打包。

Universal Modder：让 AI 代理几乎可以修改任何 PC 游戏

游戏模组制作通常需要同时具备多种专业能力：识别引擎、定位正确文件、理解未公开格式、编写加载器或补丁、创建兼容资产、安全测试，以及记录最终成果。universal-modder 将这一工作流打包给 AI 编程代理，使它们能够系统地处理陌生 PC 游戏，而不是靠猜测完成一次性实验。

该项目支持 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode，以及其他能够读取 AGENTS.md 的代理。它的核心承诺并不是让每款游戏都能立即进行模组制作，而是为用户拥有的游戏提供一套可重复的调查与交付流程，并配备安全边界和共享知识库，在不同项目之间保留已有发现。

该项目为 AI 编程代理带来了什么

Universal Modder 结合了三个主要组件：

  • Agent Skills：用于侦察、逆向工程、资产流水线、自动化、视频制作和发布。
  • um 命令行工具：用于扫描安装内容、管理存档、生成资产、驱动 Windows 游戏，以及维护现场笔记。
  • fal MCP 服务器：用于生成精灵图、纹理、3D 模型、音效、音乐、语音和视频。

代理会遵循一致的循环：

  1. 搜索有关该游戏的现有知识。
  2. 侦察安装目录、引擎、版本、加载器、存档位置和反作弊情况。
  3. 选择可行的模组制作路径。
  4. 备份存档并建立安全的测试环境。
  5. 阅读实际代码或数据格式，而不是依赖假设。
  6. 构建一个小型可运行切片。
  7. 生成或适配所需资产。
  8. 在运行中的游戏里验证模组。
  9. 录制游戏演示。
  10. 打包成果，并为未来的代理编写现场笔记。

这一顺序非常重要。它让代理的行为更像是在文档化流程下工作的初级逆向工程师，而不是一个生成推测性代码的聊天机器人。

安装选项

对于 Claude Code，添加市场并安装插件：

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

Codex 使用：

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

Gemini CLI 可以直接安装扩展：

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

对于支持 Agent Skills 格式的代理：

npx skills add https://github.com/rehan-remade/universal-modder

也可以克隆仓库，然后在其中启动代理：

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder

仓库会在不同代理所需的位置放置指向共享 skills/ 目录的链接，包括 .agents/skills、.claude/skills、.gemini/skills 和 .github/skills。代理指令通过 AGENTS.md 提供，其中 CLAUDE.md 和 GEMINI.md 指向相同的指导内容。.mcp.json、Codex、Cursor 和 VS Code 均提供 MCP 配置。

CLI 也可以独立安装：

uv tool install git+https://github.com/rehan-remade/universal-modder
# 或
pipx install git+https://github.com/rehan-remade/universal-modder

你需要 Python 3.10 或更高版本，以及 ffmpeg。项目推荐使用 uv；将 3D 模型转换为精灵图渲染结果时，还需要 Blender。Windows 游戏可以原生控制，也可以从 WSL 控制。

使用 fal 生成游戏资产

Universal Modder 既通过 MCP 使用 fal，也通过 um fal 使用 fal。在生成资产前设置 API 密钥：

export FAL_KEY=your_key_here

fal 包装器提供图像和游戏资产制作命令，包括：

  • sprite、image、edit、rmbg、pixelate 和 upscale
  • 纹理和 PBR 贴图生成
  • 从图像创建 3D 模型
  • 绑定骨骼
  • 音效、音乐、语音和视频
  • 模型搜索、架构检查、定价和执行

生成的资产会通过清单进行追踪，这有助于复现和署名。独立的资产流水线随后会将通用生成输出转换为特定引擎所需的内容：透明抠图、最近邻像素艺术、调色板、精灵图表、队伍颜色遮罩、无缝纹理，以及匹配摄像机视角的 3D 渲染图。

例如，3D 工作流可以将 GLB 模型渲染成 8 帧或 16 帧的方向帧，用于《帝国时代 II》风格的摄像机视角。2D 工作流则可以把生成的艺术图转换为尺寸正确的《泰拉瑞亚》精灵图，例如 64x26 的游戏内资产。

技能覆盖完整的模组制作生命周期

mod-any-game 技能包含针对 12 类广泛引擎和技术生态的操作手册，包括 Unity、Unreal、Terraria 和 Stardew Valley 等 .NET/XNA 游戏、Godot、Source 1 和 2、Bethesda 游戏、Minecraft、AoE2/Genie、RE Engine、FromSoftware 游戏、GTA、Cyberpunk、《博德之门 3》、原生 C++，以及多个独立游戏和复古游戏生态。

其他技能负责专门工作：

  • game-recon：识别引擎、版本、加载器、存档文件夹和社区支持的路径。
  • reverse-engineering：涵盖 ILSpy、Cpp2IL、Vineflower、Ghidra、IDA、Cheat Engine、Frida 和 RenderDoc 等工具。
  • game-automation：启动游戏、捕获截图、驱动输入、处理窗口模式，以及清理崩溃报告程序。
  • showcase-video：录制仅包含游戏声音的音频、构建联系表，并根据 EDL 合成剪辑视频。
  • mashup-mods：支持跨游戏实验和透传架构。
  • publish-mod：检查软件包中是否包含禁止文件，并准备致谢和发布材料。

专为代理设计的知识库

knowledge/ 目录是仓库中最有用的构想之一。它存储描述特定游戏实际修改方式的现场笔记，包括：

  • 确实有效的具体版本
  • 选择的路径及其原因
  • 引擎实际执行的行为
  • 如何验证结果
  • 以“症状、原因、修复”形式记录的易错点

代理可以在开始新项目之前搜索这些材料：

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

贡献规则明确禁止提交游戏文件、反编译转储、能够实现在线作弊的材料，以及不诚实的验证声明。目标是在不让仓库成为受版权保护游戏数据或多人游戏作弊工具分发渠道的前提下，保留实用知识。

包含的示例

仓库包含三个大型示例。

Terraria tModLoader

名为 Fal Arsenal 的《泰拉瑞亚》示例加入了追踪导弹发射器、战术核弹、链式闪电步枪、黑洞枪、轨道打击、三种敌人，以及一个拥有两个阶段的无人机母舰 Boss。所有精灵图都使用 fal 生成，然后根据游戏的资产要求进行适配。

《帝国时代 II：决定版》

San Franciscans 示例加入了一个拥有 Robotaxi 独特单位、配送无人机和 Transamerica Pyramid 奇观的文明。单位由 fal 的图像转 3D 模型功能创建，并从游戏摄像机角度进行渲染。项目还包含一个逆向工程得到的 .sld 精灵图写入器。

GTA V 中的 Minecraft

最具野心的示例是在 GTA V 故事模式中放入真正的 Minecraft。一个 Fabric 模组与 ScriptHookV 加 ReShade 插件通过本地 WebSocket 通信。Minecraft 的颜色和深度信息会合成到 GTA 画面中，而 Minecraft 的 TNT、箭矢和烟花会变成 GTA 的爆炸物和子弹。Minecraft 生物甚至可以与警察交战。

这些示例表明，该仓库的目标不只是普通的配置调整。它支持源码级模组、资产转换、运行时桥接，以及边界经过谨慎限定的游戏混搭。

安全边界也是设计的一部分

Universal Modder 明确面向用户拥有的游戏，专注于单人和离线模组制作。其指令拒绝向带有反作弊系统的在线游戏注入内容、制作多人游戏作弊工具，或绕过反作弊、DRM 和所有权检查。

工作流还包括以下操作安全措施：

  • 修改存档前备份存档文件夹。
  • 按 PID 终止进程，而不是使用宽泛的进程终止命令。
  • 控制鼠标和键盘前先征求同意。
  • 将加载器安装到游戏目录前先征求同意。
  • 发布内容或创建拉取请求前先征求同意。
  • 使用 um publish check 阻止游戏文件、反编译代码和泄露的密钥进入发布包。

仓库采用 MIT 许可证，目前主要由 Python 构成，语言占比为 89.4% Python、10% PowerShell 和 0.6% Shell。um/ps1/ 中包含两个无需构建的 Windows 工具：用于受控输入的 WinDrive，以及用于捕获仅包含游戏声音的 ProcLoopback；两者都以嵌入 C# 的 PowerShell 脚本实现。

这个项目为何重要

有趣的转变在于，它不再是“让 AI 制作一个模组”，而是“为 AI 提供一个用于模组制作的工程系统”。侦察、版本追踪、备份、可重复的资产转换、游戏内验证和共享现场笔记，解决了那些通常在短演示中不可见的模组制作环节。

最终结果仍取决于游戏本身、游戏版本、社区工具，以及代理检查陌生代码的能力。不过，universal-modder 将这些依赖明确化了。对于关注 AI 辅助工具、逆向工程或程序化游戏内容的开发者来说，这是一个实用案例，展示了技能、MCP 工具、CLI 实用程序和积累的项目知识如何协同工作，形成一套面向代理的统一工作流。

仓库：rehan-remade/universal-modder

来源

rehan-remade/universal-modder：将 Claude 指向任何游戏。通过技能、工具和 fal MCP，让 Claude Code 几乎可以修改你拥有的任何 PC 游戏：侦察、逆向工程、fal 生成的艺术/3D/音频、游戏内测试和演示视频。