WARDOGS は Unreal Engine 5 製のヘリコプター戦闘ゲームです。独自のジョイスティックプラグインがすべての DirectInput デバイスを読み、割り当てを 1 つの設定ファイルに保存します。6 つの飛行軸と飛行アクションが、それぞれ属するデバイスと一緒に記録されます。JoyPro はこのセクションをプロファイルに読み込み、HOTAS ページの感度、デッドゾーン、Enable HOTAS スイッチと一緒に書き戻します。キーボード、マウス、ファイルのほかの部分はすべてそのまま残ります。
WARDOGS ネイティブ(ゲーム独自の割り当てファイル)
- 対応
- ネイティブ(ゲーム独自の割り当てファイル)
- エンジン コマンド
engine wardogs- 割り当てファイル
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini(Unreal の ini、ハッシュ化されたフィールド名)- コマンド リストの取得元
- あなたの
GameUserSettings.ini+ JoyPro の軸 - ゲーム内テスト
- 36/36 ステップ合格(2026-10-11)
- ✓ インポート
- ✓ エクスポート
- ✗ キーボードの割り当て
- ✗ モディファイア
- ✓ PC 上で作成するコマンド リスト
- ✓ ゲーム監視
- ✓ 軸のカーブとデッドゾーン
- ✓ ゲームの操作設定
- ✗ ゲーム内のフォースフィードバック設定
- ✗ テレメトリによるフォースフィードバック
- ✗ テレメトリ記録
- ✓ 仮想ジョイスティック(vJoy)
- ◐ 仮想 Xbox パッド
- ✓ 仮想機能
- ✓ セットアップ ウィザード / 自動割り当て
- ✓ コックピット
- ✓ チートシート
- ✓ ゲーム内テスト
エンジンのコードから生成した対応表より: すべてのゲーム.
#3 ステップで使えるようにする
- すべて自動で設定
スタート ページで - このボタンを使う
先に一覧を確認 - ゲームに書き込む
WARDOGS は閉じたままで
事前に:ゲームで Settings > GAMEPAD > HOTAS を一度開いてから閉じてください。
その後:Enable HOTAS がオンになり、割り当てが HOTAS ページに入っています。
以前に WARDOGS でボタンを割り当てていましたか? それならスタートページに インポートしてから空きを埋める が表示されます。今の割り当てはそのまま残り、空いているボタンだけに新しい役割が付きます。クイックスタート:スティックを使えるようにする を参照してください。
#JoyPro が WARDOGS に対して行うこと
- インポート:HOTAS ページの割り当てがプロファイルに入ります。Pitch、Roll、Yaw、コレクティブ(Throttle)、2 つの視点軸、飛行アクション(Fire、Flares、Reload、Horn、Ping ...)が、それぞれのデバイス上で、反転、感度、デッドゾーンと一緒に入ります。
- リレーション:1 つのリレーションで WARDOGS とほかのゲームを同時に扱えます。たとえば、WARDOGS と DCS のヘリコプターの両方で、スロットルレバーに「Collective」を割り当てられます。
- エクスポート:JoyPro はヘリコプターの割り当てをゲームの設定ファイルに書き込み、ゲームがそれを使うように Enable HOTAS をオンにします。
#WARDOGS の割り当てをインポート
- 開始 を開きます。WARDOGS のカードがコマンドリストを求めている場合は リスト作成 を押します。JoyPro があなたの設定ファイルと独自の軸の表からリストを作成します。
- WARDOGS のカードの インポート を押します。プロファイルに追加(推奨) のままにします。
- 今すぐインポート を押します。リレーションを表示 で取り込んだ内容を開けます。


#リレーションの作成と確認
リレーション ページで、WARDOGS のアクションをほかのゲームの同じ機能とつなげてください。リレーションの流れ を参照してください。その後、エクスポートページで 確認 を実行します。ゲームより先に、WARDOGS で 1 つのボタンが 2 つの動作をする箇所を見つけます。
#WARDOGS へエクスポート
- WARDOGS を閉じてください。 ゲームは終了時に設定ファイル全体を書き直すため、実行中は JoyPro が書き込みを拒否します。
- エクスポート を開き、WARDOGS のカードにチェックを入れます。
- JoyPro でスティックを設定しているなら、自分のデバイスで置き換え と ほかのデバイスもクリア をオンのままにします。カードの 今すぐエクスポート を押します。


WARDOGS を起動して Settings > GAMEPAD > HOTAS を開きます。Enable HOTAS がオンになっており、各軸の行にはデバイスと軸が反転ボックス、Sensitivity と Deadzone のスライダーと一緒に表示され、アクションにはボタンが表示されます。メニューはアクションのボタンを 0 から、軸の半分のボタンを 1 から数えるため、同じボタンが 2 つの異なる番号で表示されることがあります。
#WARDOGS で自分で行うこと
- 最初のエクスポートの前に HOTAS ページを一度開いてください。JoyPro はゲームのジョイスティックのセクションにしか書き込みません。ファイルにまだそのセクションがない場合、エクスポートは中止され、ゲームでそのページを開くよう求められます。
- Enable HOTAS がオンの間は、マウスとキーボードでの飛行がオフになります。JoyPro は割り当てを書き込むたびにこれをオンにします。自分で管理したい場合は、設定 > ゲームのフォースフィードバック設定(ゲーム WARDOGS)で設定してください。そこに保存した内容がエクスポートのたびに書き込まれます。
- 「Garage / Vendor」と「Free Look Reset」はまだ JoyPro のリストにありません。ゲーム内で一度割り当ててから、WARDOGS のカードの 更新 を押してください。JoyPro がファイル内で見つけたアクションを追加します。
#よくある落とし穴
- 「WARDOGS が実行中です」:ゲームを閉じて、もう一度エクスポートしてください。
- ゲームでデバイスが NOT CONNECTED と表示される:ゲームは VID:PID と DirectInput の名前でデバイスを識別します。デバイスを接続した状態でもう一度エクスポートしてください。JoyPro は、同じ VID:PID の接続中デバイスと名前が違う場合に修正します。
- 同じデバイスが 2 台ある:WARDOGS はそれらを区別できません(同じ名前になります)。仮想ジョイスティック を使うか、WARDOGS の割り当てには片方だけを使ってください。
- 飛行中に割り当てが効かない:HOTAS ページの Enable HOTAS を確認してください。オフだとゲームはジョイスティックの割り当てをすべて無視します。
#JoyPro が読み書きするファイル
| ファイル | これは何か |
|---|---|
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini |
セクション [/Script/WDJoystick.WDJoystickSettings] の割り当て。[/Script/WDGame.WDUserSettings] にあるゲーム全体のスイッチ Enable HOTAS(bUseHOTASHelicopters)と Self-Centering Collective(bCollectiveSelfCentering) |
...\GameUserSettings.ini.joypro-meta.json |
エクスポートした割り当ての JoyPro のデータ(リレーション名、グループ、調整)。次回のインポートで読み戻します |
...\GameUserSettings.ini.jpbak |
最初の書き込み前のバックアップ(JoyPro のバックアップ保管場所にも保存) |
同じファイルと Saved\SaveGames\EnhancedInputUserSettings.sav にあるキーボードの割り当ては読み書きしません。JoyPro はインストール先からは何も読み込みません。コマンド一覧の元になるのは自分の設定ファイルです。
#WARDOGS でのエクスポート モード
このゲームは 1 つのアクションに 1 つの割り当てを使います。どのモードも、JoyPro のカタログにあるヘリコプターのアクションだけを扱います。ファイルのほかの行やセクションは決して変わりません。
| モード | どうなるか |
|---|---|
| 追加のみ | 割り当てを入れるのは、アクションのスロットが空いていて、カタログにあるほかのアクションがそのボタンや軸を使っていない場合だけです。そうでなければ読み飛ばして「ゲームに書き込まれていません」と表示します。割り当て済みのスロットを置き換えることはありません。 |
| 更新(ゲームの割り当てを優先) | 自分の割り当てがアクションのスロットを使います(そこにある入力を置き換えます)。同じ入力にあるカタログ上の別のアクションは、その入力を失います。アクションの 2 行目は残ります。 |
| 更新(プロファイルを優先) | 上記に加え、アクションの余分な行も削除されるため、移動したアクションは完全に移ります。 |
| 自分のデバイスで置き換え | 書き込むデバイスには、カタログにあるアクションについて自分の割り当てだけが残ります。 |
| + ほかのデバイスもクリア | プロファイルに割り当てのない接続中のデバイスは、カタログにある割り当てを失います。 |
WARDOGS の割り当てがないプロファイルをエクスポートすると、保存しておいたゲーム全体の設定だけを書き込みます。
#一切変更しないもの
- キーボードとマウスの割り当て、キーボードのセーブ ファイル、ジョイスティックのセクション以外のすべてのセクション(2 つのゲーム全体のスイッチを除く)。
- JoyPro のカタログにないアクション:その行はそのままです。
- 接続されていないデバイス、インポートで無視したデバイス、JoyPro が転送先にしている vJoy デバイス。
- 割り当て行の未知のフィールド:そのまま残します。
#軸、感度、デッドゾーン
- 全体共通:WARDOGS には機体や車両ごとのプロファイルがなく、割り当てはすべてのヘリコプターに適用されます。
- 軸ごと:反転、Sensitivity(0.1 ~ 2.0、1 = 変化なし)、デッドゾーン(0 ~ 0.5)。HOTAS ページ自身の単位で、小数点以下 2 桁に丸めます。インポートはこれらをリレーションの WARDOGS 用の調整として保存するため、ほかのゲームは独自のカーブを保ちます。
- WARDOGS の値がない場合、JoyPro は基本のカーブから近似します:デッドゾーンはそのまま引き継ぎ、感度は飽和までの傾きに合わせます。WARDOGS はコレクティブを中央のある軸として扱うため、スライダーのデッドゾーンは引き継ぎません。曲がり具合やユーザー カーブは表現できないため、エクスポートで警告が出ます。
- ゲームにはプレビューがなく、計算式もわかっていません。JoyPro のプレビューは、反転、再スケールしたデッドゾーン、そのあとに感度を掛け、最大の傾きで切り詰めると仮定しています(まだ未確認)。
- ゲームの設定:Enable HOTAS と Self-Centering Collective(スティック 2 本の構成向け:手を離すとコレクティブがホバーの位置に戻ります。スロットル レバーではオフのままにしてください)。設定 > ゲームのフォースフィードバック設定 にあります。ファイルにそのキーがすでにある場合にだけ書き込みます。WARDOGS にフォースフィードバックはありません。
- 監視機能:HOTAS ページで変えた割り当ては、ゲームを閉じたあとに検出され、取り込むかどうかを JoyPro が尋ねます(監視機能)。
- HUD:WARDOGS の実行中、HUD は押したボタンごとにそのアクションの名前を表示します。
#WARDOGS 連携の内部
flowchart LR P["あなたのプロファイル"] --> E["engine wardogs export"] E --> S["GameUserSettings.ini"] E --> H["Enable HOTAS をオン"] E --> M[".joypro-meta.json"] S --> G["Settings > GAMEPAD<br/>> HOTAS"] H --> G
コード:engine\Games\WardogsIntegration.cs、engine\AxisModels\Wardogs.cs(軸モデル wardogs)、engine\FfbModels\Wardogs.cs(2 つのゲーム全体のスイッチ)。
- ファイル:ASCII、CRLF、BOM なし、1 行目は
;METADATA=(Diff=true, UseCommands=true)。軸の行は常に 6 つすべてで、順序は Pitch、Throttle、Roll、Yaw、LookPitch、LookYaw です。ActionBindings=(Action=<action>,Binding=(...))は割り当てたアクションごとに 1 回で、新しい行は最後の行のあとに入ります。軸の割り当て解除はDeviceIdentifier=""、アクションの割り当て解除はその行の削除で行います。浮動小数点数は小数点以下 6 桁です。名前は ASCII のままにします(ASCII 以外の名前があると、エンジンが UTF-16 で保存してしまいます)。 - フィールド名:ほとんどのフィールドはハッシュ化されたトークン(
_aaaa...)です。JoyPro はこれらを決め打ちにせず、読める目印(DeviceIdentifier、bInvert、Positive、Sensitivity、DeadZone)の隣という位置で各フィールドを見つけ、形が変わったら処理を止めます。 - デバイス:
DeviceIdentifier="VID:PID:<DirectInput instance name>"。VID と PID は DirectInput の製品 GUID から取り、名前は DirectInput が報告するとおりに、両端の空白も含めて使います(決して切り詰めません)。軸の番号は DIJOYSTATE2 のスロット(0 X、1 Y、2 Z、3 Rx、4 Ry、5 Rz、6/7 スライダー)です。ボタンは 0 から数えます。 - コマンド一覧:
engine wardogs refresh-dbが自分の設定ファイルと JoyPro の軸から作ります。engine wardogs catalogで一覧を表示し、engine wardogs pathsで JoyPro が探す場所を表示します。 - インポート / エクスポート:
engine wardogs scan、engine wardogs import、engine wardogs export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --ignore-device <d> --dry-run。 - ゲームの設定:
engine ffb set--device * --game Wardogs --param enableHotas=true(またはselfCenteringCollective)。
#既知の制限
- アクションの完全な一覧はわかっていません。JoyPro は実際のファイルで確認できたアクションを一覧にしています。
- アクションとしてのハットの方向:エンコード方法はまだ確認していません。
- Sensitivity と Deadzone の応答の計算式はわかっていません。
- 同じデバイスは同じ識別子になり、衝突します。
- テスト:
engine\tests\smoke\wardogs.ps1。ゲーム内ではtools\e2e\games\Wardogs.ps1(割り当て)、WardogsSettings.ps1(HOTAS ページの値)、Watchdog.ps1(監視機能)。
このゲームに関するすべての技術メモ(リポジトリから生成): wardogs.md.