IL-2 Great Battles は、全機体共通のキー マッピングを 1 つ、ゲームのインストール先(data\input)にあるテキスト ファイルに保存します。JoyPro はそのキー マッピングをプロファイルに読み込み、リレーションでそのアクションをほかのゲームとまとめられるようにし(IL-2 と DCS の「Gear」を同じボタンに)、書き戻します。ゲームは起動時にファイルをコンパイルするので、飛行中に JoyPro が動作することはありません。
IL-2 Sturmovik: Great Battles ネイティブ(ゲーム独自の割り当てファイル)
- 対応
- ネイティブ(ゲーム独自の割り当てファイル)
- エンジン コマンド
engine il2- 割り当てファイル
<install>\data\input\*.actions、current.responses、global.pitch、current.devices。jp.actionsの付属ファイル- ゲームが読み取る入力
- ジョイスティック1台につきボタン128個、軸8本、ハット4個を読み取ります(ドキュメントに記載)
- コマンド リストの取得元
- ゲームが書き出す
data\input\*.actionsファイル - ゲーム内テスト
- 38/38 ステップ合格(2026-10-11)
- ✓ インポート
- ✓ エクスポート
- ✓ キーボードの割り当て
- ✓ モディファイア
- ✓ PC 上で作成するコマンド リスト
- ✓ ゲーム監視
- ✓ 軸のカーブとデッドゾーン
- ✓ ゲームの操作設定
- ✓ ゲーム内のフォースフィードバック設定
- ✓ テレメトリによるフォースフィードバック
- ◐ テレメトリ記録ゲームのテレメトリーにはワールド内の位置がありません。記録して CSV としてエクスポートできますが、Tacview(ACMI)のトラックは作れません。
- ✓ 仮想ジョイスティック(vJoy)
- ◐ 仮想 Xbox パッド
- ✓ 仮想機能
- ✓ セットアップ ウィザード / 自動割り当て
- ✓ コックピット
- ✓ チートシート
- ✓ ゲーム内テスト
エンジンのコードから生成した対応表より: すべてのゲーム.
#3 ステップで使えるようにする
- すべて自動で設定
スタート ページで - このボタンを使う
先に一覧を確認 - ゲームに書き込む
IL-2 は閉じたまま
事前準備:IL-2 にキー マッピングを一度書き出させます。Settings > Key mapping を開き、ACCEPT を押します。IL-2 を閉じます。
その後:割り当ては、すべての IL-2 機体で Settings > Key mapping にあります。
以前に IL-2 でボタンを割り当てたことがありますか? その場合、スタート ページに インポートしてから空きを埋める が表示されます。今の割り当てはそのまま残り、空いているボタンにだけ新しい役割が付きます。クイック スタート:スティックを使えるようにする を参照してください。
#ヘッド トラッキングなしで見回す
TrackIR も VR もありませんか? セットアップで、スナップ ビューをスティックの 1 つのハット(前後左右)に割り当てます。スロットルにミニ スティックがあれば、視点の軸はそこに割り当てます。ヘッド トラッキングと見回し を参照してください。
#JoyPro が IL-2 Great Battles で行うこと
- インポート:スティック、スロットル、ペダル、パネルにあるキー マッピングのすべてのアクションを、モディファイア、軸の反転、軸の応答の行ごとプロファイルに取り込みます。キーボードのキーは、指定した場合に取り込みます。
- リレーション:1 つのリレーションは、すべてのゲームで 1 つの機能です。IL-2 のキー マッピングは全機体共通なので、リレーションの IL-2 アクションはすべての IL-2 機体で使えます。
- エクスポート:JoyPro はゲームの
data\inputフォルダーにあるキー マッピング ファイルに書き込みます。割り当ては IL-2 の Settings > Key mapping に表示されます。
#IL-2 の割り当てをインポート
- スタート を開きます。IL-2 Great Battles のカードにはゲームの画像が表示されます。コマンド リストを求められたら リスト作成 を押します。JoyPro は IL-2 が書き出したキー マッピング ファイルを読み取ります。
- カードの インポート を押します。プロファイルに追加(または このゲームから最初からやり直す)を選び、飛行用のキーも取り込みたい場合は キーボードのキーも取り込む にチェックを入れます。
- 今すぐインポート を押します。リレーションを表示 で取り込んだ内容を開けます。


#リレーションの作成と確認
リレーション ページでは、リレーションの各 IL-2 アクションが、ほかのゲームの同じ機能と並んで表示されます。リレーションの流れ でそれらをまとめ、エクスポート ページで 今すぐ確認 を押します。IL-2 で 1 つのボタンが 2 つの役割を持っている箇所を、ゲームより先に見つけます(確認)。
#IL-2 へのエクスポート
- IL-2 を閉じます。
Il-2.exeの実行中は JoyPro が書き込みを拒否します。 - エクスポート を開きます。IL-2 のカードには、リレーションのうちいくつが割り当て済みかが表示されます。
- JoyPro でスティックを設定しているなら、自分のデバイスで置き換え と ほかのデバイスもクリア のままにします。IL-2 のカードの 今すぐエクスポート を押します。


IL-2 を起動して Settings > Key mapping を開きます。割り当ては、各タブ(たとえば Plane controls)のアクションの行に、デバイスごとに表示されます。JoyPro が書き込んだ軸の応答は、この起動からゲームで使われます。JoyPro が設定したフォースフィードバックとノイズ フィルターの値は Settings > Input devices に表示されます。
#IL-2 で自分で行うこと
- IL-2 にキー マッピングを一度書き出させます。
data\inputにまだglobal.actionsがない場合は、Settings > Key mapping を開いて ACCEPT を押します。このファイルがないとインポートするものがなく、コマンド リストにはゲームが書き出したアクションしか入りません。 - フォースフィードバックとノイズ フィルターの値について:Settings > Input devices を一度開いて ACCEPT を押し、ゲームに
current.devicesファイルを作成させます。JoyPro はこのファイルを変更しますが、作成はしません。 - ゲームのテレメトリを使う JoyPro 独自のフォースフィードバックでは、フォースフィードバック ページがゲームの
startup.cfgに JoyPro のアドレスを追加します(先に IL-2 を閉じてください)。そのあと、そのスティックについては IL-2 自身のフォースフィードバックをオフにします。
#よくある落とし穴
- 「IL-2 が実行中です」:ゲームを完全に終了し、もう一度エクスポートします。
- 割り当てが別のデバイスに付いている:IL-2 はデバイスを
devices.txtの番号で区別します。JoyPro が書き込むデバイスは番号がそのまま残り、新しいデバイスには空いている最小の番号が付きます。エクスポートとインポートの間に、ゲーム内でデバイスの番号を付け直さないでください。 - 「追加のみ」のあとで割り当てがない:そのボタンは IL-2 で別のアクションに使われていました。確認では「ゲームに書き込まれていません」の下に表示されます。更新 でエクスポートするか、割り当てを移動してください。
- フォースフィードバックの値が変わらない:ゲームにまだ
current.devicesがありません(上記参照)。
#JoyPro が読み書きするファイル
| ファイル | これは何か |
|---|---|
<install>\data\input\global.actions |
キーマッピング:アクションごとに 1 行、`action, input, invert |
<install>\data\input\devices.txt |
デバイスの一覧:各ジョイスティックの番号、DirectInput の GUID、名前 |
<install>\data\input\current.responses |
アクションごとの軸の応答の行(中央あり、片側)。すべての機体に共通 |
<install>\data\input\global.pitch |
中央のずらしを含むピッチの行(設定したときだけ作成) |
<install>\data\input\jp.actions |
リレーション名、グループ、モディファイア、チューニングを含む JoyPro のコピー。次回のインポートで読み戻されます |
<install>\data\input\current.devices |
Settings > Input devices:フォースフィードバックとジョイスティックのノイズフィルター(その場で変更) |
<install>\data\startup.cfg |
フォースフィードバックの値と JoyPro のテレメトリーのアドレス |
current.map は、IL-2 が起動のたびにこれらのファイルからコンパイルします。JoyPro は書き込みません。
#IL-2 のエクスポートモード
| モード | IL-2 で起きること |
|---|---|
| 追加のみ | 何も削除されません。IL-2 が既に別のアクションに使っている入力への割り当ては書き込まれず、「ゲームに書き込まれていません」の印が付きます。 |
| 更新(ゲームの割り当てを優先) | あなたの割り当てが入ります。IL-2 の他の割り当ては残りますが、あなたが使う入力にある別のアクションの割り当ては除かれます。 |
| 更新(プロファイルを優先) | 上と同じで、さらに割り当てるすべてのアクションが他の入力を失います(ジョイスティック。キーボードはキーボードのオプション使用時のみ)。 |
| 自分のデバイスで置き換え | 書き込むジョイスティックには、あなたの割り当てだけが残ります。 |
| + ほかのデバイスもクリア | プロファイルに割り当てのない接続済みジョイスティックは、割り当てを失います。 |
global.actions はゲームの順序を保ち、新しい行は末尾に追加されます。
#一切変更しないもの
- 接続されていないジョイスティックの行、インポートで無視したデバイス、JoyPro が転送先にしている vJoy デバイス。
- マウスの行(キーボードのキーと組み合わせたマウス入力も)、TrackIR、JoyPro が読み取れない入力を含む行。
- キーボード(キーボードの割り当てをエクスポートしない限り)。
current.mapとゲームの他のファイル。
#機体、カーブ、フォースフィードバック
- 単位:グローバル。アクションごとに 1 つのキーマッピングと 1 つの応答の行で、すべての機体をカバーします。
- 軸カーブ(軸モデル
il2):中央ありの軸には中央のデッドゾーン、端のデッドゾーン、カーブ(「sensitivity balance」)。スロットルなどの片側の軸には下端と上端のデッドゾーン。ピッチには中央のずらし。既定のカーブ は IL-2 のモデルに合わせて変換されます。IL-2 だけ、または IL-2 ファミリー(Great Battles と Korea は互いの値を読み取ります)用に設定することもできます。反転はアクションの行に書き込みます。 - ゲーム設定(設定 > ゲームのフォースフィードバック設定):ジョイスティックのノイズフィルター、フォースフィードバックのオン、フィードバックの強さ、振動。IL-2 の割り当てがないエクスポートでもこれらは書き込まれます。
- テレメトリーによるフォースフィードバック:ゲームのテレメトリー出力から JoyPro 独自の効果を作ります(フォースフィードバック)。同じ出力がテレメトリ記録にも使われます(CSV。テレメトリーにはワールド上の位置がないため、Tacview のトラックはありません)。
- HUD:IL-2 の実行中、押したボタンの IL-2 での割り当てを表示します(HUD)。
- 監視:Key mapping で変更した割り当ては IL-2 の終了後に検出され、JoyPro がそれを取り込むかどうかを尋ねます(監視)。
#IL-2 連携の内部
flowchart LR P["あなたのプロファイル"] --> E["engine il2 export"] E --> A["global.actions<br/>+ jp.actions"] E --> D["devices.txt"] E --> R["current.responses<br/>global.pitch"] A --> G["current.map<br/>(起動時)"] D --> G R --> G G --> K["Settings ><br/>Key mapping"]
コード:engine\EngineIl2.cs(インポート、エクスポート、ファイル)、engine\EngineIl2DbRefresh.cs(コマンド一覧)、engine\AxisModels(モデル il2)、engine\EngineFfbTelemetry.cs(テレメトリーの設定)。
- 入力:
joy<N>_b<button, 0-based>、joy<N>_axis_<x|y|z|...>、joy<N>_pov<hat>_<angle>、キーボードのキーは DirectInput の名前、軸のペアは<input>/<input>、モディファイアは<modifier>+<input>。IL-2 はハットを 0 から、JoyPro は 1 から数えます(JOY_BTN_POV1_*はpov0)。 - デバイス:
devices.txtには<number>,"<GUID>",<name>|が並びます。IL-2 は DirectInput のインスタンス GUID の最後の 8 バイトを逆順にして 1 つのグループとして書き込みます。どのモードでも、既に載っている番号は保たれます。 - コマンド一覧:
engine db refresh-il2は、ゲームが書いた*.actionsファイル(jp.actions以外)を読み取ります。ゲームのタブ(Service、Camera controls、Plane controls、Weapons controls ...)がカテゴリーになります。ゲームは入力のあるアクションしか書き込まないため、新規インストールでの一覧は約 376 アクションです。 - インポート / エクスポート:
engine il2 import、engine il2 scan、engine il2 export(--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --ignore-device <d>)。バックアップ:最初の書き込み前に、すべてのファイルを<file>.jpbakとバックアップ保存領域に保存します。 - 設定とカーブ:
engine ffb set--device * --game IL2Game、engine binds tuning set--scope game:IL2Gameまたはfamily:il2、engine binds tuning preview。 - テレメトリ:
engine ffb telemetry setupil2はstartup.cfgのtelemetrydeviceセクションにアドレスの行127.0.0.1:41994を 1 行追加し、他のツールのアドレスは変更しません。--removeでファイルをバイト単位で元に戻します。 - 監視:
engine sync status、engine sync diff(監視対象:global.actions、devices.txt、current.responses、current.devices、startup.cfg)。
#既知の制限
- ゲームのファイルで入力のないアクションは、新しく作ったコマンド一覧には入りません。
- JoyPro のテレメトリーによるフォースフィードバックを使うスティックでは、ゲーム独自のフォースフィードバックをオフにする必要があります。
- テスト:
engine\tests\smoke\il2.ps1。ゲーム内ではtools\e2e\games\IL2Game.ps1(割り当て、38 ステップ中 38 ステップ)とIL2GameCurves.ps1(ゲームがコンパイルした応答と JoyPro のプレビューの比較)。
このゲームに関するすべての技術メモ(リポジトリから生成): README.md.