BG3 模組：博德之門 3 AI 指南

簡介：一個好的 BG3 Mod 從受控的更改開始

《博德之門 3》改裝可以從一個小請求開始：添加咒語、重新平衡物品、創建職業功能、調整進度表、添加外觀選項或改變生活品質。困難的部分出現在想法之後。模組必須適合當前的遊戲版本，使用預期的資料和資產結構，與其他模組共存，以正確的順序加載，並避免將玩家的戰役變成不可恢復的兼容性問題。

這就是為什麼 BG3 modding 不僅僅是編輯資料或腳本的練習。它是一個範圍控制、文件檢查、備份、相容性檢查、受控測試和誠實的發行說明的工作流程。人工智慧可以加快圍繞這些步驟的規劃、證據收集和審查。它無法安全地猜測過時的格式、保證相容性或替換相關保存副本的測試。本指南解釋瞭如何負責任地建立 mod，以及 EasyClaw 在何處提供有用的執行支援。

什麼是 BG3 模組？

BG3 modding 是透過受支援的模組工作流程、可用工具、遊戲資料、您有權使用的資產以及允許的分發管道為《博德之門 3》合法創建自訂內容或遊戲玩法變更。根據目前的遊戲版本和模組工具，創作者可以使用資料定義、在地化、模型、紋理、UI 資源、腳本、類別、咒語、物品、規則和戰役相關內容。

它不是為了多人遊戲優勢而進行的客戶端篡改、DRM 繞過、未經授權的資產提取、帳戶自動化，也不是在未經每個玩家同意的情況下強制模組進入伺服器或合作會話的方式。負責任的 BG3 mod 會清楚地說明其版本、相依性、安裝要求、相容性限制以及對現有保存的已知影響。

方面	BG3改裝	一般遊戲開發
Environment	支援的模組工具、遊戲數據、專案文件和批准的發行版	引擎、來源專案、專有工具和部署管道
Typical output	職業、法術、物品、裝飾、規則、UI 或內容更改	完整的遊戲、功能、服務或引擎系統
Main constraint	Game updates, mod 格式、相依性、載入順序、保存相容性	架構、引擎 API、平台、進度和預算
Validation	受控安裝、日誌、清理測試、相容保存測試、合作協議	建置、單元測試、QA、效能測試和發布環境

💡 Key idea: BG3 mod 尚未準備好，因為它出現在 mod 管理器中。當更改被理解、依賴關係是明確的、測試路徑是可重複的且相容性聲明是誠實的時，它就準備好了。

BG3 Modding Basics：Data、Assets、Dependencies 和加載訂單

Start with the smallest correct scope

Define 選擇檔案先前面向玩家的變更。「為特定類別添加平衡的三級法術」為您提供了一個可測試的目標。「讓戰鬥更有趣」則不然。確定該功能涉及哪些系統以及哪些系統應保持不變。

Data and assets need stable references

BG3 mod 通常依賴於標識符、資料條目、本地化參考和資源路徑的精確匹配。一項變更在一個文件中可能看起來無害，但由於缺少引用的資源、文字條目或依賴項而失敗。使用目前的工具文件並檢查相容的範例，而不是依賴舊的程式碼片段。

Dependencies 和載入順序是此功能的一部分

單獨工作的 mod 可能會與編輯相同資源或採用不同版本的另一個 mod 發生衝突。記錄先決條件、不相容性和訂購期望。在受控設定中進行測試之前，請勿聲稱具有廣泛的兼容性。

Save compatibility deserves a separate decision

儘早詢問該功能是否適用於新行銷活動、現有行銷活動、兩者或兩者皆不適用。切勿將玩家保存視為一次性測試工件。僅在副本上進行測試並清楚地解釋遷移或卸載限制。

層	要回答的問題	常見風險
Feature scope	玩家行為到底發生了什麼變化？	Unbounded feature creep
Data	需要哪些條目和識別碼？	Missing or obsolete reference
Assets	Are paths, 格式和權限是否有效？	Missing resource or unlicensed content
Dependencies	還需要哪些其他模組或版本？	Hidden conflict or incorrect order
Saves	對於新的和現有的活動來說，什麼是安全的？	Unexpected campaign breakage

如何在編輯文件之前規劃博德之門 3 Mod

在接觸專案文件之前寫一個簡短的模組簡介。包括玩家問題、確切的功能行為、受影響的系統、預期的遊戲版本、支援的依賴項、新的與現有的保存策略、非目標和驗收測試。這並不是為了文書工作本身；而是為了文書工作。它為您提供了一種方法來決定每個文件變更是否適用於該模組。

例如，添加類別特徵需要的不僅僅是描述。它需要目標類別、等級或條件、預期的玩家回饋、受影響的資料條目、可能的互動以及刪除或相容性策略。將特徵轉化為可以測試的問題：

GOAL: add one bounded class feature for the supported game version
INPUTS: target class, level condition, data entries, localization, dependencies
CHANGE: create only the required definitions and references
DO NOT: overwrite unrelated resources or test on the only campaign save
VERIFY: feature appears at the expected condition, text resolves, no new errors,
        clean test and approved compatibility test both behave as documented
OUTPUT: change summary, test results, known limits, files requiring review

這是一份規劃合同，而不是通用的可貼上實施。確切的文件和格式取決於當前的 BG3 工具和 mod 類型，因此在應用更改之前根據當前參考驗證它們。

BG3 Modding Debugging：複製、隔離與保護 Saves

當 mod 無法載入或表現異常時，請抵制立即重新安裝所有內容的衝動。首先隔離故障：mod 是否出現在載入設定中，其所需的依賴項是否存在，遊戲是否報告有用的錯誤，問題是否發生在乾淨的測試設定檔中，以及是否僅在特定的 mod 組合或順序中出現？

一次更改一個變數。在多檔案變更之前進行日期備份，保留最小的測試配置，並記錄遊戲版本、模組版本、依賴版本、載入順序、預期結果、實際結果以及相關日誌或錯誤輸出。如果問題涉及戰役狀態，則僅在複製的保存中重現該問題。這些證據比關於該模組「停止工作」的模糊報告有用得多。

Debugging principle 可靠的修復始於可重複的問題。如果您無法說明產生問題的最小配置，您就無法自信地說明哪個變更修復了該問題。

首先確認目標遊戲和模組工具版本。
在測試更大的模組列表之前先測試模組本身。
檢查聲明的依賴項和預期的載入順序。
使用複製的保存來進行任何可能改變戰役狀態的測試。
記錄第一個有意義的錯誤，而不僅僅是最終的症狀。
每次修復後重新測試原始再現路徑。

Using AI 用於 BG3 改裝而不會失控

人工智慧對於將功能請求轉化為模組簡介、解釋資料檔案的作用、映射依賴關係、組織相容性測試矩陣、總結日誌摘錄以及起草發行說明非常有用。當 mod 有多個小檔案且會話之間的關係很容易被忘記時，它特別有用。

AI並不是當前BG3工具鏈的權威。它可能會混淆新舊格式、發明識別碼或假設存在依賴性。要求它識別假設，用它來準備問題和測試，然後在您當前的工具和受控遊戲設定中確認答案。切勿讓看似合理的生成指令取代備份或保存安全測試。

創建者任務	有用的人工智慧貢獻	人類責任
Feature brief	Clarify scope, constraints, and acceptance tests	Choose a maintainable feature
File 評論	Explain relationships and list questions	Confirm current 格式與參考
Conflict triage	Organize possible dependencies and causes	受控設定中的 Reproduce the 問題
Save testing	Draft new-save and copied-save checklists	Protect campaign data and validate behavior
Release work	Draft concise notes and known limitations	Make accurate compatibility claims

EasyClaw 如何幫助 BG3 改裝工作

當 BG3 modding 不再是單一文件編輯並成為包含資料夾、版本說明、依賴項、測試保存、螢幕截圖、日誌摘錄和發布文件的桌面專案時，EasyClaw 最有用。桌面本機代理不僅可以回答問題，還可以圍繞這些材料執行批准的工作：檢查選定的本地文件、構建清單、將證據收集到報告中、準備兼容性檢查表以及在報告返回之前驗證所請求的可交付成果是否存在。

使用 EasyClaw 根據您的實際專案準備變更計劃

向代理提供有限制的請求，例如：「閱讀功能簡介和選定的 mod 資料夾。建立文件映射，列出依賴項和保存相容性問題，並編寫測試計劃。不要更改來源文件。」代理可以使用本機文件和文件技能來檢查存在的內容，而不是基於通用範例制定計劃。輸出應指向其審查的確切文件、發現的假設、未解決的風險以及編輯前所需的測試案例。

Use it to run a safe preflight before you test

在進行受控測試之前，請 EasyClaw 檢查 mod 版本文件、依賴項清單、選定的項目文件、最新錯誤證據和測試清單。它可以建立帶有日期的預檢報告，並提醒您在乾淨的設定檔或複製的保存上進行測試。這減少了可避免的錯誤，例如使用錯誤的專案資料夾、測試過時的套件、忘記聲明的依賴項或修改唯一的活動保存。

用它來將證據轉化為下一個最小的行動

測試後，提供相關截圖、錯誤文字、載入順序、重現說明。 EasyClaw 可以將證據分為已確認的缺陷、可能的相容性問題、缺少的資訊和延遲的功能想法。然後，它可以準備可審查的下一步計劃，而不是進行廣泛的未經驗證的編輯。如果您對每個版本都使用相同的流程，請將穩定的測試報告格式和項目約定保存在代理的記憶體中，以便以後的審查從正確的上下文開始。

Set clear boundaries 用於來源和發布操作

對於改裝工作，您的提示應命名代理可能採取的操作和需要批准的操作。例如：「您可以閱讀這些檔案、建立帶日期的備份、更新測試報告以及起草發行說明。除非我確認，否則請勿覆蓋原始程式碼、刪除儲存、修改遊戲檔案、更改模組管理器設定或發布。」此邊界允許 EasyClaw 執行有用的桌面工作，同時將後續變更保持在創建者的控制之下。

💡 EasyClaw’s role: 使圍繞 BG3 mod 的檢查、預檢、證據、測試和文件工作可重複。它不會取代目前的模組工具、繞過相容性限製或在未經驗證的情況下進行活動安全的變更。

Example：BG3 Mod 從功能簡介變更為安全性測試

想像一下，一位創建者為受支援的遊戲版本添加了一個有界類功能。他們要求 EasyClaw 閱讀簡介和選定的專案文件，然後產生資料條目、本地化參考、依賴項、保存風險和所需測試的對應。代理程式會報告審查的文件並標記在創建者更改任何內容之前必須在當前 BG3 工具中回答的問題。

建立者批准計畫後，EasyClaw 將建立允許的帶日期備份和測試報告範本。創建者應用受支援的最小編輯，運行乾淨的測試配置文件，然後僅在複製的營銷活動保存上進行測試（如果該副本在該功能的記錄範圍內）。創作者提供由此產生的證據； EasyClaw 將其組織為通過/失敗檢查、未解決的兼容性問題和範圍狹窄的後續計劃。

階段	創作者行動	EasyClaw 工作	驗證點
Define	Describe feature, limits, and supported version	Creates a change brief and acceptance tests	Is the scope small and testable?
Inspect	Choose the project files to 評論	Builds file, reference, and dependency map	Are assumptions and risks visible?
Preflight	Approve allowed desktop actions	Creates permitted backup and test report	Are correct files and safe test inputs ready?
測試	Run clean and copied-save tests as needed	Organizes logs, evidence, and regression cases	Does behavior match the documented feature?
Iterate	Approve a fix or release	Produces a prioritized follow-up report	Is the next change evidence-based?

BG3 Modding Checklist Before You Share a Mod

此功能具有面向玩家的重點目標和明確的非目標。
目標遊戲版本、模組工具版本、依賴項和載入順序均已記錄。
所有數據、本地化和資產參考都是最新且經過授權的。
您可以在進行後續的多文件變更之前保留帶有日期的項目備份。
該模組已在受控設定中單獨進行了測試。
現有的保存行為僅在副本上進行測試並如實記錄。
相容性聲明僅限於您實際測試的組合。
合作社用戶會收到明確的安裝和協議要求。
發行說明解釋了變更、依賴性、保存注意事項和已知限制。

常問問題

BG3 modding 是什麼？

它是透過目前支援的改裝工具、專案數據、授權資產和允許的分發工作流程對《博德之門 3》內容或遊戲玩法進行的合法創作。

我可以在現有的戰役中使用 BG3 模組嗎？

這取決於具體的模組和遊戲版本。閱讀模組的文檔，使用複製的保存進行測試，並且不要假設安裝或刪除對於現有活動是安全的。

如何調試 BG3 mod 衝突？

記錄版本和載入順序，使用盡可能小的 mod 清單重現問題，單獨測試 mod，讀取第一個相關錯誤，並一次更改一個變數。

AI可以幫我寫一個BG3 mod嗎？

人工智慧可以幫助規劃、解釋文件、組織測試和總結證據，但對於當前的格式或 API 可能會出現錯誤。驗證目前工具和受控測試中的建議。

EasyClaw 如何幫助 BG3 modding？

EasyClaw 可以圍繞 mod 執行經過批准的桌面工作：檢查選定的專案文件、建立文件映射和報告、準備預檢和測試清單、組織錯誤證據以及起草發布文件。創建者仍然負責編輯、當前工具驗證、保存和發布決策。

結論：更好的 BG3 改裝來自更安全的迭代

BG3 modding 獎勵仔細的迭代。最強大的模組有特定的目的、當前的參考、明確的依賴關係、受控測試和誠實的保存相容性指導。看似很小的編輯可能會影響長期運作的活動，因此來源紀律和證據與創意雄心一樣重要。

AI 可以加速規劃和審查，而 EasyClaw 可以執行經批准的桌面工作，使您的專案文件、預檢報告、測試證據和發行說明保持連接。它不取代 BG3 modding 工具或保證相容性。它為創建者提供了一種更清晰、可重複的方式來在共享之前檢查、測試和記錄每個更改。