直接在手機上管理並安裝《棕色塵埃2》模組。
- 📱 無需電腦：完全在您的 Android 裝置上完成模組解包、紋理轉換 (ASTC) 和重新打包。
- 🧠 智慧模組分組：自動掃描您的模組資料夾，並根據修改的目標遊戲檔案進行分組，避免衝突。
- ⚡ 批次處理：一次選取並安裝來自不同分組的多個模組，省時又省力。
- 🔀 Shizuku 整合：一鍵將打包好的檔案搬移到遊戲目錄。
- 👀 動畫即時預覽：安裝前長按任何模組，即可預覽其 Spine 動畫的實際效果。
- 🔧 內建實用工具：包含 Spine 圖集合併、遊戲資源檔解包等進階工具。
- Android 8 或更高版本。
- 已安裝最新版的《棕色塵埃2》官方遊戲。
- Shizuku：資源包掃描和一鍵將檔案搬到遊戲目錄，這是必要條件。
- 下載應用程式：從 Releases 頁面下載最新的
.apk檔案並安裝。 - 選擇模組資料夾：
- 打開 app 並點擊 "Select Mod Source Folder" 按鈕。
- 找到您存放所有模組的資料夾，然後點擊 "使用這個資料夾"。
💡 建議： 在手機根目錄建立一個專用資料夾 (例如：
.BD2_Mods) 來存放所有模組，方便管理。
為確保 App 能正確識別，您的模組必須遵循特定的資料夾結構。每個模組都需要有自己獨立的資料夾，且內部的檔案名稱必須與遊戲原始資產的名稱完全相同。
⚠️ 警告： 所有檔案名稱都必須是小寫（例如：char000104.png，不能是Char000104.png）。此外，.atlas檔案內引用的圖片檔名也必須是小寫，不然遊戲可能會閃退。
範例結構：
📁 .BD2_Mods/
├── 📁 Lathel_DarkKnight_IDLE/
│ ├── 📄 char000104.skel (或 .json 骨架檔)
│ ├── 📄 char000104.atlas (圖集定義檔)
│ └── 🖼️ char000104.png (紋理貼圖)
│
└── 📁 Another_Mod/
└── ... (其他模組檔案)
- 選擇模組：在 App 主畫面中，勾選您想安裝的模組。
- 開始打包：點擊右下角的 Repack (✓) 浮動按鈕。
- 等待處理：App 將自動下載最新的遊戲原始檔案並重新打包您選擇的模組。進度會即時顯示在彈出視窗中。
- 搬移檔案到遊戲目錄：
- 打包完成後，一個包含所有模組檔案的新資料夾
Shared將會儲存到您手機的Download資料夾中。 - 使用 Shizuku（推薦）： 如果 Shizuku 正在運行，畫面上會出現 「Move to Game Directory」 按鈕。點擊即可自動搬移檔案 — 即使是 Android 16+ 也能正常運作。
- 不使用 Shizuku： 您可以使用第三方檔案管理器手動搬移
Shared資料夾，或複製畫面上提供的 ADB 指令。 - 目標路徑為：
/Android/data/com.neowizgames.game.browndust2/files/UnityCache/。
- 打包完成後，一個包含所有模組檔案的新資料夾
不確定模組動起來的效果如何？
- 在列表中找到您想查看的模組。
- 長按該模組。
- 預覽視窗將會彈出並播放動畫。
已自動化，但保留手動模式作為備案。
App 會在打包過程中自動偵測並合併圖檔，這能解決大部分的閃退問題。但如果您的模組顯示仍然異常：
- 在主畫面，找到導致閃退的模組，並只勾選該模組。
- 點擊 "Merge Spine" 浮動按鈕。
- App 會自動處理檔案，原始檔案將被備份至新的
.old子資料夾。 - 重新安裝合併後的新模組，閃退問題應該就會解決。
供進階使用者提取遊戲原始檔案。
- 確保主畫面上沒有勾選任何模組。
- 點擊右下角的解包 (📤) 浮動按鈕。
- 選擇您想解包的
__data檔案。 - 解包後的內容將儲存於
Download/outputs資料夾。
如果您覺得這個工具對你有幫助，歡迎 請我喝杯咖啡 
，任何支持都會是我持續開發的動力！
-
Q: 為什麼我的模組沒有顯示在 App 裡？
- A: 請再次確認您在初次設定時選擇了正確的「模組來源資料夾」。同時，確保您的模組都已解壓縮，並遵循正確的資料夾結構。
-
Q: 裝完模組後遊戲閃退或崩潰了怎麼辦？
-
A: 這通常是以下原因造成的：
- 紋理數量不符：模組的
.png檔案數量與原始遊戲不符（App 通常會自動修復此問題）。 - 檔名錯誤：所有檔案名稱必須是小寫（例如
char000104.png），且.atlas內引用的圖片檔名也必須是小寫。
如果問題持續，請嘗試使用 「Merge Spine」 功能手動合併。若仍無法解決，那可能是模組本身損壞或與遊戲版本不相容。
- 紋理數量不符：模組的
-
-
Q: 安裝失敗了怎麼辦？
- A: 安裝失敗的常見原因有：
- 網路連線不穩，導致無法下載遊戲原始檔。
- 模組內的檔案名稱不正確。
- 打包過程中發生非預期的錯誤。 請檢查彈出視窗中的錯誤訊息以獲得更多資訊。
- A: 安裝失敗的常見原因有：
-
Q: 安裝後遊戲內的畫面顯示不正常。
- A: 這很可能是模組本身不完整，或與 Android 版不相容。一個完整的角色模組需要包含
.png、.atlas以及.skel(或.json) 三種檔案。
- A: 這很可能是模組本身不完整，或與 Android 版不相容。一個完整的角色模組需要包含
本專案的完成離不開以下優秀的開源專案與工具：
- browndust2-repacker-android: 提供
__data檔案重新打包、ASTC 紋理壓縮與 LZ4 壓縮的核心技術。 - ReDustX: 提供
.json轉.skel以及從遊戲 CDN 下載原始檔案的機制。 - UnityPy: 用於讀取、修改及儲存 Unity 遊戲資產的基礎 Python 函式庫。
- astc-encoder: 由 ARM 官方提供的 ASTC 紋理編碼器。
