ESC
开源 2 分钟阅读

universal-modder：让 Claude Code 几乎能 Mod 任何 PC 游戏的开源项目

开源项目 universal-modder 为 Claude Code 提供 Skills、工具集和 fal MCP，可对几乎所有你拥有的 PC 游戏制作 Mod：自动侦察游戏与引擎、逆向工程、用 fal 生成美术/3D/音频、在运行中的游戏内测试并自动剪辑展示视频。内置 12 类引擎攻略，仅限单机游戏，MIT 协议开源。

来源：GitHub

universal-modder

让 Claude Code 几乎能给你拥有的任何 PC 游戏制作 Mod 的 Skills、工具和 fal MCP。
它会找到游戏，判断引擎和 Mod 路线，阅读真实代码，构建 Mod，
用 fal 生成美术、3D 和声音，在运行中的游戏里测试，并剪辑出展示视频。

Claude Code plugin assets by fal MIT

用 universal-modder 构建的 Terraria 战术核弹和帝国时代 II 的 Robotaxi

安装

作为 Claude Code 插件（推荐）：

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

或者克隆仓库并在其中运行 Claude（通过 AGENTS.md 也适用于 Codex/Cursor）：

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

然后为它提供一个 fal API key 用于生成资源。它同时为内置的 fal MCP 服务器和 um fal CLI 提供支持：

export FAL_KEY=...

你还需要 Python 3.10+ 和 ffmpeg。推荐使用 uv；CLI 会用它自建环境。3D → sprite 渲染需要 Blender。Windows 游戏可在原生环境或 WSL 中驱动。

试试看

给 Terraria 加一个追踪导弹发射器和一颗能把世界炸出弹坑的战术核弹。用 fal 制作 sprite。

为帝国时代 II 制作一个拥有由 3D 渲染的独特单位的新文明。

我拥有 Skyrim SE。要在其中加入 Minecraft 风格的方块建造模式需要做些什么？

C:\Games\Foo 是什么引擎，人们通常怎么给它做 Mod？

Claude 从 mod-any-game skill 开始，每次都运行同样的循环：侦察、选择路线、搭建安全的实验环境（备份存档）、阅读真实代码、构建一个可运行的最小功能切片、生成资源、在真实游戏中验证、录制，然后打包。

内含什么

Skills（skills/）

Skill功能
mod-any-game完整流程、硬性安全规则，以及 12 份引擎攻略：Unity、Unreal、.NET/XNA（Terraria、Stardew、Celeste）、Godot、Source 1/2、Bethesda、Minecraft、AoE2/Genie、RE Engine/FromSoft/GTA/Cyberpunk/BG3、原生 C++、独立引擎（GameMaker、RPG Maker、Ren’Py、Paradox、Doom、HTML5、LÖVE、Java）、复古游戏反编译
game-recon判断引擎与版本、托管还是原生、反作弊、加载器、存档文件夹、社区路线 → 输出 MODDING_PLAN.md
reverse-engineeringILSpy / Cpp2IL / Vineflower / Ghidra、通过 MCP 使用 IDA / Cheat Engine / Frida / RenderDoc；逆向文件格式并用往返验证证明结果
fal-assets带真实透明度的 sprite、风格一致的变体、像素画、无缝纹理、PBR 贴图、图像转 3D、自动绑骨、音效、音乐、配音、过场视频
asset-pipeline美术 → 引擎精确帧：抠图、最近邻适配、调色板、图集、队伍色遮罩、3D → 8/16 朝向 sprite
game-automation启动、截图（GPU 安全）、点击/输入、窗口化模式、崩溃报告清理、游戏内 agent 桥接
showcase-video只录游戏音频的窗口录制、挑选精彩瞬间、按 EDL 剪出风格化视频
mashup-mods游戏中的游戏：内容移植、透传 Mod、把反编译项目当库用、重新实现
publish-modLint、按平台打包、致谢、发布帖

um CLI（bin/um，Python）。每个命令都带 --help 和示例。

um scan查找 Steam/Epic/Xbox 安装；识别引擎与版本、.NET 还是原生、反作弊、已安装的加载器、存档文件夹、排序后的 Mod 路线
um falsprite、image、edit、rmbg、pixelate、upscale、texture、pbr、model3d、rig、sfx、music、voice、video、run、search、schema、price。纯 REST 实现，并带一份记录每次生成的 manifest
um spritecutout、fit、pixelate、palette、sheet、slice、frames、team-mask、seamless、preview
um render3d用 Blender 把 GLB → 按游戏相机参数渲染成 sprite 帧（aoe2、iso8、trueiso、topdown、side、turntable）
um winshot、record（gfxcapture + process-loopback 音频）、drive（只作用于游戏的输入）、ps、kill、launch、reg
um videocontact 图、compile（EDL → 带标题、卡点剪辑、配乐的视频）、mux、beats、first-frame
um backup对存档文件夹做快照、diff 和恢复
um publish check阻止发布游戏文件、反编译代码和泄露的密钥

还捆绑了：fal MCP 服务器（.mcp.json）、一个把 um 加入 PATH 的 SessionStart hook，以及 tools/win/ 中两个无需构建的 Windows 工具：WinDrive 输入和 ProcLoopback 纯游戏音频，均为内嵌 C# 的 PowerShell。

3D 路线：fal 概念图到 3D 再到 16 个 AoE2 朝向。2D 路线：fal 美术到抠图再到游戏中的 64x26 Terraria sprite

用它构建的作品

  • examples/terraria-tmodloader：tModLoader 的 Fal Arsenal。一个追踪导弹发射器、一颗战术核弹（弹坑 + 蘑菇云）、一把连锁闪电步枪、一把黑洞枪、一次轨道打击、三种新敌人和一个两阶段的 Drone Mothership Boss。每个 sprite 都来自 fal。
  • examples/aoe2-de-civ：帝国时代 II DE 的 San Franciscans。
    • 一个新文明，拥有 Robotaxi 独特单位和 Delivery Drones，按 AoE2 相机角度从 fal 图像转 3D 模型渲染而来。
    • 一个泛美金字塔奇观。
    • 一个逆向工程得到的 .sld sprite 写入器。

两者都始于一句提示词。从中总结出的非显而易见的经验都已写入 skills（skills/mod-any-game/references/case-studies.md）。

它遵守的规则

  • 仅限单人和离线，且必须是你拥有的游戏。 它拒绝向带反作弊的在线游戏注入、编写多人作弊，或绕过反作弊、DRM 或所有权检查。
  • 它绝不发布游戏文件或反编译代码。 Mod 以代码、你自己的资源、补丁或转换器的形式发布。
  • 它会在动存档之前先备份，并且只按 PID 结束进程。
  • 在以下操作前它会先询问：驱动你的鼠标和键盘、往游戏文件夹安装加载器，或发布。

完整推理见：skills/mod-any-game/references/safety.md。

致谢

  • 基于 Claude Code 给 Terraria 和帝国时代 II 做 Mod 的真实会话构建。
  • 资源：fal（GPT Image 2、Nano Banana 2、FLUX、Trellis 2、ElevenLabs……）。
  • 站在 tModLoader、genieutils-py、AoE2ScenarioParser、BepInEx、Harmony、UE4SS、REFramework、SKSE、Fabric、ILSpy、Ghidra 以及每一个为自己的游戏撰写文档的 Mod 社区的肩膀上。
  • 引擎攻略还参考了 2026 年 9 月那波 AI 构建 Mod 的浪潮，以及它们的作者在公开场合的讲解。

MIT 协议授权。字体：Space Grotesk 和 JetBrains Mono（SIL OFL）。