
控制灵活载具
Control Flex 与 Vehicles 之间的兼容性桥梁
Control Flex × Vehicles
一个用于 ControlFlex 的载具输入桥接 —— 为读取原始输入的载具模组提供手柄驾驶支持。 按类别构建 —— Immersive Vehicles 是第一个适配器。
功能说明
没有这个模组,手柄完全无法驾驶这些载具。
载具模组不会像玩家那样驾驶,因此它们也不会像玩家那样读取输入。Immersive Vehicles 直接调用
GLFW.glfwGetKey(window, keyCode),从不查看 KeyMapping 或 InputConstants。
ControlFlex 的 keyMapping / virtualKbm / glfwPoll 通道都在这个边界处止步 —— 而 GLFW 本身
在 Forge 上无法被注入,因为该库的类由系统类加载器加载,永远不会
经过 ModLauncher 的转换器。
载具面对的是一个并不存在的键盘。手柄面对的是一个它无法触及的载具。
这个桥接位于载具的读取路径内部。当载具询问“W 是否被按住?”时,它会根据
玩家自身的移动信号来回答 —— input.forwardImpulse / leftImpulse,即原版移动所使用的
同一 tick 级数值,经过 ControlFlex 的模拟策略和响应曲线处理后。当这些值为零时(模拟
移动关闭),它会回退到 ControlFlex 的 move_forward … 动作状态。
**结果:**摇杆转向,载具收到它期望的精确数字按键,“玩家 正在移动”和“载具看到按键”永远不会出现分歧。
为载具而生的桥接,而非为单个模组打的补丁
上述故障并非 Immersive Vehicles 的怪癖 —— 它是整个类别的形态。驾驶是一种 控制方案,而非某个模组的功能:载具模组将其实现为自己的输入层 —— 原始按键 轮询、自己的按键配置、自己的输入界面。逐个模组打补丁会为每个载具重复相同的翻译 工作,而每份副本都会逐渐偏离。
因此桥接分为两部分:
| 层级 | 职责 |
|---|---|
| 载具控制核心 | “前进”的含义、阈值、模拟 → 数字、动作回退、键盘优先级 —— 一次定义,由所有适配器共享。 |
| 载具适配器 | 载具请求按键的唯一位置。对于 Immersive Vehicles 即 InterfaceInput#isKeyPressed;对于其他载具则是该载具自己的读取路径。轻量,且是唯一的逐模组代码。 |
这种划分体现在模组的身份中,而不仅仅是文档里:ID 是 cfx_compat_vehicles,而非
cfx_compat_mts。命名空间即类别。
目前适配器为 Immersive Vehicles (MTS) 而存在。这是首个集成,而非 模组的形态:第二个载具模组只需向同一层添加一个读取路径钩子,即可原样继承上述所有规则。 核心从不轮询、从不存储状态,在没有载具询问之前不做任何事。
如果没有安装受支持的载具模组,桥接处于惰性状态。
将适配器置于 ControlFlex 核心之外,也使核心免于第三方依赖:如果某个 载具集成出错,它只会让这个模组崩溃 —— 而不是每个玩家的手柄。
特性
- 用手柄驾驶 —— 前进、刹车/倒车、左转、右转,通过载具已经读取的移动键 传递。
- 模拟感知 —— 在 ControlFlex 曲线处理后读取 tick 级脉冲,阈值为 0.3,高于 0.15 的摇杆死区;死区、曲线和层都是你为行走已经调好的那些。
- 单一事实来源 —— 桥接与原版移动读取相同的脉冲,因此手柄 和载具永远不会对玩家是否在移动产生分歧。
- 键盘仍然优先 —— 物理按住的按键会在咨询桥接之前返回;桥接只补充 键盘未提供的按键。
- 无轮询 —— 没有 tick 处理器,没有逐帧扫描;只有在载具 实际询问时才计算答案。
- 无按键注入 —— 不向 GLFW 或
KeyMapping写入任何内容;桥接回答查询,它 不伪造输入。 - 无新增绑定 —— 它使用 ControlFlex 现有的移动路径,因此模拟摇杆或你
步行时已经使用的四个
move_*动作同样可以驾驶载具。 - 可选的载具依赖 —— 没有受支持的载具模组时,模组会加载、记录日志,然后不做任何事。
- 仅客户端 —— 无服务端组件,无数据包。
- 无兼容 JSON —— 桥接直接读取 ControlFlex 的信号,因此没有需要与 核心模组配置格式保持同步的规则集。
四个槽位
| 槽位 | 载具动作 (IV) | ControlFlex 动作 |
|---|---|---|
| 前进 | car.gas |
move_forward |
| 刹车 / 倒车 | car.brake |
move_backward |
| 左转 | car.turn_l |
move_left |
| 右转 | car.turn_r |
move_right |
通常桥接读取模拟脉冲;move_* 动作是模拟移动关闭时的回退方案。无论哪种方式,
都没有新东西需要学习 —— 你步行时已经使用的移动控制即可驾驶
载具。
工作原理
手柄摇杆 / 扳机
↓
ControlFlex 模拟策略 + 响应曲线
↓
player.input.forwardImpulse / leftImpulse ← 原版移动使用的同一数值
↓
载具询问:isKeyPressed(W) ← mcinterface1201.InterfaceInput
↓
cfx-compat-vehicles:若脉冲 / 动作表明则视为按住
↓
载具行驶,完全如同 W 被按住
两个细节承担了大部分工作:
- 为什么是读取路径。 GLFW 在 Forge 上无法被修补,而 ControlFlex 写入按键状态而非 触发按键事件,因此没有任何上游通道能触及轮询操作系统的载具。载具自身的输入 调用是唯一同时拥有问题和玩家的地方。
- 为什么没有“玩家是否在驾驶?”的检查。
isKeyPressed只被载具的控制 系统调用;被调用本身就是证明。无需反射进入载具,无需驾驶状态追踪。
兼容性
- ✅ 可在单人游戏和多人游戏中运行 —— 仅客户端,服务端无需任何东西。
- ✅ 与键盘共存。物理按键原样返回,因此一次按下永远不会触发两次。
- ✅ 遵循你当前的 WASD 绑定,包括重映射的布局。
- ✅ 不修改 ControlFlex 或 Immersive Vehicles —— 一个 mixin,作用于 IV 的输入接口。
- 📌 载具端为数字信号:载具被告知“按住 / 未按住”。模拟手感来自 阈值被跨越的时机,而非部分轴值。
已知限制
- Immersive Vehicles 自身的按键绑定会被忽略。 桥接比较的是 Minecraft 的移动键码。
如果
car.gas/car.turn_*在config/mtsconfigclient.json中被重映射,请将它们重置为W/A/S/D。 - 不要绑定 IV 的内置摇杆。 如果任何 IV 控制被分配了摇杆轴或按钮,IV 会设置
kbOverride并完全停止读取键盘 —— 桥接将没有可回答的对象。 - 其他载具模组尚未接入。 适配器层是它们接入的地方;目前仅支持 Immersive Vehicles。
不支持
- 向载具传递模拟轴 —— 载具 API 对每个按键询问布尔值;桥接将意图翻译为 该模型,而不替代它。
- 载具菜单和 HUD —— 仅回答四个移动键。
- 服务端使用 —— 没有服务端组件。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。