隱藏器 - 裝備可見性切換

這款模組允許你在《赤色沙漠》中使用自定義熱鍵來隱藏已裝備的武器和工具。可以按類別（武器、盾牌、弓、工具、提燈）切換可見性。非常適合拍攝乾淨的截圖、打造美觀的角色造型，或者單純享受沒有裝備雜亂的世界。

Weapon Hider - Equipment Visibility Toggle

🎮 **讓你的冒險更清爽！** 厭倦了角色身上掛滿武器和工具？這款模組讓你一鍵隱藏它們，無論是爲了拍照還是純粹爲了美觀！

---

✨ 核心功能

• **按類別切換**：使用熱鍵（默認：**V**）一鍵隱藏或顯示特定類別的裝備。
• **支持的類別**：單手武器、雙手武器、盾牌、弓、特殊武器、工具、提燈。
• **高度可配置**：每個類別都可以單獨設置啓用/禁用、熱鍵、默認隱藏狀態和部件列表。
• **開源透明**：代碼完全開源，安全可靠。
• **手柄支持**：原生支持 Xbox 手柄，通過配置也能兼容 PS 或 Switch 手柄。

🛠️ 安裝指南

• **安裝 ASI 加載器**：確保你的《赤色沙漠》已安裝 ASI 加載器。如果沒有，請從 Ultimate ASI Loader releases 下載 `version.dll` 文件。
• **放置文件**：將下載的 `version.dll` 放入你的遊戲根目錄（即遊戲主程序 `.exe` 所在的位置）。
• **安裝模組**：解壓本模組的所有文件到你的遊戲目錄下的 `bin64/` 文件夾中。
• **示例路徑**：`D:\Games\SteamLibrary\steamapps\common\Crimson Desert\bin64`
• **開始遊戲**：啓動遊戲，按 **V** 鍵（默認）即可切換裝備可見性！

⚙️ 配置說明

模組的所有設置都通過編輯 `CrimsonDesertEquipHide.ini` 文件來完成。你可以調整熱鍵、開關特定類別，甚至設置默認隱藏狀態。

**熱鍵格式示例：**

• 單鍵：`V`, `F3`, `Numpad1`, `Mouse4`
• 組合鍵：`Ctrl+V`, `Shift+F1`
• 手柄按鍵：`Gamepad_Y`, `Gamepad_LB+Gamepad_Y`（按住 LB 再按 Y）
• 多選熱鍵：`V,Gamepad_LB+Gamepad_Y`（按 V **或** 手柄組合鍵均可觸發）

💡 **提示**：將 `Hotkey` 留空即可禁用該類別的切換功能。完整的熱鍵名稱列表請參考 Supported Input Names。

🎮 使用手柄

模組通過 **XInput** API 原生支持 Xbox 手柄。你可以在 INI 文件中直接使用手柄按鍵名。

• **對於 PS4/PS5/Switch 手柄**：需要使用 DS4Windows、DualSenseX、BetterJoy 等工具，或啓用 Steam 輸入，將手柄模擬爲 XInput 設備。
• 詳情請見 Gamepad Compatibility。

⚠️ 已知限制與故障排除

**已知問題：**

• 切換可見性可能需要 **1-3 秒** 才能生效，因爲遊戲會緩存網格可見性並定期更新。
• 在大型遊戲更新後，可能需要更新模組的 AOB 內存掃描模式。
• 目前僅測試了 Steam 版本。

**遇到問題？試試這些步驟：**

• 在 INI 文件中將 `LogLevel` 設置爲 `Debug`。
• 檢查遊戲目錄下的日誌文件 `CrimsonDesertEquipHide.log`。
• 如果出現內存模式錯誤，說明當前遊戲版本可能需要模組更新。

🔄 **遊戲更新後**：模組的 AOB 模式掃描系統能自動適應微小的遊戲改動，但如果核心遊戲函數被修改，則可能需要等待模組更新。

🙏 致謝與源代碼

本模組基於 DetourModKit 構建核心功能。

特別感謝：

• ThirteenAG 提供的 Ultimate ASI Loader。
• cursey 的 SafetyHook。
• Brodie Thiesfield 的 SimpleIni 庫。
• Pearl Abyss 創造了精彩的《赤色沙漠》。

所有《赤色沙漠》的模組和工具都可以在這個 GitHub 倉庫 中找到。歡迎貢獻代碼或提出改進建議！

---

📸 **現在就去試試，用更乾淨的畫面記錄你的沙漠之旅吧！**