JoyPro2 Discord GitHub
游戏

VTOL VR

显示:

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 步上手

  1. 全部帮我设置好
    在开始页面
  2. 使用这些按钮
    先查看列表
  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(只需一次)

  1. 打开开始页面,在 VTOL VR 卡片上按 安装 BYOJoystick。会出现一个面板,显示这个模组是什么、它的官方来源(Steam 创意工坊、GitHub 上的源代码)、它的大小,以及这台电脑上是否已有 VTOL VR Mod Loader 和该模组。
  2. 勾选表示你已了解 BYOJoystick 是什么并希望从 Steam 创意工坊安装它的复选框,然后按 安装 BYOJoystick。JoyPro 会备份你的 BYOJ 文件并打开 Steam:如果 Steam 提示,请安装 Mod Loader,然后在 BYO Joystick 页面上按 Subscribe。Steam 会下载这个模组;JoyPro 不会复制其中的任何内容。
  3. 按 重新检查:JoyPro 会找到该模组,并据此生成它的 VTOL VR 命令列表。

#导入你的绑定

在 VTOL VR 卡片(BYOJoystick)或原生部分的卡片上按 导入,然后按 立即导入。对于 BYOJoystick,同时获取键盘按键 会把你的键盘绑定也一并导入。

开始页面和你的游戏开始页面和你的游戏
开始页面和你的游戏 (图片显示的是英文版应用。)

#建立并检查关联

像其他游戏一样建立关联(关联流程);设置向导和自动分配了解 BYOJoystick 的目标。然后在导出页面上运行检查。

#导出到 VTOL VR

  1. 关闭 VTOL VR。 游戏运行时(进程 VTOLVR)JoyPro 会拒绝写入。
  2. 打开 导出,如果你是在 JoyPro 中设置设备的,请保持 在我的设备上替换 并勾选 同时清除我的其他设备。
  3. 在 VTOL VR 卡片(BYOJoystick)上按 立即导出;对于脚舵,在原生卡片上也按一下。
在游戏中: 你在 VTOL VR 中会看到什么

在游戏中,当你的配置文件设置了 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"]
JoyPro 中的两个游戏:BYOJoystick 模组的文件(游戏 SaveData 中每个座位一个 BYOJ_seat.xml),以及游戏自带的方向舵和趾刹(inputbindings.cfg,以及 gameSettings.cfg 中的 Hardware Control Rudder)。

代码: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.