VTOL VR は VR 専用の空戦フライトゲームで、VR コントローラーで仮想のスティックとスロットルを操作して飛びます。ゲーム自体が割り当てられる物理デバイスの軸は、ラダーと左右のトーブレーキの 3 つだけで、すべての機体で 1 つのファイルに保存されます。HOTAS のフル対応(スティック、スロットル、すべてのスイッチ、機体と座席ごと)は無料の BYOJoystick MOD で実現します。JoyPro は両方を 2 つのゲームとして扱います。VTOL VR (BYOJoystick mod) は MOD の割り当てファイルに、VTOL VR (native rudder and brakes) はゲーム自身のファイルとその操作設定に書き込みます。
VTOL VR(BYOJoystick Mod) ネイティブ(ゲーム独自の割り当てファイル)
- 対応
- ネイティブ(ゲーム独自の割り当てファイル)
- エンジン コマンド
engine vtolvr- 割り当てファイル
<install>\SaveData\BYOJ_<seat>.xml(XmlSerializer)- ゲームが読み取る入力
- ジョイスティック1台につきボタン128個、軸8本、ハット4個(4方向)を読み取ります(検証済み)
- コマンド リストの取得元
- インストール済み Mod の
BYOJoystick.dll(Steam Workshop。プログラムでは VTOL VR のカードにある「BYOJoystick をインストール」)、なければあなた自身のBYOJ_*.xml
- ✓ インポート
- ✓ エクスポート
- ✓ キーボードの割り当て
- ◐ モディファイアBYOJoystick:割り当て1つにつきモディファイア1つ(ジョイスティックの割り当てにはジョイスティックのボタン、キーボードの割り当てにはキー)。
- ◐ PC 上で作成するコマンド リストVTOL VR(BYOJoystick):一覧は BYOJoystick Mod がインストールされている場合にだけ作成されます。
- ✓ ゲーム監視
- ◐ 軸のカーブとデッドゾーンBYOJoystick:割り当て1つにつきデッドゾーンの値が1つ(引き継ぎのしきい値、またはスルーと傾きのカット)。カーブはありません。
- ✓ ゲームの操作設定
- ✗ ゲーム内のフォースフィードバック設定
- ✗ テレメトリによるフォースフィードバック
- ✗ テレメトリ記録
- ✓ 仮想ジョイスティック(vJoy)
- ◐ 仮想 Xbox パッド
- ✓ 仮想機能
- ✓ セットアップ ウィザード / 自動割り当て
- ✓ コックピット
- ✓ チートシート
- ✗ ゲーム内テスト
VTOL VR(ネイティブ:ラダーとブレーキ) ネイティブ(ゲーム独自の割り当てファイル)
- 対応
- ネイティブ(ゲーム独自の割り当てファイル)
- エンジン コマンド
engine vtolvr-native- 割り当てファイル
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg(ConfigNode + Rewired XML)+gameSettings.cfg- コマンド リストの取得元
- ゲームの
level0
- ✓ インポート
- ✓ エクスポート
- ✗ キーボードの割り当て
- ✗ モディファイア
- ✓ PC 上で作成するコマンド リスト
- ✓ ゲーム監視
- ◐ 軸のカーブとデッドゾーンVTOL VR ネイティブ:反転と軸の範囲のみ。カーブとデッドゾーンはありません。
- ✓ ゲームの操作設定
- ✗ ゲーム内のフォースフィードバック設定
- ✗ テレメトリによるフォースフィードバック
- ✗ テレメトリ記録
- ✓ 仮想ジョイスティック(vJoy)
- ◐ 仮想 Xbox パッド
- ✓ 仮想機能
- ✓ セットアップ ウィザード / 自動割り当て
- ✗ コックピット
- ✓ チートシート
- ✗ ゲーム内テスト
エンジンのコードから生成した対応表より: すべてのゲーム.
#3 ステップで使えるようにする
- すべて自動で設定
スタート ページで - このボタンを使う
先に一覧を確認 - ゲームに書き込む
VTOL VR は閉じたままで
事前に:VTOL VR のカードで BYOJoystick をインストール を押してください(一度だけ、下記参照)。ペダルを接続して VTOL VR を一度起動し、Settings を OK で閉じてください。
その後:ゲームの設定で Hardware Control Rudder をオンにしてください。オフだとゲームはラダーを無視します。
以前に VTOL VR でボタンを割り当てていましたか? それならスタートページに インポートしてから空きを埋める が表示されます。今の割り当てはそのまま残り、空いているボタンだけに新しい役割が付きます。クイックスタート:スティックを使えるようにする を参照してください。
#JoyPro が VTOL VR に対して行うこと
- BYOJoystick ありの場合:MOD が提供するすべてのターゲット(スティックとスロットルの軸、ギア、フラップ、兵装、カウンターメジャー、レーダー、ライト、MFD ボタンなど)を、機体と座席ごとに、スティック、スロットル、キーボードから操作できます。
- MOD なしの場合:ゲーム自身の Rudder、Wheel Brake L、Wheel Brake R と、Controls メニューの設定(Hardware Control Rudder、VR のデッドゾーン、触覚フィードバック)。
- リレーション:1 つのリレーションは 1 つの機能です。BYOJoystick へのエクスポートでは、そのターゲットを持つ機体のすべての座席ファイルに書き込みます。
#BYOJoystick をインストール(一度だけ)
- 開始 を開き、VTOL VR のカードで BYOJoystick をインストール を押します。パネルに、MOD の説明、公式の入手元(Steam Workshop、GitHub のソースコード)、サイズ、そしてこの PC に VTOL VR Mod Loader と MOD があるかどうかが表示されます。
- BYOJoystick について読み、Steam Workshop からインストールすることを確認するボックスにチェックを入れ、BYOJoystick をインストール を押します。JoyPro は BYOJ ファイルをバックアップして Steam を開きます。Steam に聞かれたら Mod Loader をインストールし、BYO Joystick のページで Subscribe を押してください。MOD は Steam がダウンロードし、JoyPro は何もコピーしません。
- 再確認 を押します。JoyPro が MOD を見つけ、そこから VTOL VR のコマンドリストを作成します。
#割り当てをインポート
VTOL VR のカード(BYOJoystick)またはネイティブ部分のカードで インポート を押し、今すぐインポート を押します。BYOJoystick では、キーボードのキーも取り込む でキーボードの割り当ても取り込めます。


#リレーションの作成と確認
ほかのゲームと同じようにリレーションを作ります(リレーションの流れ)。セットアップウィザードと自動割り当ては BYOJoystick のターゲットを把握しています。その後、エクスポートページで 確認 を実行してください。
#VTOL VR へエクスポート
- VTOL VR を閉じてください。 ゲームの実行中(プロセス
VTOLVR)は JoyPro が書き込みを拒否します。 - エクスポート を開きます。デバイスの設定を JoyPro で行っている場合は、自分のデバイスで置き換え と ほかのデバイスもクリア のままにしてください。
- VTOL VR のカード(BYOJoystick)で 今すぐエクスポート を押し、ペダル用にはネイティブのカードでも押します。
ゲーム内では、プロファイルで設定していれば Settings で Hardware Control Rudder がオンになっており、Bindings には Rudder、Wheel Brake L、Wheel Brake R がデバイスとその軸と一緒に表示されます。BYOJoystick の割り当ては MOD 自身のウィンドウに機体の座席ごとに表示され、その Load でファイルを読み込み直します。
#VTOL VR で自分で行うこと
- ペダルを接続して VTOL VR を一度起動し、Settings を OK で閉じてください。ゲームがデバイスを一覧に載せ、
gameSettings.cfgを作成します。ネイティブのエクスポートは、ゲームが一覧に載せたデバイスにだけ書き込み、設定ファイルを新しく作ることはありません。 - Hardware Control Rudder はオンにする必要があります。オフだとゲームはラダー軸とブレーキ軸を無視します。ゲーム内でオンにするか、JoyPro(詳細)に保存してネイティブのエクスポートで書き込んでください。
- BYOJoystick には Steam の VTOL VR Mod Loader が必要です。JoyPro は Steam のページを開くだけです。
#よくある落とし穴
- ラダーが効かない:Hardware Control Rudder がオフです。ゲームは機体の出現時にこの設定を読みます。
- トーブレーキが片方しか効かない、または両方がスロットルのトリガーに連動する:ゲームがペダルからブレーキを取るのは、Wheel Brake L が割り当てられているときだけです。両方を割り当ててください。
- トーブレーキが踏み込みの後半でしか効かない:ゲームはブレーキを 0~1 として読みます。そのリレーションの軸範囲を 正のみ(詳細)にしてください。JoyPro はこの場合に警告を出します。
- 同じペダルが 2 台ある:ゲームはデバイスのモデルごとにマップを 1 つしか持たないため、両方が同じアクションを動かします。
- BYOJoystick の割り当てが消えた:MOD はファイルを読み込むときに、その機体にないターゲットを削除します。
#JoyPro が読み書きするファイル
| ファイル | これは何か |
|---|---|
<install>\SaveData\BYOJ_<seat>.xml |
機体の 1 つの座席の 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 |
インストール済みの MOD:読み取り専用で、対象一覧の取得に使います |
<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 の軸:反転と、割り当てごとの MOD の デッドゾーン の数値 1 つ。Joystick Pitch、Roll、Yaw と Throttle、Power、Collective では、これはデッドゾーンではなく、マルチプレイでもう 1 人の乗員から操縦を引き継ぐのに HOTAS が必要とする傾きの量です。SOI Slew X/Y と Articulate Tilt では、小さな値を再スケールせずに切り捨てます。それ以外では MOD はこの値を使いません。カーブはありません。axis-curves を参照してください。
- ネイティブの軸:反転と、トーブレーキの軸の範囲(Full または Positive)。デッドゾーンとカーブは書き込めません。
- モディファイア:BYOJoystick は座席ファイルごとにモディファイア ボタンを 1 つ持てます(それを必要とする割り当ては、押している間だけ動作します)。キーボードの割り当てには、モディファイア キーを 1 つ付けられます。ネイティブの部分にはありません。
- 操作設定:設定 > ゲームのフォースフィードバック設定 で、ゲーム 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 MOD"] 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 の製品文字列 + 10 進の PID + 製品 GUID。Rewired が知らないデバイスではhardwareGuidはゼロです。要素はデバイスの n 番目の軸です。 - コマンドリスト:
engine vtolvr refresh-dbは、インストール済みのBYOJoystick.dllを読み込みも実行もせずに(メタデータと文字列リテラルから)対象を読み取り、次に自分のBYOJ_*.xmlを読み込みます。MOD がなければ一覧はありません。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 でテストしています。現在のゲーム バージョンで MOD が読み込まれるかどうかは、まだ確認していません。
- ネイティブ:Rewired が知らないデバイスの軸の順序と正確なデバイス識別子は、ゲームのコードから得たもので、ゲームが書いたファイルではまだ確認していません。
- BYOJoystick:ハットの斜め方向、軸の対象へのボタン、ボタンの対象への軸は、警告付きで読み飛ばします。
- JoyPro には BYOJoystick のどの部分も含まれていません。そのコマンド一覧は、MOD がインストールされているときにだけ存在します。
- テスト:
engine\tests\smoke\vtolvr.ps1(インポートの往復、独自の値、ゲーム全体の設定、設定だけのエクスポート)。
このゲームに関するすべての技術メモ(リポジトリから生成): vtol-vr.md.