KCD2 按鍵綁定器

一個輕量級插件，解決《天國：拯救2》中自定義按鍵綁定模組之間的衝突。由於遊戲只支持一個keybindSuperactions.xml文件，該插件會在遊戲啓動時自動將所有已安裝模組的按鍵綁定合併到一個無衝突的單一文件中。

KCD2 Keybinder

🎮 關於此模組

在《天國：拯救2》中，添加自定義按鍵綁定的模組經常相互衝突，因爲遊戲只支持**一個** `keybindSuperactions.xml` 文件。

通常情況下，最後加載的模組會覆蓋其他模組——導致你丟失按鍵綁定。

**KCD2 Keybinder** 通過在遊戲啓動時自動掃描所有模組，合併它們的按鍵綁定定義，並生成統一的 `keybindSuperactions.xml` 文件來解決這個問題。

這確保了：

• ✅ 所有模組按鍵綁定都得到保留並在遊戲中可用
• ✅ 模組之間不再有覆蓋或衝突
• ✅ 按鍵綁定整齊分組，在設置中易於管理
• ✅ 一切在遊戲啓動時自動完成——無需手動設置

它輕量級，在後臺運行，開箱即用！

---

⚠️ 重要說明

KCD2 Keybinder **不提供**遊戲玩法優勢。它只是一個實用工具。只有當模組明確要求處理按鍵綁定時才需要它。它所做的只是安全地管理、合併和組織按鍵綁定。

**注意：** 不幸的是，它無法合併**所有**按鍵綁定。任何編輯 `` 元素的按鍵綁定模組都會破壞合併後的文件。

所以如果模組只添加 ``，那就沒問題。

---

🆕 新功能

通過在遊戲的"啓動選項"中添加或移除 `-keybinder` 命令來激活或停用 KCD2 Keybinder。你只需要在添加實現按鍵綁定的新模組時創建按鍵綁定。這讓你能夠按需啓用或禁用按鍵綁定器，而無需重複修改遊戲文件。

---

🚀 開始使用

• **安裝文件**
• 將內容解壓到 KingdomCome.exe 所在目錄（通常是 `\KingdomComeDeliverance2\Bin\Win64MasterMasterSteamPGO`）
• 壓縮包包含：`KCD2KeybinderPlugin.asi`、`dinput8.dll`（Ultimate ASI Loader）和 `KCD2Keybinder.exe`
• **重要：** 如果其中任何一個文件缺失，插件將無法工作
• **注意：** 如果已安裝 LuaDB，可以忽略壓縮包中的 `dinput8.dll`，因爲該文件已存在於你的目錄中

• **配置啓動選項**
• 打開遊戲屬性
• 在啓動選項中添加 "-keybinder"

• **啓動遊戲**
• 開始遊戲
• 享受乾淨、無衝突的控制體驗

插件（`.asi`）會觸發 `KCD2Keybinder.exe`，掃描所有模組並在獨立模組中生成 `keybindSuperactions.xml` 文件。之後，遊戲初始化照常繼續。

在此過程中，可能會短暫出現一個小控制台窗口。安裝的模組較少時，幾乎不會注意到。一旦所有模組掃描完畢且按鍵綁定模組創建完成，它會自動關閉。

---

✨ 玩家功能

• 🔧 自動將模組的自定義按鍵綁定添加到遊戲按鍵設置中
• 🔒 在合併新綁定時保持現有綁定完整
• 📁 確保模組特定按鍵綁定的適當分組，清晰明瞭
• 🎯 無縫處理原版和模組按鍵綁定
• 📦 開箱即用，設置簡單——無需手動編輯 XML

---

📝 注意事項

• KCD2 Keybinder **不改變**遊戲玩法——它只管理按鍵綁定
• 推薦給使用多個按鍵綁定模組或創建自定義控制的玩家
• 對於模組製作者，它提供了一個框架，可以安全地添加新按鍵綁定，而無需手動創建 XML 文件

---

🛠️ 模組製作者指南

如果你的模組包含定義需要新按鍵綁定的命令的 Lua 腳本（如《無限保存 II》或《露營》），這個插件消除了手動創建 `keybindSuperactions.xml` 或 `defaultProfile.xml` 的需要。

在你的腳本中使用示例：

```lua

--- @bindingCommand hw_toggle _xml.pak`，其中包含 `text__.xml` 文件，結構如下：

```xml

ui_keybinds_group_

Henry's Whistle

亨利的口哨

ui_keybind_

Toggle Henry's Whistle

切換亨利的口哨

```

---

🙏 致謝

特別感謝 jigsawpizzle 的想法和反饋。

---

🔗 相關鏈接

• KCD2 Modding Community
• Github 倉庫