獨立指南 · 資料即時來自 GitHub

Universal Modder:讓你的 AI Agent 去改你擁有的任何遊戲。

universal-modder 是一個免費的開源工具包,教 Claude Code、Codex、Cursor 和 Gemini CLI 如何給 PC 遊戲做 Mod:識別引擎、逆向程式碼、用 fal 生成美術、3D 和音效、在執行中的遊戲裡測試,併為下一個 Agent 留下筆記。

  • 6.1kGitHub 星標
  • 78篇遊戲實戰筆記
  • 12套引擎手冊
  • 6種支援的 Agent

已與 GitHub 同步 2026年10月10日

由 AI Agent 藉助 universal-modder 製作的 Mod。片段來自專案 README(MIT)。

它是什麼

一套 Agent 能照著做的 Mod 方法,而不是「一鍵生成 Mod」按鈕

Universal Modder 由 11 個 Agent Skills、um 命令列工具、fal MCP 服務和一個由 Agent 寫給 Agent 的共享知識庫組成。作者 Rehan 把 Claude Code 實際改 Terraria、帝國時代 II 和 GTA V × Minecraft 的經驗整理成了它,並於 2026年9月30日 以 MIT 授權開源。

真正幹活的仍然是你的 Agent。工具包給它提供引擎手冊、工具和前人經驗,讓它不再瞎猜:該用哪個載入器、存檔在哪、引擎實際怎麼運作、怎麼確認 Mod 真的生效了。

AI Modder 是怎麼工作的 →

工作原理

每個遊戲都走同樣的 10 步流程

無論你提什麼需求,mod-any-game 技能都會按這個流程走。

  1. 檢索知識庫從其他 Agent 已經摸清的遊戲或引擎經驗出發。
  2. 偵察並選路線引擎、版本、載入器、反作弊和存檔 → 生成 MODDING_PLAN.md。
  3. 搭建安全實驗環境先備份存檔,用獨立配置,固定視窗大小。
  4. 閱讀真實程式碼用 ILSpy、Ghidra、Cpp2IL、Frida 看程式碼,而不是猜。
  5. 先做通一個切片一個物品、單位或機制先端到端跑通,再擴充套件。
  6. 生成素材用 fal 生成精靈圖、貼圖、3D、音效和音樂,並調整引擎格式。
  7. 在真實遊戲裡驗證在執行中的遊戲裡截圖、看日誌、跑測試場景。
  8. 錄製只錄遊戲視窗和遊戲本身的聲音。
  9. 打包檢查是否夾帶遊戲檔案、反編譯程式碼和洩露的金鑰,然後釋出。
  10. 寫實戰筆記把踩過的坑和確切版本寫回知識庫。
3D 路線:fal 概念圖 → fal 3D 模型 → um render3d 渲染出帝國時代 II 的 16 個朝向。2D 路線:fal 美術 → 摳圖 → 64x26 精靈圖 → 在 Terraria 中生效。
素材管線:fal 美術 → 摳圖 → 引擎精確尺寸的精靈圖,或 fal 3D → 渲染 16 個朝向。圖片來自 universal-modder README(MIT)。

遊戲庫

42 款遊戲,78 篇實戰筆記

每個遊戲頁面都列出 Agent 實際做出了什麼、哪些版本可用、踩了哪些坑。

全部遊戲 →

World of Warcraft

10 篇筆記 · 9 個可用 · 最近 2026-10-04

Custom AzerothCore modules for a solo-with-bots WotLK server: offline gathering, auction payout and restock, mail and progression fixes

Test Drive Unlimited 2

7 篇筆記 · 1 個可用 · 最近 2026-10-06

TDU2 vehicle physics: the Havok 5.5.0 packfile format inside .bnk containers

Baldur's Gate 3

6 篇筆記 · 6 個可用 · 最近 2026-10-05

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

Minecraft

6 篇筆記 · 6 個可用 · 最近 2026-10-07

Kindred: Local LLM AI companion with Ollama, bounded inference, autonomy, and memory

Watch Dogs

4 篇筆記 · 1 個可用 · 最近 2026-10-06

Watch Dogs 1: editing .feu/.gfx UI components and rebuilding entitylibrary_rt.fcb

Assassin's Creed IV Black Flag

2 篇筆記 · 1 個可用 · 最近 2026-10-06

A visible, driven second character in AC4 single-player (co-op ghost avatar)

Dragon's Dogma 2

2 篇筆記 · 2 個可用 · 最近 2026-10-05

Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)

Half-Life

2 篇筆記 · 1 個可用 · 最近 2026-10-05

Half-Life 1's weapons and monsters as a Minecraft Fabric mod, from a GoldSrc model converter

Naruto Shippuden: Ultimate Ninja Storm 4

2 篇筆記 · 1 個可用 · 最近 2026-10-05

Naruto Storm 4: free-for-all for 4-6 teams with native UI, by controlling the duel's side/role lookups

Palworld

暫無實戰筆記 · 虛幻引擎 5

該從哪裡入手,以及它和 UEVR「通用 VR Mod」有什麼不同。

常見問題

Universal Modder 是什麼?

Universal Modder(GitHub 上叫 universal-modder)是一個開源工具包,包含一組 Agent Skills、名為 um 的 Python 命令列工具、用於生成美術/3D/音訊的 fal MCP 服務,以及一個共享的實戰筆記知識庫。它們一起教 AI 程式設計 Agent 如何給你擁有的 PC 遊戲做 Mod:識別引擎、選擇路線、閱讀真實程式碼、構建 Mod、在執行中的遊戲裡測試,並把經驗記錄下來。

Universal Modder 免費嗎?

工具包本身免費,MIT 授權。你仍需為 AI Agent 付費(例如用 Claude Code 需要 Claude Pro 或 Max 套餐);如果要生成精靈圖、3D 模型或音效,還需要支付 fal API 費用。一個小 Mod 的素材通常只要幾美元。詳見費用說明。

Universal Modder 支援哪些 AI Agent?

Claude Code、OpenAI Codex、Gemini CLI、VS Code 中的 GitHub Copilot、Cursor 和 OpenCode 都有官方說明的安裝方式。其他 Agent 也可以透過複製儲存庫或 npx skills add 安裝技能來使用。詳見安裝教學。

它真的能改任何遊戲嗎?

沒有工具能真正改動每一款遊戲。它內建 12 套引擎手冊(Unity、Unreal、.NET/XNA、Godot、Source、Bethesda、Minecraft、帝國時代 II、RE 引擎/FromSoft/GTA 等)和一個真實嘗試的知識庫。能做到什麼程度,取決於引擎、是否有現成的 Mod 載入器,以及遊戲的防護程度。帶反作弊的聯網遊戲按設計不在範圍內。

用它會被封號嗎?

技能會要求 Agent 拒絕修改帶反作弊的聯網遊戲、拒絕做針對其他玩家的外掛和繞過 DRM,並在動存檔前先備份。請留在單機、離線模式或你自己架設的伺服器裡。這些是給 Agent 的指令,而不是技術鎖,所以最終責任仍在你。詳見安全頁。

Universal Modder 能在 Mac 或 Linux 上用嗎?

安裝、知識庫、精靈圖處理、備份和釋出檢查都能在 macOS 和 Linux 上執行。遊戲自動化部分(um win:啟動、截圖、輸入、錄製)只支援 Windows,原生或透過 WSL。反正大多數 PC 遊戲本來就是 Windows 遊戲。

universal-modder.dev 是官方網站嗎?

不是。這是一份獨立指南。唯一的官方來源是 GitHub 儲存庫 rehan-remade/universal-modder,專案沒有列出官方網站。請從那裡安裝;本站不會向你索要任何金鑰、付款或單獨下載。

它和 universal-game-modder 或「通用 VR Mod」是一回事嗎?

不是。universal-game-modder 是釋出在 npm 上的一個無關的 MCP 服務;大家給 Palworld 用的「通用 VR Mod」是 UEVR。詳見 Universal Modder 與 universal-game-modder 對比。