Universal Modder Skill 技能

让 Claude Code 化身游戏 Modding 工程师的 Agent Skill。说一句自然语言，它就能全自动完成：识别游戏引擎 → 制定 Mod 方案 → 用 fal 生成美术素材（2D 精灵、3D 模型、音效、配乐）→ 在真实游戏中验证 → 录屏打包成展示视频。整个过程不需要用户懂引擎、会写代码、或手动操作任何工具。

核心能力

• 12 套引擎攻略：内置 Unity、Unreal、.NET/XNA（Terraria/Stardew/Celeste）、Godot、Source 1/2、Bethesda、Minecraft、Age of Empires II、RE Engine/FromSoft/GTA/Cyberpunk/BG3、原生 C++、独立游戏引擎（GameMaker、RPG Maker、Ren'Py、Paradox、Doom、HTML5、LÖVE、Java）以及复古反编译的完整操作手册，覆盖绝大多数 PC 游戏。
• 9 个专用 Skill：mod-any-game（主流程）、game-recon（游戏识别）、reverse-engineering（代码逆向）、fal-assets（AI 素材生成）、asset-pipeline（素材格式转换）、game-automation（游戏自动化）、showcase-video（成品录制）、mashup-mods（游戏内嵌内容）、publish-mod（发布审核）。
• um CLI 工具：scan（扫描游戏）、fal（调用 fal 素材生成）、sprite（精灵处理）、render3d（3D → 精灵渲染）、win（截图/录屏/输入）、video（合成视频）、backup（存档快照）、publish check（发布合规检查）。
• fal MCP 服务器：内置 .mcp.json，可直接在 Claude Code 中调用 fal 平台（GPT Image 2、Nano Banana 2、FLUX、Trellis 2、ElevenLabs 等）生成素材，无需额外配置。
• 安全规则：仅限单人离线游戏、从不打包游戏文件或反编译代码、操作前自动备份存档、鼠标键盘操作前请求确认。

安装配置

1. 方式一（推荐）：在 Claude Code 中运行 /plugin marketplace add rehan-remade/universal-modder && /plugin install universal-modder@universal-modder
2. 方式二：克隆仓库后直接在其中运行 claude（同样支持 Codex / Cursor）
3. 方式三：pipx 或 pip 安装 pipx install git+https://github.com/rehan-remade/universal-modder.git
4. 配置 fal API Key：在 fal.ai/dashboard/keys 获取 Key，运行 export FAL_KEY=你的Key
5. 依赖：Python 3.10+、ffmpeg、（3D 渲染需 Blender）

使用步骤

1. 描述需求：对 Claude Code 说出你想做的 Mod，例如：给 Terraria 加一个追踪导弹发射器和一枚战术核弹，用 fal 生成精灵
2. 游戏识别：mod-any-game Skill 自动扫描本地游戏（Steam/Epic/Xbox），识别引擎、版本、反作弊情况，生成 MODDING_PLAN.md
3. 方案制定 + 代码读取：reverse-engineering Skill 调用 ILSpy/Ghidra/IDA 读取真实游戏代码，确定 Mod 插入点
4. 构建 Mod：在备份存档的隔离环境中编写 Mod 代码，通过 fal-assets 生成所有美术素材
5. 游戏验证 + 录屏：game-automation Skill 在真实游戏中启动并截图验证，showcase-video Skill 截取精彩镜头、剪辑配乐
6. 发布：publish-mod Skill 完成合规检查，按平台打包发布

适用场景

• 游戏玩家为自己的单机游戏制作 Mod，无需学习引擎或逆向工程
• AI 编程能力展示：用一条自然语言指令端到端完成一个有形、可运行、有展示视频的 Mod
• 游戏 Mod 社区内容创作者批量生产高质量 Mod 素材
• AI Agent 研究者验证 agent 在复杂多步骤现实任务中的规划与执行能力
• 独立游戏开发者快速生成原型素材

适用人群

游戏玩家、AI 编程学习者、Mod 创作者、独立游戏开发者、AI Agent 研究者

工作原理

Universal Modder 以 mod-any-game Skill 为核心，驱动一套固定的工作循环：Recon（识别引擎）→ Pick Route（选择方案）→ Safe Lab（隔离环境 + 存档备份）→ Read Code（读取真实代码）→ Build Mod（构建可运行切片）→ Generate Assets（fal 生成素材）→ Verify（游戏中验证）→ Record（录屏）→ Package（打包发布）。各子 Skill 各司其职：game-recon 负责识别游戏环境；reverse-engineering Skill 通过 ILSpy/Cpp2IL/Ghidra/IDA 分析代码；fal-assets Skill 调用 fal 平台 API 生成精灵、纹理、3D 模型、音效、配乐；asset-pipeline Skill 将 AI 生成素材转换为引擎可用格式；game-automation Skill 管理游戏启动、截图、输入操作；showcase-video Skill 录制并剪辑成品展示视频。

官方链接

• GitHub 仓库：https://github.com/rehan-remade/universal-modder
• fal AI 素材平台：https://fal.ai