Dungeons Mod Kit
1.0.0
這是一組工具，可以讓您更輕鬆地開發 Minecraft Dungeons 的模組。這些工具只能在 Windows 上運作。
如果您正在尋找為遊戲製作資源包的工具，請查看模組套件的resource-packs分支。
需要安裝這些才能使用這些工具：
您可以透過 Epic Games Store 應用程式免費下載虛幻引擎，只需確保選擇版本 4.22.x 即可。使用不同版本的UE4會導致各種奇怪的問題。
這些工具中包含一些範例文件，如果您要製作自己的模組，您可能需要刪除這些文件：
您可以使用Tools/clean_up_mod_kit.bat工具自動刪除它們。
編輯Tools/user_settings資料夾中的文字檔案以配置工具：
| 文件 | 描述 |
|---|---|
| 編輯器目錄.txt | 它包含虛幻編輯器可執行檔所在資料夾的路徑。 |
| 包輸出.txt | 這包含 package.bat 工具所建立的 .pak 檔案的路徑。 |
建議將 package_output 路徑設定為~mods資料夾中的文件，以便輕鬆測試 mod。
預設情況下，材質配置為不打包。如果您想更改它，或者如果您想排除打包其他虛幻資源，您可以編輯Tools/configs/copy_cooked_assets.rcj 。要包含材料，只需刪除M_*.u*和MI_*.u* 。若要排除某些文件，只需在底部新增檔案名，每個檔案名稱各佔一行。如果刪除所有過濾器，則還需要刪除/XF 。
本指南假設您已經熟悉遊戲檔案以及如何提取它們。
任何 3D 模型、聲音檔案、非區塊紋理的紋理以及一堆其他東西都是Unreal 資源。這些文件應使用虛幻編輯器進行管理。您可以使用編輯器開啟UE4Project資料夾中的Dungeons.uproject檔案來開啟專案。
虛幻資產在打包之前需要烹飪。
執行cook_assets.bat工具來烘焙資源並自動將它們複製到Dungeons資料夾中，準備打包。
您可以透過編輯Tools/configs/copy_cooked_assets.rcj來排除某些文件，如上面的設定部分所述。預設情況下，排除材質檔案。
對於已經煮熟的虛幻資產，例如修改後的藍圖.uasset文件，您可以將它們放在Precooked資料夾中，它們將在執行cook_assets.bat工具時自動新增。如果您沒有Precooked資料夾，只需在 mod 套件的根資料夾中建立一個，位於Dungeons 、 UE4Project 、 package.bat等旁邊。
請注意，當執行cook_assets.bat工具時，直接放入Dungeons資料夾中的任何已煮熟的資源都將被刪除，因為它需要在將新資源複製到該資料夾之前清理舊資源。
任何不是虛幻資產的內容（例如關卡 .json 檔案）都應添加到Dungeons資料夾中。該資料夾將被轉換為 .pak 檔案。
要測試您的 mod，您可以執行package.bat工具來建立 .pak 檔案。如果該工具配置為將 .pak 檔案放置在~mods資料夾中，則您可以在遊戲完成後立即開始遊戲。
要打包您的 mod 進行發布，請使用Tools/pack_compressed.bat工具。該工具將在您的Tools資料夾中建立一個compressed_pack.pak檔案。建立此 .pak 檔案通常需要稍長的時間，但檔案大小應該小得多。您可以將 .pak 檔案重新命名為您想要的任何名稱。
