X4: Foundations は割り当てを inputmap.xml に保存し、ジョイスティックを名前ではなく枠(1~8)で識別します。どのデバイスがどの枠にあるかは config.xml にあります。JoyPro は宇宙飛行の割り当てをプロファイルに読み込み、X4 がデバイスに固定した枠に、その場で書き戻します。X4 では反転とデッドゾーンがゲーム全体の設定なので、JoyPro はリレーションからゲーム全体の値として設定します。
X4: Foundations ネイティブ(ゲーム独自の割り当てファイル)
- 対応
- ネイティブ(ゲーム独自の割り当てファイル)
- エンジン コマンド
engine x4- 割り当てファイル
Documents\Egosoft\X4\<id>\inputmap.xml(XML)+config.xml内のスロット- ゲームが読み取る入力
- ジョイスティック1台につきボタン64個、軸8本、ハット1個を読み取ります(検証済み)
- コマンド リストの取得元
X4.exeの名前テーブルと.cat/.datアーカイブ- ゲーム内テスト
- 36/36 ステップ合格(2026-10-11)
- ✓ インポート
- ✓ エクスポート
- ✓ キーボードの割り当て
- ◐ モディファイアX4:キーボードの割り当てには Shift/Ctrl。ジョイスティックの割り当てにはモディファイアを使えません。
- ✓ PC 上で作成するコマンド リスト
- ✓ ゲーム監視
- ✗ 軸のカーブとデッドゾーンX4:ゲーム全体のデッドゾーンと反転だけ(Game settings)。割り当てごとの設定はありません。
- ✓ ゲームの操作設定
- ✗ ゲーム内のフォースフィードバック設定
- ✗ テレメトリによるフォースフィードバック
- ✗ テレメトリ記録
- ✓ 仮想ジョイスティック(vJoy)
- ◐ 仮想 Xbox パッド
- ✓ 仮想機能
- ✓ セットアップ ウィザード / 自動割り当て
- ✓ コックピット
- ✓ チートシート
- ✓ ゲーム内テスト
X Rebirth 記載のみ
- 対応
- 記載のみ
- エンジン コマンド
- なし
- — インポート
- — エクスポート
- — キーボードの割り当て
- — モディファイア
- — PC 上で作成するコマンド リスト
- — ゲーム監視
- — 軸のカーブとデッドゾーン
- — ゲームの操作設定
- — ゲーム内のフォースフィードバック設定
- — テレメトリによるフォースフィードバック
- — テレメトリ記録
- — 仮想ジョイスティック(vJoy)
- — 仮想 Xbox パッド
- — 仮想機能
- — セットアップ ウィザード / 自動割り当て
- — コックピット
- — チートシート
- — ゲーム内テスト
X3 (Reunion, Terran Conflict, Albion Prelude) 記載のみ
- 対応
- 記載のみ
- エンジン コマンド
- なし
- — インポート
- — エクスポート
- — キーボードの割り当て
- — モディファイア
- — PC 上で作成するコマンド リスト
- — ゲーム監視
- — 軸のカーブとデッドゾーン
- — ゲームの操作設定
- — ゲーム内のフォースフィードバック設定
- — テレメトリによるフォースフィードバック
- — テレメトリ記録
- — 仮想ジョイスティック(vJoy)
- — 仮想 Xbox パッド
- — 仮想機能
- — セットアップ ウィザード / 自動割り当て
- — コックピット
- — チートシート
- — ゲーム内テスト
エンジンのコードから生成した対応表より: すべてのゲーム.
#3 ステップで使えるようにする
- すべて自動で設定
スタート ページで - このボタンを使う
先に一覧を確認 - ゲームに書き込む
X4 は閉じたままで
事前に:すべてのデバイスに一度枠を割り当ててください。X4 の操作設定で Manage Controllers/Joysticks を開き、各デバイスを枠に割り当ててから、通常の方法でゲームを終了します。
その後:割り当ては Settings > Controls に入っています。
以前に X4 でボタンを割り当てていましたか? それならスタートページに インポートしてから空きを埋める が表示されます。今の割り当てはそのまま残り、空いているボタンだけに新しい役割が付きます。クイックスタート:スティックを使えるようにする を参照してください。
#JoyPro が X4 に対して行うこと
- インポート:スティック、スロットル、ペダルの宇宙飛行の割り当てが、ゲームの反転とスロットルモードと一緒にプロファイルに入ります。
- リレーション:1 つのリレーションは、すべてのゲームで 1 つの機能です。「Boost」を X4、Elite Dangerous、Star Citizen で同じボタンにできます。
- エクスポート:JoyPro は
inputmap.xmlを、デバイスの枠の上でその場で編集します。メニュー、一人称視点、キーボード、マウスの割り当てはそのまま残ります。
#X4 の割り当てをインポート
- 開始 を開きます。X4 のカードがコマンドリストを求めている場合は リスト作成 を押します。JoyPro がインストールからゲームの操作を読み取ります(読み取りのみ)。
- X4 のカードの インポート を押します。プロファイルに追加 のままにします。フライト用のキーも JoyPro に取り込みたい場合は キーボードのキーも取り込む にチェックを入れてください。
- 今すぐインポート を押します。リレーションを表示 で取り込んだ内容を開けます。
#リレーションの作成と確認
リレーションの流れ でゲーム間の同じ機能をつなげ、エクスポートページで 確認 を押してください。ジョイスティックの割り当てにはモディファイアを付けないでください。X4 はジョイスティックの割り当てにモディファイアを受け付けません。
#X4 へエクスポート
- X4 を閉じてください。 ゲームはセッション終了時に
inputmap.xmlとconfig.xmlを書き込むため、実行中は JoyPro が書き込みを拒否します。 - エクスポート を開き、X4 のカードにチェックを入れます。
- JoyPro でスティックを設定しているなら、自分のデバイスで置き換え と ほかのデバイスもクリア をオンのままにします。カードの 今すぐエクスポート を押します。
ゲームを起動して Settings > Controls を開きます。割り当ては、各宇宙飛行操作のコントローラー/ジョイスティックの列に、デバイスの枠で表示されます。Invert Controller / Joystick Axes には JoyPro が設定した反転が表示され、双方向スロットル、ジョイスティックのデッドゾーン、アダプティブステアリングの行にはあなたの値が表示されます。オートロールと振動はゲームの設定にあります。
#X4 で自分で行うこと
- すべてのデバイスに一度枠を割り当ててください。 X4 の操作設定で Manage Controllers/Joysticks を開き、スティック、スロットル、ペダルをそれぞれ枠に割り当ててから、通常の方法でゲームを終了します。これで X4 がデバイスを
config.xmlに記憶します。この記録がないデバイスはセッションごとに枠が変わるため、JoyPro は飛ばします(「assign the device to a slot in X4 once」)。そこで「none」に設定したデバイスも飛ばします。 - エクスポートの前にデバイスを接続してください。
#よくある落とし穴
- 「X4 が実行中です」:ゲームを終了して、もう一度エクスポートしてください。
- デバイスが飛ばされた:X4 で枠に固定されていません。Manage Controllers/Joysticks で割り当ててください。
- 枠 1 のスティックがゲームパッドの動作をする:枠 1 は X4 の既定のマップでゲームパッド用の枠なので、そこにあるスティックは標準のゲームパッドの割り当てを引き継ぎます。自分のデバイスで置き換え で削除できます。
- 65 番以降のボタンや 2 つ目のハットが効かない:X4 が読むのはデバイスごとに 64 ボタン、8 軸、ハット 1 つです。それを超える割り当ては JoyPro が警告を出して飛ばします。
- 反転が変更されなかった:1 つの反転は、その操作のすべてのデバイスに適用されます。リレーション同士で食い違う場合や、同じ操作にゲームパッドが割り当てられている場合、JoyPro はゲームの値を残して警告します。
#JoyPro が読み書きするファイル
| ファイル | これは何か |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
有効な割り当て(操作と入力ごとの <action>、<state>、<range>)と <config> のパラメーター(反転、デッドゾーン、双方向スロットル、アダプティブ ステアリング)。<id> は Steam アカウントのフォルダーです。 |
...\X4\<id>\config.xml |
デバイスのスロット(<joysticks>)と、振動、自動ロール、ゲームパッド モードなどのゲーム設定。スロットは読み込むだけ、設定はその場で編集します |
...\X4\<id>\inputmap.xml.joypro-meta.json |
書き込んだ割り当ての JoyPro の名前、グループ、チューニング。次回のインポートで読み戻されます |
inputmap.xml.jpbak、config.xml.jpbak |
最初の書き込み前のコピーと、JoyPro のバージョン管理されたバックアップ保存領域 |
ファイルはテキストとして書き込みます。宣言、改行、インデント、セクションのコメント、<config>、ルートの属性、触れていないすべての行は 1 バイトも変わりません。新しい行は、そのセクション内で、操作番号がより小さい同じ種類の最後のエントリーのあとに入ります。JoyPro は保存済みのプロファイル inputmap_1.xml ~ inputmap_5.xml やセーブ データには決して触れません。フォルダーは Steam Cloud が同期しますが、どのファイルを同期するかはまだ確認していません。
#X4 でのエクスポート モード
競合とは、同じスロットと入力にある別の飛行操作のことです。操作のマップ用と詳細モニター用の対になるものは、同じ操作として扱います。
| モード | inputmap.xml で起きること |
|---|---|
| 追加のみ | 何も削除しません。別の飛行操作が持つ入力への割り当ては書き込まず、「ゲームに書き込まれていません」と表示します。 |
| 更新(ゲームの割り当てを優先) | 自分の行は、その操作のほかの入力と並べて入れます。削除するのは競合だけです。 |
| 更新(プロファイルを優先) | 上記に加え、割り当てた操作は、接続中のデバイスの固定されたスロットでほかの行を失います(キーボードのオプションを使うとキーボードの行も)。 |
| 自分のデバイスで置き換え | 書き込んだスロットにある、プロファイルにない飛行の割り当ては削除されます。スロット 1 にある標準のゲームパッドの飛行の割り当ても削除されます。 |
| + ほかのデバイスもクリア | エクスポートが使わない接続中のデバイスに config.xml が固定しているスロットにも、同じことを行います。デバイスが固定されていないスロットはそのままです。そのデバイスがわからないためです。 |
X4 のメニューは、いくつかの操作をまとめて割り当てます。"Toggle Travel Mode" はマップ内でも同じ入力を設定し、"Dock" はドッキング解除も兼ねます。JoyPro はこうしたグループをメニューと同じように書き込み・削除し、一人称視点の "Interact" の対は決して削除しません。
#一切変更しないもの
- メニュー、マップ、一人称視点、オプション、アクセシビリティの操作。ラジアル メニューの項目。
- キーボードとマウスの行。キーボードはキーボードのオプションを使う場合にだけ、飛行操作についてのみ書き込み、X4 のメニューが受け付けないキー(Escape、Delete、Ctrl+X/C/V など)は決して使いません。
- 接続されていない、または固定されていないデバイスのスロット、ゲームパッド、インポートで無視したデバイス、JoyPro が入力を送り込む vJoy デバイス。
- JoyPro が設定しないすべての
<config>の行。
#カーブとゲームの設定
- 適用範囲:すべての宇宙船に 1 セットの割り当てです(宇宙飛行の操作)。
- 反転 は、操作ごとに全デバイス共通の 1 つの値です(
invert_steering_yaw、_pitch、_roll、invert_throttle、invert_strafe_*)。リレーションは DCS の向きを保ちます。X4 自身の HOTAS マップはピッチ、ロール、スロットルを反転として数えるため、それらについて JoyPro はパラメーターに自分の反転設定を逆にした値を入れます。その操作にあるすべての JoyPro の軸が一致した場合にだけ、パラメーターを設定します。 - 双方向スロットル は、スロットルのリレーションの スライダー に従います。スライダーあり = 前進のみ、スライダーなし = 中央が推力ゼロ。
- デッドゾーン:X4 のデッドゾーンは、すべてのジョイスティックのすべての軸で共通の 1 つです。リレーションのデッドゾーンは書き込みません(エクスポートでその旨が表示されます)。ゲームのデッドゾーンは 設定 > ゲームのフォースフィードバック設定(X4 を選択)か
engine ffb setで設定します。アダプティブ ステアリング、振動、自動ロール、ゲームパッド モードも同じ場所にあります。そこに保存した設定はリレーションより優先され、リレーションと逆になる場合は警告が出ます。 - X4 には軸ごとのカーブや飽和はありません。フォースフィードバックもテレメトリもありません。
- 監視機能:ゲームで変えた割り当てやオプションは、ゲームを閉じたあとに検出され(
inputmap.xmlとconfig.xml)、取り込むかどうかを JoyPro が尋ねます。 - HUD:HUD はプロセスからゲームを見つけ、X4 の割り当てを表示します。
#X Rebirth と X3
X Rebirth は X4 と同じ inputmap.xml の語を使いますが、そのコマンド一覧はインストールから独自に抽出する必要があります。X3(Reunion、Terran Conflict、Albion Prelude)は別のエンジンで、ファイル形式もわかっていません。どちらも情報のみで、JoyPro はインポートもエクスポートもしません。
#X4 連携の内部
flowchart LR D["あなたのデバイス<br/>(インスタンス GUID)"] --> C["config.xml<br/>joysticks"] C --> S["スロットに固定:<br/>スロット 1 ... 8"] C --> K["固定なし、または無効:<br/>読み飛ばし、X4 で<br/>一度割り当てる"] P["あなたのプロファイル"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>スロットごとの割り当て"] E --> O["ゲーム全体のオプション:<br/>反転、スロットルのモード"]
コード:engine\Games\X4Integration.cs、engine\Games\X4CatalogSource.cs、設定モデル engine\FfbModels\X4.cs。
- スロット:割り当ては入力元を
INPUT_SOURCE_JOYBUTTONS(ボタンとハット)またはINPUT_SOURCE_JOYAXESで示し、スロット 1 は接尾辞なし、ほかは_2~_8です。config.xmlは DirectInput の インスタンス GUID でデバイスをスロットに対応付けます。GUID は X4 独自の形式({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00})で書かれます。num0 ~ 7 がスロットで、disabled="1"はスロットなしを意味します。JoyPro が書き込むのは、現在の有効なエントリーが接続中のデバイスと一致するスロットだけです。 - コード:ボタン 1 ~ 11 は X4 のゲームパッド名(
INPUT_XBUTTON_A...BIGBUTTON)、12 ~ 64 はINPUT_XBUTTON_12...、ハットはINPUT_XBUTTON_DPAD_*(8 方向)、軸はINPUT_JOYAXIS_X...RZ、SLIDER1、SLIDER2です。範囲にはsgnを付けません。キーボード:INPUT_KEYCODE_<DIK>に_SHIFT/_CONTROL。 - コマンド一覧:
engine x4 refresh-dbは、.cat/.datアーカイブにあるgameoptions.luaと英語のテキスト ページ、X4.exeの名前テーブルを読み取り専用で読み込みます。宇宙飛行の操作は 128 個(軸 6 個、ボタン 122 個)です。行は "Yaw (Primary Steering Axis)"、"Roll (Secondary Steering Axis)" のように表示されます。engine x4 catalogで一覧を表示し、engine x4 pathsで見つかったファイルを表示します。 - インポート / エクスポート:
engine x4 import、engine x4 scan。engine x4 export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run。 - ゲームの設定:
engine ffb set --device * --game X4 --param <key>=<value>。パラメーターはその場で編集し、ないものは<config>の最後の行として追加します。X4 の割り当てがないエクスポートでも、保存した設定は書き込みます。
#既知の制限
- スロットが固定されていないデバイスは読み飛ばします。JoyPro が自分で固定する機能はまだありません。
- ジョイスティックのモディファイアは書き込みません。ファイル内での書き方がまだ確認できていないためです。
- デバイスごとにボタン 64 個、軸 8 本、ハット 1 つ。スロットは 8 つで、ゲームパッドと共有です。
- 振動:ゲームのスライダーは値を 100 倍して端数を切り捨てて表示します(21 % は 20 と表示)。ファイルには正確な値が残ります。
- テスト:
engine\tests\smoke\x4.ps1(カタログの更新も含む)。ゲーム内ではtools\e2e\games\X4.ps1(割り当てとモードの組み合わせ、専用のプロファイル フォルダーで実行)とtools\e2e\games\X4Settings.ps1(反転、スロットルのモード、ゲームの設定)。
このゲームに関するすべての技術メモ(リポジトリから生成): x4.md.