sts2-keyboard-controller-bridge

A Slay the Spire 2 mod that maps keyboard keys to controller-style actions, enabling keyboard-only navigation through the game's existing controller focus system.

### Features

- Keyboard-to-controller-style navigation.
- WASD and arrow keys for focus movement.
- IJKL as controller face-button style controls.
- F/G/H/B for pile and tab controls.
- M for map.
- P for pause/settings/back.
- Persistent clearing of STS2's native keyboard shortcuts to avoid conflicts.
- Guard for the H/exhaust-pile action so pressing H in combat with no exhaust pile does not crash the game.
- Diagnostic keys and log output for troubleshooting.

### Current keymap

| Keyboard | Controller semantic | STS2/Godot action | Notes |
|---|---|---|---|
| W / Up | D-pad / stick up | `ui_up` | Move focus up |
| S / Down | D-pad / stick down | `ui_down` | Move focus down |
| A / Left | D-pad / stick left | `ui_left` | Move focus left |
| D / Right | D-pad / stick right | `ui_right` | Move focus right |
| I | Xbox Y / Confirm | `ui_accept` | Proceed / confirm / end turn |
| L | Xbox B / Cancel | `ui_cancel` | Cancel / back |
| K | Xbox A / Select | `ui_select` | Select focused card/button/enemy |
| J | Xbox X / Top panel | `mega_top_panel` | Top panel |
| F | LT | `mega_view_draw_pile` | View draw pile |
| G | RT | `mega_view_discard_pile` | View discard pile |
| H | RB | `mega_view_exhaust_pile_and_tab_right` | View exhaust pile / tab right |
| B | LB | `mega_view_deck_and_tab_left` | View deck / tab left |
| M | View/Back | `mega_view_map` | Map |
| P | Menu/Start | `mega_pause_and_back` | Pause / settings / back |

## 中文

这是一个《杀戮尖塔 2》（Slay the Spire 2）模组，用来把键盘按键映射成游戏现有的手柄操作，让玩家可以用“类似 Xbox 手柄”的方式进行全键盘导航。

### 功能

- 用键盘模拟手柄式焦点导航。
- WASD 和方向键移动 UI 焦点。
- IJKL 对应手柄面键式操作。
- F/G/H/B 对应牌堆查看和左右切页。
- M 打开地图。
- P 打开暂停 / 设置 / 返回。
- 启动时持久化清空 STS2 原生键盘快捷键，避免与模组键位冲突。
- 对 H / 消耗堆 action 加保护：战斗中没有消耗牌时按 H 不会导致游戏崩溃。
- 保留诊断按键和日志，方便排查问题。

### 当前键位

| 键盘 | 手柄语义 | STS2/Godot action | 说明 |
|---|---|---|---|
| W / ↑ | 十字键 / 摇杆上 | `ui_up` | 焦点上移 |
| S / ↓ | 十字键 / 摇杆下 | `ui_down` | 焦点下移 |
| A / ← | 十字键 / 摇杆左 | `ui_left` | 焦点左移 |
| D / → | 十字键 / 摇杆右 | `ui_right` | 焦点右移 |
| I | Xbox Y / Confirm | `ui_accept` | 确认 / 继续 / 结束回合 |
| L | Xbox B / Cancel | `ui_cancel` | 取消 / 返回 |
| K | Xbox A / Select | `ui_select` | 选择当前焦点卡牌 / 按钮 / 敌人 |
| J | Xbox X / Top panel | `mega_top_panel` | 顶部面板 |
| F | LT | `mega_view_draw_pile` | 查看抽牌堆 |
| G | RT | `mega_view_discard_pile` | 查看弃牌堆 |
| H | RB | `mega_view_exhaust_pile_and_tab_right` | 查看消耗堆 / 向右切页 |
| B | LB | `mega_view_deck_and_tab_left` | 查看牌组 / 向左切页 |
| M | View/Back | `mega_view_map` | 地图 |
| P | Menu/Start | `mega_pause_and_back` | 暂停 / 设置 / 返回 |