Crimson Browser and Mod Manager

Crimson Browser and Mod Manager 是一個獨立的《Crimson Desert》存檔瀏覽器和模組管理助手。

Crimson Browser & Mod Manager

🎮 **Crimson Browser & Mod Manager** 是一款獨立的存檔瀏覽器和模組管理工具，專爲《Crimson Desert》打造。

---

✨ 工具功能

這款工具能夠讀取 `0.pamt` 元數據、瀏覽 `.paz` 文件內容、預覽常見資源類型、提取文件，並重建支持的模組文件夾或覆蓋層 VFS 覆蓋，而無需修改原始存檔文件。

---

📋 系統要求

• **操作系統**：Windows
• **運行環境**：Python 3.10 或更新版本
• **依賴庫**：包含 Tkinter 的 Python 安裝包，以及 `requirements.txt` 中列出的 Python 包
• **可選組件**：
• `vtk` 用於嵌入式 3D 模型查看器
• `vgmstream` 用於 WEM 音頻預覽

---

🚀 安裝與運行

• **安裝 Python 3.10+**。
• 在 Crimson Browser 文件夾中打開終端。
• 運行命令：`pip install -r requirements.txt`。
• （可選）如需 WEM 音頻預覽支持，請確保 `tools/vgmstream-win64/vgmstream-cli.exe` 文件存在。
• 編輯 `config.txt` 文件，設置你的遊戲路徑和主題，例如：

```

archives_path=D:\Path\To\Crimson Desert

theme=dark

```

• 運行命令：`python crimson_browser.py`。

---

🔧 首次啓動

首次啓動時會解析存檔元數據並構建快速緩存。後續啓動將複用該緩存，除非你點擊 **刷新緩存** 按鈕。

---

⚙️ 當前功能集

• **瀏覽與搜索**：支持搜索、篩選、排序和可選樹狀路徑的存檔內容瀏覽。
• **快速緩存**：持久化的快速緩存，除非手動刷新，否則存檔只需解析一次。
• **文件預覽**：支持文本、圖片、3D模型、視頻、音頻和十六進制數據的預覽標籤頁。
• **DDS 支持**：通過 `meta/0.pathc` 支持部分壓縮的 DDS 預覽/提取。
• **主題切換**：可配置的淺色/深色模式，設置保存在 `config.txt` 中。
• **文件提取**：可提取選定文件或所有篩選後的文件，並顯示進度和預計完成時間。
• **PAM/PAMLOD 提取**：提取 PAM/PAMLOD 文件時自動導出 OBJ 資源。
• **.paloc 支持**：支持.paloc 預覽、JSON 側文件導出和 JSON 重新導入。
• **文件重導入**：支持單文件重導入爲重建的 `mod_folder` 包組覆蓋，或從任意鬆散文件夾樹進行批量重導入。
• **加密支持**：支持受保護條目的 ChaCha20 解密/重新加密。
• **包組重建**：支持完整的受影響包組重建，並更新 `0.pamt` 和 `meta/0.papgt`。
• **動態擴容**：當替換文件超出原空間時，自動創建新的 16 字節對齊的 `.paz` 塊。
• **模組管理界面**：用於管理 `mods//files` 源、編輯元數據、啓用/禁用模組以及基於順序的覆蓋優先級。
• **構建活動模組**：將已啓用的模組合併爲一個最終的覆蓋層輸出，位於 `mod_build/0036` 和 `mod_build/meta/0.papgt`。
• **部署到遊戲**：可部署經典的 `mod_folder` 覆蓋和最終的 `mod_build` 輸出，並創建本地 `bak` 備份。
• **啓動遊戲**：提供啓動 `bin64/CrimsonDesert.exe` 的按鈕。

---

🎨 3D 模型查看器

• **嵌入式解析**：直接嵌入 PAM/PAMLOD 解析功能。
• **渲染與導出**：基於 VKT 的離屏渲染器直接集成在主工具中，OBJ 導出路徑也內置其中。
• **交互控制**：左鍵拖動旋轉模型，右鍵拖動控制光源。
• **視圖控制**：提供重置視圖按鈕。
• **顯示選項**：可切換紋理顯示、重型網格簡化、法線翻轉。
• **紋理解析**：從已加載的存檔中解析引用的紋理，PAMLOD 紋理查找還會檢查分組引用和 DDS 變體。
• **透明度支持**：在可用時，3D 預覽中會保留紋理的 Alpha/透明度通道。

---

🔊 音頻/視頻/圖片預覽

• **音頻**：通過 vgmstream 預覽 WEM 音頻。
• **視頻**：MP4 預覽支持嵌入式播放、進度跳轉和全屏。
• **圖片**：圖片預覽支持縮放、平移，並帶有棋盤格透明背景。

---

📤 提取注意事項

• LZ4 文件會被解壓後提取。
• 當 `meta/0.pathc` 提供紋理頭時，部分壓縮的 DDS 文件會被重建爲普通 DDS 以供預覽/提取。
• 如果文件當前無法解密或解壓，則會寫入原始數據。
• PAM/PAMLOD 提取時，會在提取的源文件旁同時寫入 OBJ 文件。
• 找到匹配的紋理時，會將其導出到 OBJ 文件旁。

---

📥 重導入注意事項

• **安全第一**：原始存檔永遠不會被修改。
• **輸出位置**：輸出被寫入 `mod_folder` 作爲重建的包組覆蓋。
• **支持格式**：支持原始條目、LZ4 條目、明文條目和 ChaCha20 加密條目。
• **元數據更新**：更新受影響組的 PAZ 偏移量、大小、校驗和、`0.pamt` 和 `meta/0.papgt`。
• **壓縮處理**：對重建的有效載荷使用正常的 LZ4 重新壓縮，而非不安全的精確大小強制匹配。
• **當前限制**：
• 暫不支持 Partial、Zlib 或 QuickLZ 重新壓縮。
• 暫不支持非 ChaCha20 加密的重導入。

---

💾 快速緩存

工具將存檔元數據和條目列表存儲在：

`crimson_cache/archive_index_cache.pkl`

如果你想強制完全重建緩存，請使用 **刷新緩存** 按鈕。實時緩存狀態還會跟蹤已部署狀態的文件和當前的 `meta/0.papgt` 簽名。

---

⚠️ 已知限制

• 重導入目前僅更新現有的文件條目，不支持全新的存檔路徑。
• `mod_build` 中的最小化多模組合並依賴於遊戲的覆蓋層從未被觸及的基礎安裝中解析原始數據塊。
• 已知的運行路徑證據仍指向數字命名的 `%d.paz` 塊文件，因此目前不使用命名的塊文件。
• Partial、Zlib 和 QuickLZ 重新壓縮問題仍未解決。

---

🙏 致謝

• **版本**：0.12.1
• **核心貢獻**：ResHax 的所有智者，特別是 MrIkso 和 NoName。
• **技術研究**：LukeFZ 的 pycrimson 和 `.papgt` 結構研究。
• **加密破解**：Lazorr 破解了 ChaCha20 加密/解密並提供了相關工具。
• **模型轉換**：Lathiel 的模型轉換腳本和相關基礎工作。
• **字體工作流**：kh0shn4w 的 AutoFontModder 發佈幫助比較了精確大小的字體工作流程。
• **音頻預覽**：使用 vgmstream 進行 WEM 音頻預覽。

---

🎯 基本使用流程

• 使用 `pip install -r requirements.txt` 安裝依賴。
• 在 `config.txt` 中設置你的遊戲路徑。
• 運行 `python crimson_browser.py`。
• 讓首次啓動構建快速緩存。
• 瀏覽、預覽、提取或重導入支持的文件。