Crimson Desert 解包器

用於讀取、解包和提取遊戲.paz文件的C#圖形界面工具。包含用於解密、解壓縮和重新打包的Python腳本及示例。

Crimson Desert Unpacker

🛠️ 用於瀏覽、提取、解密和解壓縮《Crimson Desert》所使用的 **.paz** 存檔文件的工具集。

---

✨ 核心功能

• **可視化瀏覽**：通過可視化的文件樹瀏覽 PAMT 存檔。
• **批量提取**：支持批量提取文件，並自動完成解密和解壓縮。
• **自動解密**：使用 ChaCha20 算法進行解密，密鑰可根據文件名自動推導，無需外部密鑰庫。
• **自動解壓**：對壓縮條目使用 LZ4 算法進行解壓縮。
• **Python 命令行工具**：提供用於解包和重新打包的 CLI 腳本。
• **無外部依賴**：所有加密和壓縮功能均已內置。

---

📥 下載與組件

• **PAZ GUI**：用於瀏覽和提取 PAZ 存檔的 Windows 桌面應用程序。需要.NET 8 運行時環境。
• **PAZ Python 工具**：用於解包和重新打包的獨立命令行腳本。需要安裝有 `cryptography` 和 `lz4` 包的 Python 3 環境。

---

🖥️ GUI 使用指南

• 下載並解壓 GUI 壓縮包。
• 運行 `PazGui.exe`。
• 打開包含 `.paz` 存檔的文件夾以瀏覽存檔內容。
• 選擇文件並提取——解密和解壓縮過程將自動處理。

---

🐍 Python 命令行使用指南

```python

列出存檔內容

python paz_parse.py /path/to/0.pamt --paz-dir /path/to/0003

提取所有文件

python paz_unpack.py /path/to/0.pamt --paz-dir /path/to/0003 -o output/

僅提取 XML 文件

python paz_unpack.py /path/to/0.pamt --paz-dir /path/to/0003 -o output/ --filter "*.xml"

重新打包已修改的文件

python paz_repack.py modified.xml --pamt /path/to/0.pamt --paz-dir /path/to/0003 --entry "path/to/file.xml"

```

---

🔧 工作原理

PAZ 存檔使用 PAMT 索引文件，該文件將文件路徑映射到一個或多個 `.paz` 數據文件中的字節範圍。加密條目（如 XML 配置文件）使用 ChaCha20 算法，其密鑰由文件名確定性地推導得出，因此無需密鑰數據庫。壓縮條目則使用 LZ4 塊壓縮。

---

⚠️ 模組製作限制

• **重新打包不可靠**：由於遊戲對元數據文件（或類似文件）有完整性檢查，目前重新打包功能高度不可靠。
• **文件大小限制**：修改後的文件必須適配原始文件分配的大小，目前無法擴展條目。
• **格式未完全解析**：網格模型和許多其他遊戲對象使用自定義的二進制格式，目前尚未完全記錄。

---

📜 源代碼

項目源代碼可在 GitHub 上獲取。本項目採用 MIT 許可證。

---

💡 **使用建議**：對於希望深入瞭解《Crimson Desert》文件結構或進行基礎數據提取的玩家和模組製作者來說，這是一個強大的工具。建議先從 GUI 工具上手，熟悉後再嘗試 Python 腳本以獲得更靈活的操作。