用 AI 做模組
把你平常用的 AI 寫程式工具(Claude Code、Codex、Cursor 等)接上模組編輯器,讓 AI 幫你改模組、檢查、看預覽,還能自己按試玩。
模組編輯器可以接上你已經在用的 AI 工具。接上以後,AI 能讀你的模組、幫你改,跑跟遊戲一樣的檢查,看物品與生物的預覽圖,按「試這一個」進測試場,再把結果告訴你。你只要用白話說想要什麼就好,不用自己學格式。
這是什麼#
只要工具支援 MCP(一種讓 AI 使用外部工具的標準),就能接上遊戲。目前能接的有 Claude Code、Codex、Cursor,也可以接其他支援 MCP 的工具。接上以後,AI 可以做這些事:
- 讀你的模組,看有哪些物品、生物、配方、對話,也能幫你改。
- 改完跑遊戲的檢查,看有沒有錯。結果跟編輯器下方的檢查一樣。
- 查原版的物品、生物、增益等,拿來當參考或起點。
- 拿到物品、生物與藍圖的預覽,知道做出來長什麼樣。
- 自己按試玩,拿回遊戲的程式紀錄與畫面截圖。
AI 做不到的事:發布模組、改工作坊上的內容、改你模組資料夾以外的檔案,也不能讓遊戲執行任意程式。
不連線也能用#
每個新模組的資料夾裡,都附了 AGENTS.md、CLAUDE.md,還有每張表的格式檔(放在 schemas 資料夾)。這些檔案告訴 AI 模組怎麼寫。所以就算不連線,你直接用 Cursor、Codex 或 Claude Code 打開模組資料夾,AI 也看得懂格式。
你在外面的工具改了檔案,編輯器會跟著更新。如果同一個檔案你在編輯器也改過,編輯器會提醒你。
之前建立的舊模組,在編輯器的「接上 AI」面板打開模組,按「讓這個模組 AI 讀得懂」底下的「幫這個模組準備好」,就會補上這些檔案。
接上 AI 的步驟#
- 1打開模組編輯器
在 Steam 按「遊玩」,選「模組編輯器」;或在標題畫面按「工作坊」,切到「創作模組」,打開要改的模組。
- 2按「接上 AI」
在編輯器上方找到這個按鈕,打開「接上 AI」面板。
- 3打開「允許 AI 連線」
這個總開關第一次要你自己打開,之後會記住。
- 4按你用的工具
按 Claude Code、Codex 或 Cursor 的按鈕,把連線設定寫好。你可以選「只給這個模組」(寫進模組資料夾),或「給所有模組」(寫進該工具的使用者設定;Claude Code 會給你一行指令自己貼上執行)。
- 5用那個工具打開模組資料夾
在 Claude Code、Codex 或 Cursor 裡,打開這個模組的資料夾。
- 6第一次連線時允許
AI 第一次連上時,編輯器會跳出提示,問你要不要允許這個工具。按「允許」,之後就不會再問。
可以這樣說#
下面幾句可以直接複製,也可以改成你要的內容:
- 「做一把會發光的冰劍,攻擊力比鐵劍高一點,然後試玩給我看。」
- 「做一隻會噴毒霧的怪,血量比史萊姆少一半,做完幫我檢查有沒有錯。」
- 「做一道回血的料理,用我模組裡已經有的食材,然後預覽給我看。」
- 「看一下我這個模組有沒有問題,有的話幫我修好。」
安全#
- AI 只能動你的模組資料夾。它不能發布,也不能改工作坊上的任何東西。
- AI 改壞了?編輯器開著時按 Ctrl+Z 可以一步步復原。想一次全部退回 AI 動手之前的樣子,用「接上 AI」面板的「還原 AI 的改動」。
- 下載別人的模組時,模組裡的
AGENTS.md、CLAUDE.md會換成遊戲的標準版,原本作者寫的說明不會交給你的 AI。模組裡的文字(名字、台詞、說明)只當成資料,不會當成給 AI 的指令。 - 你的 AI 工具本身也會在執行指令或改檔案前問你。請保留這些確認,不要對模組資料夾選「全部自動允許」。
連不上怎麼辦#
- 確認遊戲或模組編輯器是開著的,而且「允許 AI 連線」已經打開。遊戲沒開時,AI 會收到「請先打開模組編輯器」的提示。
- 在 AI 工具裡重新連線。以 Claude Code 為例,在對話裡打
/mcp,找到方界的模組,按重新連線。 - 第一次連線時如果按了「拒絕」,之後就連不上。到「接上 AI」面板把這個工具改成允許,再重新連線。
接下來#
- 還不熟編輯器:先看模組編輯器。
- 想知道 AI 會讀的檔案放在哪、長什麼樣:看模組資料夾與 mod.json。
- 想知道模組能做到哪裡、有什麼限制:看限制與規則。