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)- 遊戲讀取的輸入
- 每支 joystick 讀取 128 個按鈕、8 個軸、4 個帽子開關(4 個方向)(已驗證)
- 指令清單來源
- 已安裝模組的
BYOJoystick.dll(Steam Workshop;在程式中:VTOL VR 卡片上的「安裝 BYOJoystick」),否則使用您自己的BYOJ_*.xml
- ✓ 匯入
- ✓ 匯出
- ✓ 鍵盤綁定
- ◐ 修飾鍵BYOJoystick:每個綁定一個修飾鍵(joystick 綁定用 joystick 按鈕,鍵盤綁定用按鍵)。
- ◐ 在您的電腦上建立指令清單VTOL VR(BYOJoystick):只有安裝了 BYOJoystick 模組才會建立清單。
- ✓ 遊戲監看
- ◐ 軸曲線與死區BYOJoystick:每個綁定一個死區值(接管門檻,或 slew 與傾斜的截斷);沒有曲線。
- ✓ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(vJoy)
- ◐ 虛擬 Xbox 手把
- ✓ 虛擬功能
- ✓ 設定精靈 / 自動指派
- ✓ 座艙
- ✓ 速查表
- ✗ 遊戲內測試
VTOL VR(原生:方向舵和煞車) 原生(使用自己的綁定檔案)
- 支援
- 原生(使用自己的綁定檔案)
- 引擎指令
engine vtolvr-native- 綁定檔案
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg(ConfigNode + Rewired XML)+gameSettings.cfg- 指令清單來源
- 遊戲的
level0
- ✓ 匯入
- ✓ 匯出
- ✗ 鍵盤綁定
- ✗ 修飾鍵
- ✓ 在您的電腦上建立指令清單
- ✓ 遊戲監看
- ◐ 軸曲線與死區VTOL VR 原生:僅支援反轉和軸範圍,沒有曲線和死區。
- ✓ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(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 joystick 對應表;由 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 (control settings, VR haptics):Hardware Control Rudder、Thumb Control Rudder、Twist Rudder Deadzone、Thumbstick Deadzone、Thumbstick Mode、Toggle Grip、Flight Control Haptics、Overall Haptics。原生匯出會把它們寫入
gameSettings.cfg,即使設定檔沒有原生綁定也一樣。 - 力回饋:VTOL VR 沒有 joystick 力回饋;觸覺回饋來自 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}行組成的文字檔;joystick 對應表是 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.