JoyPro2 Discord GitHub
ゲーム

IL-2 Sturmovik: Great Battles

表示:

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 ステップで使えるようにする

  1. すべて自動で設定
    スタート ページで
  2. このボタンを使う
    先に一覧を確認
  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 の割り当てをインポート

  1. スタート を開きます。IL-2 Great Battles のカードにはゲームの画像が表示されます。コマンド リストを求められたら リスト作成 を押します。JoyPro は IL-2 が書き出したキー マッピング ファイルを読み取ります。
  2. カードの インポート を押します。プロファイルに追加(または このゲームから最初からやり直す)を選び、飛行用のキーも取り込みたい場合は キーボードのキーも取り込む にチェックを入れます。
  3. 今すぐインポート を押します。リレーションを表示 で取り込んだ内容を開けます。
ゲーム一覧が表示されたスタート ページゲーム一覧が表示されたスタート ページ
ゲーム一覧が表示されたスタート ページ (画像は英語版のアプリを表示しています。)

#リレーションの作成と確認

リレーション ページでは、リレーションの各 IL-2 アクションが、ほかのゲームの同じ機能と並んで表示されます。リレーションの流れ でそれらをまとめ、エクスポート ページで 今すぐ確認 を押します。IL-2 で 1 つのボタンが 2 つの役割を持っている箇所を、ゲームより先に見つけます(確認)。

#IL-2 へのエクスポート

  1. IL-2 を閉じます。 Il-2.exe の実行中は JoyPro が書き込みを拒否します。
  2. エクスポート を開きます。IL-2 のカードには、リレーションのうちいくつが割り当て済みかが表示されます。
  3. JoyPro でスティックを設定しているなら、自分のデバイスで置き換え と ほかのデバイスもクリア のままにします。IL-2 のカードの 今すぐエクスポート を押します。
エクスポート ページエクスポート ページ
エクスポート ページ
ゲーム内: 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"]
IL-2 は次回の起動時に、これらのファイル(data/input:ゲームの順序を保った global.actions 内の割り当て、jp.actions 内の名前とグループ、devices.txt 内のデバイスごとの joy 番号、current.responses と global.pitch 内のカーブ)をキーマッピングにコンパイルします。

コード: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 setup il2 は 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.