键盘控制器桥接

创作者: echo806
已更新:2026-06-16 14:05:51
11KB

关于此 MOD

一个简单完整的键盘操控《杀戮尖塔2》方案。 更多详情请见https://github.com/Echo806/sts2-keyboard-controller-bridge 及https://www.bilibili.com/video/BV1nMVN6JE34/
一款《杀戮尖塔2》模组,将键盘按键映射为手柄操作,让你仅用键盘就能通过游戏原有的控制器焦点系统进行全程导航。


### 特色功能

- 键盘式手柄导航
WASD和方向键用于移动焦点。
- IJKL作为控制器正面按钮式操控
- 使用F/G/H/B键控制堆叠和标签页。
- M键打开地图。
- P 键:暂停/设置/返回
持续清空STS2原生键盘快捷键,以避免冲突。
- 针对H/弃牌堆动作添加保护,防止战斗中无弃牌堆时按H导致游戏崩溃。
诊断键及日志输出用于故障排查。

### 当前按键设置

| 键盘 | 手柄功能描述 | STS2/Godot 操作 | 备注 |
|---|---|---|---|
| W / 上 | 方向键上 / 摇杆上 | `ui_up` | 上移焦点
| S / 下 | 方向键下 / 摇杆下 | `ui_down` | 向下移动焦点
| A / 左 | 方向键左 / 左摇杆 | `ui_left` | 向左移动焦点
| 右 / 右方向键 / 右摇杆 | `ui_right` | 向右移动光标 |
| I | Xbox Y / 确认 | `ui_accept` | 继续 / 确认 / 结束回合
| L | Xbox B / 取消 | `ui_cancel` | 取消 / 返回
| K | Xbox A / 选择键 | `ui_select` | 选中目标卡牌/按钮/敌人
| J | Xbox X / 顶部面板 | `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 | 查看/返回 | `mega_view_map` | 地图 |
| P | 菜单/开始 | `mega_pause_and_back` | 暂停 / 设置 / 返回 |




## 中文

这是一个《杀戮尖塔2》的模组,可将键盘按键映射为游戏原有的手柄操作,让玩家能以类似Xbox手柄的方式实现全键盘导航。

功能

- 用键盘模拟手柄焦点导航。
WASD或方向键移动界面焦点。
- IJKL 对应手柄按键操作。
- F/G/H/B 分别对应查看牌堆及左右翻页。
- M 打开地图
P 暂停 / 设置 / 返回
启动时清除STS2原生快捷键,避免与模组按键冲突。
- 对H/消耗堆行动加保护:战斗中若无消耗,按H不会导致游戏崩溃。
保留诊断按键与日志,以便排查问题。

### 当前键位

| 键盘 | 手柄 | STS2/Godot 操作 | 备注 |
|---|---|---|---|
| W / ↑ | 十字键 / 摇杆上 | `ui_up` | 焦点上移 |
| S / ↓ | 十字键 / 摇杆下 | `ui_down` | 焦点下移 |
| A / ← | 十字键 / 摇杆左 | `ui_left` | 向左移动焦点 |
| D / → | 十字键 / 摇杆右 | `ui_right` | 焦点右移 |
| 我 | Xbox Y / 确认 | `ui_accept` | 确认 / 继续 / 结束回合 |
| L | Xbox B / 取消 | `ui_cancel` | 取消 / 返回
| K | Xbox A / 选择 | `ui_select` | 选定当前高亮卡牌 / 按钮 / 敌人 |
| J | Xbox X / 顶部面板 | `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 | 查看/返回 | `mega_view_map` | 地图
| P | 菜单/开始 | `mega_pause_and_back` | 暂停 / 设置 / 返回 |





使用 Xmod 解锁 杀戮尖塔2 的全部潜力 — 今天就探索这些顶级 MOD!