鬆散文件加載器

允許遊戲從遊戲存檔外部加載未打包的鬆散文件。

Loose File Loader

鬆散文件加載器讓《仁王3》能夠直接從磁盤加載鬆散文件，這樣你無需重新打包存檔就能覆蓋遊戲資源。🎮

✨ 核心功能

• **加載資產覆蓋**：從 `/mods` 目錄加載資產覆蓋文件。
• **廣泛兼容**：支持遊戲通常可以反序列化的任何資產類型（模型、紋理、動畫/數據文件等）。
• **保持原版行爲**：當沒有覆蓋文件時，保持遊戲原版行爲。
• **確定性衝突處理**：當多個模組修改同一文件時，提供確定性的加載順序處理。

🎯 爲何它如此有用？

**對於玩家：**

• 🚀 通過簡單的文件複製/刪除來安裝或移除模組。
• 🛠️ 無需複雜的存檔重新打包流程。

**對於模組製作者：**

• ⚡ 快速替換資產以進行預覽/測試。
• 🔄 在同一文件路徑上迭代，更快地驗證遊戲內效果。
• 🧪 避免爲每個小調整都進行完整的包重建和遊戲重啓。
• 🔍 結合存檔提取和運行時日誌記錄，更快地定位目標資源ID。
• 📉 縮短模組創建過程中的完整開發循環（查找目標 -> 編輯 -> 測試 -> 調整）。

---

📦 安裝指南

• **確保已安裝** 必需的《仁王3》插件加載器。
• **複製** `LooseFileLoader.dll` 到 `/plugins/` 目錄。
• **創建** `/mods/` 文件夾（如果不存在）。
• **啓動遊戲一次** 以確認插件初始化成功。

🎮 使用說明（玩家）

• **放置模組文件**：將模組文件放入 `/mods/` 或 `/mods//` 目錄。
• **啓動遊戲**。

**示例目錄結構：**

```

/mods/0xA1B2C3D4.g1m

/mods/MyModPack1/0x11A34982.g1t

/mods/MyModPack1/0x7DC6EBD9.g1t

/mods/MyModPack2/0x6E7A0710.g1t

/mods/MyModPack2/0x695BBBFB.g1t

/mods/MyModPack2/0xA0B0DD1D.g1m

```

衝突與加載順序

如果多個模組修改了同一個文件，插件會按照以下**確定性順序**保留第一個找到的文件：

• `mods` 根目錄下的文件。
• 然後是一級子文件夾內的文件，按字母順序（不區分大小寫）排序。

🛠️ 使用說明（模組作者）

查找資源ID（RDB瀏覽器 + 日誌）

• 你可以使用 RDB Explorer 來瀏覽/提取遊戲存檔中的資產。
• LooseFileLoader 在遊戲運行時會將資產加載信息寫入插件日誌。
• 模組作者可以利用這些日誌條目來識別當前場景中正在讀取的資源ID（`fileId`），然後從存檔中導出這些資產，並將其作爲鬆散文件進行替換。
• **工作流程**：在日誌中識別ID -> 從存檔導出 -> 編輯 -> 放入 `mods` 文件夾 -> 在遊戲中驗證。

日誌文件位置

• **主日誌文件**：`C:\Users\\Documents\LooseFileLoader.log`
• 日誌記錄器使用文件輪換，因此你可能還會看到輪換的歷史文件（例如 `.1`）。
• 資產加載日誌默認是禁用的。要打印資源加載日誌，請在 `/plugins/LooseFileLoader.ini` 文件中設置 `EnableAssetLoadingLog=1`。

迭代工作流程

• 在測試時保持相同的文件名/路徑，並覆蓋文件內容。
• 在遊戲中觸發資產重新加載（場景重載、地圖切換、裝備/菜單刷新等）以預覽更新。
• 如果你添加了全新的覆蓋文件（新的哈希值），請重啓遊戲，以便啓動時的索引包含它們。

---

🗑️ 卸載方法

• 從 `/plugins/` 目錄中移除 `LooseFileLoader.dll`。
• （可選）移除你在 `/mods/` 下添加的任何文件。
• 卸載後，遊戲將回退到原始打包的資產。

❓ 故障排除

• **覆蓋未加載**：

驗證文件名主體是否恰好是8位十六進制數字（`0x` 前綴可選），驗證文件是否在 `mods` 根目錄或一級子文件夾中，並驗證沒有其他模組對同一哈希值的文件擁有優先加載權。

• **遊戲崩潰或畫面異常**：

替換文件的格式可能與目標資產類型不匹配。

• **當前遊戲會話中未檢測到新添加的文件**：

重啓遊戲（索引在遊戲啓動時構建）。

• **`LooseFileLoader.log` 中沒有資產加載日誌**：

確保 `/plugins/LooseFileLoader.ini` 文件在 `[LooseFileLoader]` 部分下設置了 `EnableAssetLoadingLog=1`。

📝 注意事項

• 此插件不會重新打包存檔文件；它僅在哈希值匹配時將讀取操作重定向到鬆散文件。

🙏 致謝

• 感謝 MrIkso 開發的 Nioh3FileLoaderLogger。