StickShift

Stickshift

用控制器畅玩 Minecraft。它不是在摇杆上硬贴键盘模拟器，而是提供
模拟移动、适配十字键操作的菜单、真正能用控制器操作的物品栏，以及
显示你手柄自身按键名称的图标。

Stickshift 通过 SDL3 与控制器通信，Minecraft 26 本身也在使用这个库。
它不附带任何原生库，只能识别游戏本身能识别的设备。

功能一览

游玩

• 模拟移动和视角控制，可分别设置摇杆的死区和响应曲线
• 82 个可重新绑定的按键，涵盖游戏操作、移动、视角、快捷栏、菜单和文字输入
• 面键会根据你的平台调整，因此 Nintendo 手柄不会出现按键对应颠倒的问题
• 快捷栏滚轮：按住、选择、松开

菜单

• 可操作所有原版界面，包括创造模式物品栏
• 物品栏指针可自由移动，也能自动对齐到物品槽，并支持拆分和快速移动
• 用于聊天、命令和告示牌的屏幕键盘，支持 Tab 补全
• 屏幕底部会显示按键指南，无论你身处何处，都能查看各按键的功能

手感

• 根据游戏中的情况触发震动，并可调节震动强度
• DualSense 自适应扳机：拉弓时会感受到阻力，举盾时会有支撑感，挥剑时则会有卡扣感。每个扳机都能单独开关并调节强度，因为想要弓箭效果，不代表也想要剑的效果
• 体感瞄准仅在可以发射远程攻击时启用——这正是游戏中摇杆表现确实不佳的场景

默认布局

以下按 PlayStation 按键标识显示。Stickshift 会显示你自己的控制器上印的按键名称。

| 操作 | 输入 |
| — | — |
| 移动 / 视角 | 左摇杆 / 右摇杆 |
| 跳跃 | 十字键 |
| 潜行 | 圆圈键 |
| 冲刺 | L3 |
| 攻击 / 挖掘 | R2 |
| 使用 / 放置 | L2 |
| 物品栏 | 三角键 |
| 切换副手 | 方块键 |
| 丢弃物品 | 十字键下 |
| 切换视角 | 十字键上 |
| 快捷栏下一项 / 上一项 | R1 / L1 |
| 快捷栏滚轮 | 触摸板 |
| 选取方块 | R3 |

安装与设置

将 jar 放入 mods/，连接控制器，然后开始游戏。无需预先配置。

设置位于选项 → 控制 → Stickshift，按键绑定则在单独的页面中。

运行要求

Minecraft 26.3 · Fabric Loader 0.19.5+ · Fabric API · Java 25 · 仅客户端

已知限制

这是一个测试版，以下限制确实存在：

• 已在通过蓝牙连接的 DualSense 上测试。代码支持 Xbox、Switch Pro 和通用手柄，也有相应测试，但还没有人实际拿这些手柄运行过。如果你有这样的手柄，无论结果如何，反馈都非常有帮助。
• 没有虚拟鼠标。所有原版界面都能操作。但如果某个模组配置界面没有任何可聚焦的元素，仍然需要使用鼠标。
• 通过蓝牙使用自适应扳机可能不稳定。效果报告会与手柄输入报告共用连接，因此更容易丢失。使用数据线即可解决。
• 一次只能使用一个控制器。支持热插拔，但尚未实现同时使用两个控制器。
• 没有配置档案。每次安装只有一套按键绑定。

问题反馈

请说明你使用的控制器及其连接方式。如果某些操作只是手感不对，而不是明显出错，
也值得反馈。这里修复的大多数问题都是这样发现的，而不是通过崩溃日志发现的。

整合包

欢迎收录，只要在整合包中注明 Stickshift，并链接回此页面即可。