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)

瀏覽全部遊戲 →