Universal Modder + Claude Code：完整配置教程

为什么 Claude Code 是参考 Agent

项目作者是根据真实的 Claude Code 会话做出这个工具包的，仓库里有专门为 Claude 准备的配置：插件市场（.claude-plugin/）、复制到 .claude/skills 的技能、.mcp.json 里的 fal MCP 服务，以及一个 SessionStart hook，每次会话启动或恢复时都会把 um 命令行加入 PATH。其他 Agent 也能用（见多 Agent 安装教程），但 Claude Code 是测试最充分的路线。

1. 安装 Claude Code

如果 claude --version 已经能用，跳过这一步。

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

然后为你的 Mod 建一个工作文件夹（例如 ~/mods 或 C:\mods），在里面运行 claude 并登录。你需要 Claude Pro、Max、Team 或 Enterprise 套餐，或开通 API 计费的 Console 账号。遇到问题可以运行 claude doctor。

另外还要装好工具包的依赖：Git、Python 3.10+、ffmpeg 和 uv（一行命令安装）。

2. 添加 Universal Modder 插件

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

• 选择 user 作用域，这样每个项目文件夹都能用。
• 如果 Claude Code 提示，运行 /reload-plugins，或重启会话。
• 更喜欢在终端操作？同样可以用 claude plugin marketplace add … 和 claude plugin install …。
• 遇到 SSH 错误？见问题排查。

插件装了什么

3. 连接 fal，生成美术、3D 和音频

fal MCP 服务从启动 Claude Code 的环境里读取 FAL_KEY。在 fal.ai/dashboard/keys 创建密钥，导出后重启 claude。

export FAL_KEY="your-key"     # macOS / Linux / WSL
setx FAL_KEY "your-key"       # Windows，之后打开新终端

在 Claude Code 里用 /mcp 检查：fal 服务应显示为已连接。各类素材的价格见费用页。

调用技能

你很少需要点名某个技能：像“给星露谷物语做个 Mod……”这样的请求会加载 mod-any-game，它会按需调用其他技能。想强制使用某个技能，输入对应的斜杠命令：

每个技能包含什么 →

好用的提示词

好的提示词要写清游戏、一个具体结果，以及什么算“完成”。以下是项目 README 中的例子：

给 Terraria 做个 Mod：加一个追踪导弹发射器和一颗能把世界炸出大坑的战术核弹。精灵图用 fal 生成。

为帝国时代 II 做一个新文明，带一个由 3D 渲染出来的特色单位。

把真正的 Minecraft 放进 GTA V 故事模式。Minecraft 的镜头跟随 GTA 的镜头，它的 TNT 要能炸掉 GTA 的车。

C:\Games\Foo 是什么引擎？有人改过它吗？

省 token 又省钱的技巧：

• 先侦察，再动手。任何改动前先要计划，它会写出 MODDING_PLAN.md。
• 一次一个切片。一把能用的武器胜过十把做了一半的。
• 先用占位素材，再上 fal。机制在游戏里跑通后再生成正式美术。
• 先问价格。“生成 3D 模型之前先用 um fal price 查一下。”
• 测试时别碰电脑。它操控游戏或录屏时不要使用电脑。

长期项目与上下文限制

技能会在 MODLOG.md 里记日志（路径、ID、格式、失败原因、下一步），所以 Claude Code 压缩对话时重要信息不会丢。新会话这样开始：

读 MODLOG.md 和 MODDING_PLAN.md，从下一步继续。

Mod 做成后，让它用 share-field-notes 技能写一篇实战笔记。只有在你同意后，它才会向共享知识库提交 PR。

Claude Code 用它做出了什么

• Age of Empires II: Definitive Edition: San Franciscans: a new civilization for Age of Empires II DE with units rendered from 3D
• Baldur's Gate 3: Act 2 never loads (hang at 50% or crash): one modded NPC on a bad level layer, found by bisecting a pak
• Baldur's Gate 3: A generated wardrobe mod: 260 clothing mods sorted by race and body type into containers summoned by reusable scrolls
• Baldur's Gate 3: Custom outfits from cloned mod and vanilla meshes: visuals, materials, body masks, cloth, LODs, icons and the Blender GR2 round trip
• Baldur's Gate 3: Gameplay and compatibility patches in stats and Osiris: level-gated armour tiers, Extra Attack on a modded cantrip, crit immunity, stacking damage reduction, feats from items, removing equipment glow, a class vs starting-equipment fix
• Baldur's Gate 3: Running a 500+ mod load order by hand: modsettings.lsx rules, recovering a wiped order from a save, mod.io re-subscribes, game-folder files and conflict diagnosis
• Baldur's Gate 3: 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
• Borderlands 2: BL3 weapons and movement in Borderlands 2 (Willow2 SDK mods)
• Darkest Dungeon: A seeded randomizer (trinkets, heroes, monsters, curios, quirks, quests) as a Darkest Dungeon data mod
• Dragon's Dogma 2: Blink Strike teleports behind the target (REFramework Lua skill rework)
• Dragon's Dogma 2: Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)
• Elden Ring: CS2 conversion of Elden Ring offline: native Rust DLL via me3 (fall death, spirit springs, 3D inspect, params)

浏览全部游戏 →