KeyBindingExtensions

KeyBindingExtensions（按鍵綁定擴展）

擴展 In Falsus 的六軌按鍵綁定，支持鼠標按鍵，以及同一個鍵盤鍵或鼠標按鈕綁定多個軌道。通過遊戲內操作設置配置，保留原有的應用、保存和恢復默認功能。

使用

• 打開“設置”中的操作設置頁。
• 點擊任意一個軌道鍵位槽。
• 按下要綁定的鍵盤鍵或鼠標按鈕；鼠標按鈕會顯示爲 Mouse0、Mouse1 等。
• 點擊原版“應用”按鈕保存。

Mouse0、Mouse1、Mouse2 分別是左鍵、右鍵和中鍵，Mouse3、Mouse4 是 Input System 的前進鍵和後退鍵。模組優先通過這些標準 ButtonControl 讀取每個原始事件，並同時保留 MouseState.buttons 的完整 16 位狀態讀取，因此同一路徑可處理 Mouse0 至 Mouse15；如果自定義鼠標佈局還在 allControls 中公開其他 ButtonControl，這些控件也會獲得穩定的 MouseN 並可綁定。實際可用按鈕取決於鼠標、驅動和 Unity 所公開的控件。

選擇槽位所用的首次點擊不會立即成爲綁定。再次點擊同一個槽位可以綁定 Mouse0；也可以在選擇槽位後按側鍵。應用按鈕、恢復默認和鍵盤重新綁定繼續生效。

同一個鍵盤鍵或鼠標按鈕可以綁定任意多個軌道。依次選中要共用鍵位的槽位，逐一綁定同一個按鍵，再點擊“應用”；設置其他槽位時不會替換已有綁定。遊玩時按下、保持和鬆開會同時作用於全部對應軌道。

綁定寫入遊戲原有的 keybind_BottomLane0 至 keybind_BottomLane5 偏好項，不創建第二份配置。重新打開設置、進入歌曲或重啓遊戲後，設置槽位和軌道按鍵提示器都會顯示並使用已保存的 MouseN。這些保留值需要本模組才能顯示和觸發；停用模組前可先在操作設置中恢復默認。

安裝

建議通過 In Falsus 的 r2modman 安裝。依賴中的 BepInExPack_IL2CPP 會由模組管理器處理，本包不攜帶 BepInEx、Doorstop 或.NET 運行時。 包標識爲 MengLei-KeyBindingExtensions，插件 DLL 名爲 KeyBindingExtensions.dll，可與 ParticleFusion 和 SkillSelection 分別啓用或停用。

若已安裝舊包 MengLei-MouseKeyBindings，先在模組管理器中卸載舊包，再安裝 MengLei-KeyBindingExtensions。手動安裝時先移除舊的 MouseKeyBindings.dll，再放入 KeyBindingExtensions.dll。按鍵綁定仍保存在遊戲原有的偏好項中。

輸入行爲

鼠標按下和釋放使用 Input System 原始事件時間。只有 MouseN 當前實際綁定在六軌之一、GameScene 已登記在原版始終接收輸入棧且暫停層未顯示時，事件纔會進入現有六軌處理路徑；角色選擇、設置和其他菜單不會收到 MouseN 合成鍵。釋放事件還會在幀末用對應 ButtonControl 的當前物理狀態校正，避免事件佈局漏報釋放後軌道保持點亮。暫停彈窗出現時，已經接受按下的軌道會立即收到配對釋放，並在暫停層完全關閉前保持失效。

鼠標綁定不包含 Ctrl、Alt 或 Shift 組合。原有鍵盤綁定及其修飾鍵匹配不受修改。

兼容範圍

當前適配 Steam App ID 3971950、Unity 6000.3.9f1 和 IL2CPP 元數據版本 39。實現依賴遊戲當前的 InputManager、LaneKeyBindSettingsContainer、GameScene 和 KeyPressedIndicator 互操作接口；遊戲更新這些接口後需要同步更新模組。