模組管理器

用於管理《仁王3》外觀模組的圖形界面管理器。指向一個包含模組壓縮包（.zip.7z.rar）的文件夾，瀏覽可用模組，一鍵安裝或卸載。自動處理文件提取、使用 yumia 工具進行 RDB 文件修補以及乾淨的卸載。跟蹤已安裝的模組，讓你隨時瞭解哪些模組處於激活狀態。獨立的 Windows 可執行程序。

Nioh 3 Mod Manager

🎉 **歡迎使用《仁王3》模組管理器！** 這是一個專爲《仁王3》外觀模組設計的圖形界面管理工具，讓你告別繁瑣的手動操作，輕鬆享受模組帶來的樂趣！

---

✨ 這是什麼？

這是一個獨立的圖形界面應用程序，用於安裝和卸載《仁王3》的外觀模組。

**請注意**：此管理器不管理基於 DLL 的模組。

---

🚀 核心功能

• **📂 便捷掃描**：自動掃描指定文件夾中的模組壓縮包（.zip,.7z,.rar），並在清爽的界面中列出。
• **🎨 多選項支持**：檢測包含多種選項的模組（例如顏色變體），讓你選擇安裝哪一個。
• **⚙️ 多特性模組**：通過 `nioh3modmanifest.json` 支持多特性模組——在單個安裝步驟中獨立配置每個特性（例如盔甲樣式**和**鑲邊顏色）。
• **🔧 自動處理**：將文件提取到遊戲的 package 目錄，並自動運行 yumia 工具修補 RDB 文件。
• **⚠️ 衝突檢測**：在安裝與已安裝模組替換相同資源的模組前發出警告。
• **📊 安裝追蹤**：記錄已安裝的模組，讓你隨時瞭解哪些模組處於激活狀態。
• **🧹 乾淨卸載**：移除模組文件，恢復 RDB 備份，並重新修補剩餘的模組。
• **📁 格式兼容**：支持標準模組（包含 package/ 子目錄）、鬆散模組（文件在壓縮包根目錄）以及多特性清單模組。

---

📥 安裝指南

**第一步：下載 yumia 修補工具**

下載 `yumia_mod_insert_into_rdb.exe` 並將其放置在你的遊戲 package 文件夾中：

`C:\Program Files (x86)\Steam\steamapps\common\Nioh3\package\yumia_mod_insert_into_rdb.exe`

**第二步：創建模組文件夾**

在任意位置創建一個文件夾來存放你下載的模組壓縮包。例如：

`C:\Nioh3_mods`

從 下載模組，並將壓縮包文件（.zip,.7z,.rar）放入此文件夾。**無需解壓**——模組管理器直接讀取壓縮包。

**第三步：解壓並運行模組管理器**

從本頁面下載主文件，解壓 zip 包，然後運行 `Nioh3ModManager.exe`。

首次啓動時，點擊 **Settings** 並設置：

• **Mods Directory**：第二步創建的文件夾（例如 `C:\Nioh3_mods`）。
• **Game Package Directory**：你的《仁王3》遊戲 package 文件夾（例如 `C:\Program Files (x86)\Steam\steamapps\common\Nioh3\package`）。

設置完成後，你的模組就會出現在列表中。選擇一個模組，點擊 **Install** 即可安裝！

---

✅ 系統要求

• Windows 10 或 11 (64位)
• 《仁王3》 (Steam 版本)
• 已將 `yumia_mod_insert_into_rdb.exe` 放置在遊戲的 package 文件夾中（見第一步）

---

👨‍💻 致模組作者

**簡單模組 - 一組文件，無選項**

將你的文件放在一個 `package/` 子目錄中：

```

my_mod.zip

└── package/

├── 0xffaabb00.fdata

└── 0xffaabb00.yumiamod.json

```

也支持將文件直接放在壓縮包根目錄（無需 `package/` 子目錄）。

**包含互斥選項的模組 - 用戶選擇其中一個變體**

將每個變體放在其自己的命名子目錄中，每個子目錄包含一個 `package/` 文件夾。子目錄名稱（如 Red, Blue, Gold）將成爲 UI 中顯示的標籤。

**多特性模組 - 獨立的特性選擇，可選共享文件**

在壓縮包根目錄添加一個 `nioh3modmanifest.json` 文件。

**關鍵字段說明：**

• `"mod_name"` (可選)：如果設置，將在模組列表中顯示（如果存在 `"version"` 則附加版本號）。
• `"author"`, `"version"`, `"url"` (可選)：當模組被選中時顯示在詳細信息面板中；`"url"` 是可點擊的鏈接。
• `"name"`：在 UI 中顯示的人類可讀標籤。
• 每個特性的子目錄名稱將成爲可用的選項。
• 通用文件首先安裝；選定的特性文件隨後疊加（文件名衝突時，特性文件優先）。
• 標記爲 `"optional": true` 的特性可以被用戶跳過。

---

📜 致謝與源代碼

• **特別感謝**：由衷感謝 eArmada8 創建了 `yumia_fdata_tools` 項目。此模組管理器是圍繞他們的 `yumia_mod_insert_into_rdb.exe` 工具的圖形界面包裝。沒有他們對 fdata/rdb 格式的反向工程工作，這一切都不可能實現。
• **源代碼**：本管理器的源代碼託管在 GitHub 上：

---

🎮 **現在就開始管理你的《仁王3》模組吧，打造獨一無二的遊戲體驗！**