VTOL VR 是一款只能在 VR 中玩的空战飞行游戏:你用 VR 控制器操作虚拟摇杆和油门来飞行。游戏本身只绑定实体设备的三个轴,即方向舵和两个脚刹,并把它们保存在一个所有飞机共用的文件中。完整的 HOTAS 支持(摇杆、油门、每个开关,按飞机和座位)来自免费的 BYOJoystick 模组。JoyPro 把两者当作两个游戏处理:VTOL VR (BYOJoystick mod) 写入模组的绑定文件,VTOL VR (native rudder and brakes) 写入游戏自己的文件及其控制设置。
VTOL VR(BYOJoystick 模组) 原生(使用游戏自己的绑定文件)
- 支持
- 原生(使用游戏自己的绑定文件)
- 引擎命令
engine vtolvr- 绑定文件
<install>\SaveData\BYOJ_<seat>.xml(XmlSerializer)- 游戏读取的输入
- 每个摇杆读取 128 个按钮、8 个轴、4 个苦力帽(4 个方向)(已验证)
- 命令列表来源
- 已安装模组的
BYOJoystick.dll(Steam Workshop;在程序中:VTOL VR 卡片上的“安装 BYOJoystick”),否则使用你自己的BYOJ_*.xml
- ✓ 导入
- ✓ 导出
- ✓ 键盘绑定
- ◐ 修饰键BYOJoystick:每个绑定一个修饰键(摇杆绑定用摇杆按钮,键盘绑定用按键)。
- ◐ 在你的电脑上生成命令列表VTOL VR(BYOJoystick):只有安装了 BYOJoystick 模组才会生成列表。
- ✓ 游戏监视器
- ◐ 轴曲线和死区BYOJoystick:每个绑定一个死区值(接管阈值,或 slew 和倾斜的截断);没有曲线。
- ✓ 游戏控制设置
- ✗ 游戏内力反馈设置
- ✗ 基于遥测数据的力反馈
- ✗ 遥测录制
- ✓ 虚拟摇杆(vJoy)
- ◐ 虚拟 Xbox 手柄
- ✓ 虚拟功能
- ✓ 设置向导 / 自动分配
- ✓ 座舱
- ✓ 速查表
- ✗ 游戏内测试
VTOL VR(原生:方向舵和刹车) 原生(使用游戏自己的绑定文件)
- 支持
- 原生(使用游戏自己的绑定文件)
- 引擎命令
engine vtolvr-native- 绑定文件
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg(ConfigNode + Rewired XML)+gameSettings.cfg- 命令列表来源
- 游戏的
level0
- ✓ 导入
- ✓ 导出
- ✗ 键盘绑定
- ✗ 修饰键
- ✓ 在你的电脑上生成命令列表
- ✓ 游戏监视器
- ◐ 轴曲线和死区VTOL VR 原生:仅支持反转和轴范围,没有曲线和死区。
- ✓ 游戏控制设置
- ✗ 游戏内力反馈设置
- ✗ 基于遥测数据的力反馈
- ✗ 遥测录制
- ✓ 虚拟摇杆(vJoy)
- ◐ 虚拟 Xbox 手柄
- ✓ 虚拟功能
- ✓ 设置向导 / 自动分配
- ✗ 座舱
- ✓ 速查表
- ✗ 游戏内测试
摘自支持矩阵(根据引擎代码生成): 所有游戏.
#3 步上手
- 全部帮我设置好
在开始页面 - 使用这些按钮
先查看列表 - 写入我的游戏
保持 VTOL VR 关闭
之前:在 VTOL VR 卡片上按 安装 BYOJoystick(只需一次,见下文)。连接脚舵后启动一次 VTOL VR,并用 OK 离开 Settings。
之后:在游戏设置中开启 Hardware Control Rudder,否则游戏会忽略你的方向舵。
以前在 VTOL VR 中绑定过按钮?那么开始页面会提供 导入,然后填补空缺。你的绑定会保留,只有空闲的按钮会获得新功能。请参见快速入门:让我的摇杆工作。
#JoyPro 能为 VTOL VR 做什么
- 使用 BYOJoystick 时:模组为每个载具和座位提供的所有目标(摇杆和油门轴、起落架、襟翼、武器、干扰弹、雷达、灯光、MFD 按钮等),可来自你的摇杆、油门和键盘。
- 不使用模组时:游戏自己的 Rudder、Wheel Brake L 和 Wheel Brake R,以及其 Controls 菜单中的设置(Hardware Control Rudder、VR 死区、触觉反馈)。
- 关联:一个关联就是一个功能;BYOJoystick 导出会把它写入所有载具具有该目标的座位文件。
#安装 BYOJoystick(只需一次)
- 打开开始页面,在 VTOL VR 卡片上按 安装 BYOJoystick。会出现一个面板,显示这个模组是什么、它的官方来源(Steam 创意工坊、GitHub 上的源代码)、它的大小,以及这台电脑上是否已有 VTOL VR Mod Loader 和该模组。
- 勾选表示你已了解 BYOJoystick 是什么并希望从 Steam 创意工坊安装它的复选框,然后按 安装 BYOJoystick。JoyPro 会备份你的 BYOJ 文件并打开 Steam:如果 Steam 提示,请安装 Mod Loader,然后在 BYO Joystick 页面上按 Subscribe。Steam 会下载这个模组;JoyPro 不会复制其中的任何内容。
- 按 重新检查:JoyPro 会找到该模组,并据此生成它的 VTOL VR 命令列表。
#导入你的绑定
在 VTOL VR 卡片(BYOJoystick)或原生部分的卡片上按 导入,然后按 立即导入。对于 BYOJoystick,同时获取键盘按键 会把你的键盘绑定也一并导入。


#建立并检查关联
像其他游戏一样建立关联(关联流程);设置向导和自动分配了解 BYOJoystick 的目标。然后在导出页面上运行检查。
#导出到 VTOL VR
- 关闭 VTOL VR。 游戏运行时(进程
VTOLVR)JoyPro 会拒绝写入。 - 打开 导出,如果你是在 JoyPro 中设置设备的,请保持 在我的设备上替换 并勾选 同时清除我的其他设备。
- 在 VTOL VR 卡片(BYOJoystick)上按 立即导出;对于脚舵,在原生卡片上也按一下。
在游戏中,当你的配置文件设置了 Hardware Control Rudder 时,Settings 会显示它已开启;Bindings 会列出 Rudder、Wheel Brake L 和 Wheel Brake R 以及你的设备和对应的轴。BYOJoystick 的绑定位于模组自己的窗口中,按载具座位排列;它的 Load 会重新读取这些文件。
#你在 VTOL VR 中需要自己做的事
- 连接脚舵后启动一次 VTOL VR,并用 OK 离开 Settings。游戏随后会列出你的设备并创建
gameSettings.cfg;原生导出只写入游戏已列出的设备,并且从不创建设置文件。 - 必须开启 Hardware Control Rudder,否则游戏会忽略方向舵和刹车轴。请在游戏中开启它,或在 JoyPro 中保存这个设置(高级),让原生导出把它写入。
- BYOJoystick 需要 Steam 上的 VTOL VR Mod Loader;JoyPro 只会打开 Steam 页面。
#常见问题
- 方向舵没有反应:Hardware Control Rudder 处于关闭状态。游戏在载具生成时读取这个设置。
- 只有一个脚刹有效,或者两个都跟着油门扳机动:只有当 Wheel Brake L 已绑定时,游戏才会从你的脚舵读取刹车。请把两个都绑定。
- 脚刹只在行程的后半段才刹车:游戏把刹车读作 0 到 1。把该关联的轴范围设为 正向(高级);JoyPro 会对这种情况发出警告。
- 两个相同的脚舵:游戏为每个设备型号只保存一个映射,所以两者会控制同一个操作。
- 某个 BYOJoystick 绑定消失了:模组在加载文件时会丢弃载具没有的目标。
#JoyPro 读取和写入的文件
| 文件 | 这是什么 |
|---|---|
<install>\SaveData\BYOJ_<seat>.xml |
一个载具座位的 BYOJoystick 绑定:AV42C、FA26B、F45A、AH94Front、AH94Rear、T55Front、T55Rear、EF24GFront、EF24GRear |
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg |
游戏自身的绑定:文本文件中的 Rewired 摇杆映射;由 Steam Cloud 同步 |
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\gameSettings.cfg |
Settings > Controls 中的数值(HARDWARE_RUDDER 等);由 Steam Cloud 同步 |
<library>\steamapps\workshop\content\3018410\3276352374\BYOJoystick.dll |
已安装的模组:只读,用于获取其目标列表 |
<install>\VTOLVR_Data\level0 |
游戏的 Rewired 操作列表:只读,用于原生命令列表 |
旧版文件 <install>\SaveData\inputbindings.cfg 从不写入。每次写入前都会先备份,并以原子方式完成(先写临时文件,再替换):游戏会用一个空文件替换损坏的 inputbindings.cfg。
#VTOL VR 中的导出模式
| 模式 | BYOJoystick(每个座位一个文件) | 原生(inputbindings.cfg) |
|---|---|---|
| 仅添加 | 不覆盖座位上的任何绑定:如果某个绑定的输入已被另一个目标使用(修饰键状态相同),该绑定会被列为未写入。 | 只使用空闲的轴;已被占用的轴会被列为未写入。 |
| 更新,保留游戏的绑定 | 你的输入上原有的其他目标会失去它;其他一切保持不变,包括被移动目标的旧输入。 | 你的轴上原有的操作会被替换;其他一切保持不变。 |
| 更新,以我的配置文件为准 | 同上,另外你的目标会失去它们在已连接设备上的其他输入(按键只有在开启键盘选项时才会)。 | 同上,另外你的操作会失去它们在已连接设备上的其他轴。 |
| 在我的设备上替换 | JoyPro 写入的设备只保留你的绑定。 | 已写入设备上的其他操作会被清除。 |
| + 同时清除我的其他设备 | 没有绑定的已连接设备会被清除。 | 没有绑定的已连接设备会被清除。 |
#绝不会改动的内容
- 未连接的设备、导入时忽略的设备,以及 JoyPro 转发到的 vJoy 设备。
- BYOJoystick:JoyPro 无法读取的输入,以及座位的修饰键按钮(除非你的配置文件自带修饰键)。
- 原生:按钮映射、键盘和鼠标映射、输入行为、校准映射、控制器分配以及 System 玩家。BYOJoystick 导出不会写入
gameSettings.cfg。 - 键盘,除非你导出键盘绑定(仅限 BYOJoystick)。
#座位、轴、设置
- 粒度:BYOJoystick 按载具座位区分(一个目标会写入每个拥有它的座位);原生部分是全局的。
- BYOJoystick 轴:反转,以及该模组为每个绑定提供的一个 死区 数值。在 Joystick Pitch、Roll、Yaw 以及 Throttle、Power、Collective 上,它不是死区,而是多人游戏中 HOTAS 从另一名机组成员手中接管控制所需的偏转量;在 SOI Slew X/Y 和 Articulate Tilt 上,它会截掉较小的数值但不重新缩放;在其他地方模组不使用它。没有曲线。参见 axis-curves。
- 原生轴:反转,以及趾刹的轴范围(Full 或 Positive)。死区和曲线无法写入。
- 修饰键:BYOJoystick 每个座位文件支持一个修饰键按钮(需要它的绑定只在按住它时才生效);键盘绑定可以有一个修饰键。原生部分没有修饰键。
- 控制设置:设置 > 游戏的力反馈设置,游戏 VTOL VR(控制设置、VR 触觉反馈):Hardware Control Rudder、Thumb Control Rudder、Twist Rudder Deadzone、Thumbstick Deadzone、Thumbstick Mode、Toggle Grip、Flight Control Haptics、Overall Haptics。原生导出会把它们写入
gameSettings.cfg,即使配置文件中没有原生绑定也会写入。 - 力反馈:VTOL VR 没有摇杆力反馈;触觉反馈来自 VR 控制器。
- 监视器:BYOJ 文件,以及原生部分的
gameSettings.cfg(监视器)。
#VTOL VR 集成的内部机制
flowchart LR P["你的配置文件"] --> B["engine vtolvr export"] P --> N["engine vtolvr-native<br/>export"] B --> X["BYOJ_seat.xml"] N --> I["inputbindings.cfg"] N --> S["gameSettings.cfg"] X --> M["BYOJoystick 模组"] I --> G["VTOL VR:<br/>Bindings"]
代码:engine\Games\VtolVrIntegration.cs(BYOJoystick)、VtolVrMod.cs(安装状态、目标列表)、ClrMetadata.cs、VtolVrNativeIntegration.cs、engine\AxisModels\VtolVr.cs(byoj、vtolnative)、engine\FfbModels\VtolVr.cs(控制设置)。
- BYOJoystick 格式:.NET XML 序列化,根元素
<Bindings>,包含<KeyboardBindings>(Target、Key、ModifierKey,使用 Unity KeyCode 名称)和<JoystickBindings>(Target、JoystickId、Input、RequiresModifier、Invert、Deadzone、POVDirection)。Input:X Y Z RX RY RZ、S1 S2、PoV1..PoV4、B1..B128。设备通过 DirectInput 实例 GUID(JoystickId)区分。 - 原生格式:一个文本文件,根为
RewiredSaveData,内容为{key} = {value}行;摇杆映射是 Rewired XML(在 UTF-8 文件中声明为 UTF-16)。操作:0 Rudder、5 Wheel Brake L、6 Wheel Brake R。映射以设备型号为键:hardwareIdentifier=WindowsRawInput+ 去掉空格的 HID 产品字符串 + 十进制 PID + 产品 GUID,对于 Rewired 不认识的设备,hardwareGuid为零。元素是该设备的第 n 个轴。 - 命令列表:
engine vtolvr refresh-db从已安装的BYOJoystick.dll中读取目标(读取其元数据和字符串常量,不加载也不运行它),然后读取你自己的BYOJ_*.xml;没有该模组就没有列表。engine vtolvr-native refresh-db从level0读取 Rewired 操作列表。 - 命令:
engine vtolvr mod(status、prepare --accept-license)、engine vtolvr scan、engine vtolvr import、engine vtolvr export、engine vtolvr-native scan、engine vtolvr-native import、engine vtolvr-native export,设置则用engine ffb set--device * --game VTOLVR。
#已知限制
- 尚未在游戏中运行过;BYOJoystick 是用替身 DLL 测试的。该模组能否在当前游戏版本中加载尚未确认。
- 原生:Rewired 不认识的设备的轴顺序以及确切的设备标识符取自游戏的代码,尚未从游戏写入的文件中得到验证。
- BYOJoystick:苦力帽斜向、轴目标上的按钮以及按钮目标上的轴会被跳过,并给出警告。
- JoyPro 不附带 BYOJoystick 的任何部分;只有安装了该模组,它的命令列表才存在。
- 测试:
engine\tests\smoke\vtolvr.ps1(导入往返、自定义数值、全游戏范围的设置、仅设置的导出)。
关于此游戏的所有技术说明(根据代码仓库生成): vtol-vr.md.