IL-2 Series: Korea は IL-2 Great Battles と同じ系列のゲームですが、キー マッピングを新しい JSON 形式で保存します。全機体共通のプロファイル(「General」)が 1 つ、ゲームのインストール先にあります。JoyPro はこれをプロファイルに読み込み、リレーションでそのアクションをほかのゲームとまとめ、書き戻します。ゲームのカーブ エディターのレスポンス カーブとフォースフィードバックの設定も含みます。
IL-2 Series: Korea ネイティブ(ゲーム独自の割り当てファイル)
- 対応
- ネイティブ(ゲーム独自の割り当てファイル)
- エンジン コマンド
engine il2korea- 割り当てファイル
<install>\data\input\general.actions(JSON)+known.devices.json。カーブはgeneral.pitch/shared.responses、設定はdata\NSData\UserData\UserSettings.json- コマンド リストの取得元
general.actions。名前は IL-2 Great Battles の一覧または JoyPro の表現- ゲーム内テスト
- 49/49 ステップ合格(2026-10-11)
- ✓ インポート
- ✓ エクスポート
- ✓ キーボードの割り当て
- ✓ モディファイア
- ✓ PC 上で作成するコマンド リスト
- ✓ ゲーム監視
- ✓ 軸のカーブとデッドゾーン
- ✓ ゲームの操作設定
- ✓ ゲーム内のフォースフィードバック設定
- ✓ テレメトリによるフォースフィードバック
- ◐ テレメトリ記録ゲームのテレメトリーにはワールド内の位置がありません。記録して CSV としてエクスポートできますが、Tacview(ACMI)のトラックは作れません。
- ✓ 仮想ジョイスティック(vJoy)
- ◐ 仮想 Xbox パッド
- ✓ 仮想機能
- ✓ セットアップ ウィザード / 自動割り当て
- ✓ コックピット
- ✓ チートシート
- ✓ ゲーム内テスト
エンジンのコードから生成した対応表より: すべてのゲーム.
#3 ステップで使えるようにする
- すべて自動で設定
スタート ページで - このボタンを使う
先に一覧を確認 - ゲームに書き込む
ゲームは閉じたまま
事前準備:キー マッピングを一度保存します。Settings > Key mapping を開き、ACCEPT を押します。ゲームを閉じます。
その後:割り当ては、すべての機体で Settings > Key mapping にあります。
以前に IL-2 Korea でボタンを割り当てたことがありますか? その場合、スタート ページに インポートしてから空きを埋める が表示されます。今の割り当てはそのまま残り、空いているボタンにだけ新しい役割が付きます。クイック スタート:スティックを使えるようにする を参照してください。
#ヘッド トラッキングなしで見回す
TrackIR も VR もありませんか? セットアップで、スナップ ビューをスティックの 1 つのハット(前後左右)に割り当てます。スロットルにミニ スティックがあれば、視点の軸はそこに割り当てます。ヘッド トラッキングと見回し を参照してください。
#JoyPro が IL-2 Korea で行うこと
- インポート:スティック、スロットル、ペダル、パネルにあるキー マッピングのすべてのアクションを、モディファイア、各軸の反転、カーブ エディターの値ごとプロファイルに取り込みます。キーボードのキーは、指定した場合に取り込みます。
- リレーション:1 つのリレーションは、すべてのゲームで 1 つの機能です。たとえば Korea、IL-2 Great Battles、DCS の「Gear」を同じボタンにできます。Korea のキー マッピングは全機体共通です。
- エクスポート:JoyPro はキー マッピングを書き込み、ゲーム自身の「assign device number」ダイアログと同じように、各デバイスにデバイス番号を付けます。
#Korea の割り当てをインポート
- スタート を開きます。IL-2 Series: Korea のカードにはゲームの画像が表示されます。コマンド リストを求められたら リスト作成 を押します。JoyPro はゲームの
general.actionsを読み取ります(各アクションには JoyPro 独自の名前と説明が付きます)。 - カードの インポート を押します。プロファイルに追加 を選び、飛行用のキーも取り込みたい場合は キーボードのキーも取り込む にチェックを入れます。
- 今すぐインポート を押します。リレーションを表示 で取り込んだ内容を開けます。
#リレーションの作成と確認
リレーション ページでは、リレーションの Korea のアクションが、ほかのゲームの同じ機能と並んで表示されます。リレーションの流れ でそれらをまとめ、エクスポート ページで 今すぐ確認 を押します。Korea で 1 つのボタンが 2 つの役割を持っている箇所を見つけます(確認)。
#IL-2 Korea へのエクスポート
- ゲームを閉じます。
IL2Series.exeの実行中は JoyPro が書き込みを拒否します。 - エクスポート を開きます。IL-2 Series: Korea のカードには、リレーションのうちいくつが割り当て済みかが表示されます。
- JoyPro でスティックを設定しているなら、自分のデバイスで置き換え と ほかのデバイスもクリア をオンのままにします。カードの 今すぐエクスポート を押します。


ゲームを起動して Settings > Key mapping を開きます。割り当てはアクションの行(たとえば Basic タブ)に、デバイス名とその番号(「joy 2」)付きで表示されます。ゲームがデバイス番号を尋ねることはありません。軸の行のカーブ アイコンを押すと、JoyPro が書き込んだ値でレスポンス エディターが開きます。フォースフィードバックと軸のノイズ フィルターは Settings > Input devices に表示されます。
#IL-2 Korea で自分で行うこと
- キー マッピングを一度保存します。 Key mapping で ACCEPT を押すと、ゲームが
general.actionsを書き出します。初回起動時にはゲームの利用規約も表示されます。general.actionsがないと、エクスポート先がありません。 - スタンドアロン版は既定で
Program Filesの下にインストールされ、Windows がそのフォルダーを保護していることがあります。その場合、エクスポートはファイルを半分だけ書き込むことはせず、その旨を表示します。 - ゲームのテレメトリを使う JoyPro 独自のフォースフィードバックでは、フォースフィードバック ページがゲームの
startup.cfgに JoyPro のアドレスを追加します(先にゲームを閉じてください)。そのスティックについては、ゲーム自身のフォースフィードバックをオフにします。
#よくある落とし穴
- 「IL-2 Korea が実行中です」:ゲームを閉じて、もう一度エクスポートします。
- デバイスがスキップされた:デバイス番号がなく、接続もされていないデバイスには番号を付けられません。接続してから、もう一度エクスポートしてください。
- 「追加のみ」のあとで割り当てがない:その入力はゲームで別のアクションに使われていました。確認では「ゲームに書き込まれていません」の下に表示されます。
#JoyPro が読み書きするファイル
| ファイル | これは何か |
|---|---|
<install>\data\input\general.actions |
キーマッピングのプロファイル「General」(JSON):使用するデバイス、モディファイア、入力を持つすべてのアクション、Relative Control の値 |
<install>\data\input\known.devices.json |
ゲームが認識したすべてのデバイスと、そのデバイス番号 |
<install>\data\input\general.pitch |
ピッチのカーブ(「General (Common pitch curve)」) |
<install>\data\input\shared.responses |
その他の軸のカーブ |
<install>\data\NSData\UserData\UserSettings.json |
Settings > Input devices:フォースフィードバックと軸のノイズフィルター(セクション input) |
<install>\data\startup.cfg |
JoyPro のテレメトリーのアドレス(テレメトリーによるフォースフィードバックを設定したときのみ) |
general.actions.joypro-meta.json |
ファイルの隣に置く JoyPro の名前、グループ、モディファイア、チューニング。次回のインポートで読み戻されます |
Steam 版では <install> は steamapps\common\IL2Series、スタンドアロン版ではランチャーの下の game フォルダーです。current.map はゲームがコンパイルするもので、JoyPro は書き込みません。
#IL-2 Korea のエクスポートモード
| モード | ゲームで起きること |
|---|---|
| 追加のみ | 何も削除されません。ゲームが別のアクションに使っている入力への割り当ては書き込まれず、一覧に表示されます。 |
| 更新(ゲームの割り当てを優先) | あなたの割り当てが入ります。ゲームの他の入力は残りますが、あなたが別のアクションに使う入力にあるゲームの割り当ては除かれます。 |
| 更新(プロファイルを優先) | 上と同じで、さらに割り当てるすべてのアクションが他の入力を失います(ジョイスティック。キーボードはキーボードのオプション使用時のみ)。 |
| 自分のデバイスで置き換え | 書き込むデバイスのジョイスティック入力をすべて解除してから、あなたの割り当てを入れます。 |
| + ほかのデバイスもクリア | プロファイルに割り当てのない接続済みデバイスは、ジョイスティック入力を失います。 |
#一切変更しないもの
- 「置き換え」でのキーボードのキー、マウス入力、軸に付いたキーのペア(キーボードはキーボードのオプション使用時にだけ変わります)。
- 接続されていないデバイス、インポートで読み取れない行、インポートで無視したデバイス、JoyPro が転送先にしている vJoy デバイス。
current.map、デバイスごとのフォースフィードバックのファイル、ゲームのその他の設定。
#カーブ、Relative Control、フォースフィードバック
- 単位:グローバル。すべての機体で 1 つのキーマッピングです。ピッチのカーブのプロファイルは、既定ですべての機体に割り当てられます。
- 軸カーブ(軸モデル
il2korea):指数(-100 ~ 100)、中央と端のデッドゾーン、ピッチの中央のオフセット。ピッチ、ロール、ヨーには、組み込みの応答カーブと操縦翼面の荷重もあります。片側の軸(スロットル、ブレーキ)には、全行程にわたる指数と下端/上端のデッドゾーンが付きます。カメラの軸には編集画面がなく、カーブも付きません。値はファイルの単位で、ゲームではデッドゾーンが 4 倍の大きさで表示されます。 - Relative Control(軸入力の ◆ ボタン):オン/オフ、デッドゾーン(0 ~ 80 %)、感度(1 ~ 20)。ダイアログに表示されるとおりです。
- ゲーム設定(設定 > ゲームのフォースフィードバック設定):フォースフィードバックのオン、振動の強さ、フィードバックの強さ、低速と高速でのスティックの力、力のニュートラルの再調整、地面との接触、軸のノイズフィルター。ゲームと同じく % で表します。
- テレメトリーによるフォースフィードバック と記録:Great Battles と同じく、ゲームのテレメトリー出力から作ります(CSV のみ。Tacview のトラックはありません)。
- 監視:
general.actionsの変更はゲーム終了後に検出されます(監視)。
#Korea 連携の内部
flowchart LR P["あなたのプロファイル"] --> E["engine il2korea export"] E --> A["general.actions<br/>known.devices.json"] E --> R["general.pitch<br/>shared.responses"] E --> S["UserSettings.json"] A --> G["Settings ><br/>Key mapping"] R --> G
コード:engine\Games\Il2KoreaIntegration.cs、engine\AxisModels 内の軸モデル il2korea。
- 入力:
dev<N>_b<button, 0-based>、dev<N>_axis_<x|y|z|w|s|t|p|q>(X、Y、Z、RX、RY、RZ、スライダー 1、スライダー 2)、トークンの前の-= 反転、*= Relative Control、ハットはdev<N>_pov<hat>_<angle>、キーはkey_<name>、組み合わせは+でつなぎます。 - デバイス:
known.devices.jsonは、すべてのデバイスを DirectInput のインスタンス GUID(IL-2 のバイト順)で識別し、そのdeviceId(番号、-1= なし)とident(vid_pid)を保持します。JoyPro が書き込むデバイスは番号を保ちます。番号のない接続済みデバイスには、1 から数えて最も小さい空き番号が付きます。 - コマンド一覧:
engine il2korea refresh-dbはキーマッピングファイルのアクションを追加します。入力のないアクションはgeneral.actionsに入らないため、新しい一覧は約 318 アクションです。JoyPro はゲームの圧縮アーカイブを読み取りません。 - インポート / エクスポート:
engine il2korea import、engine il2korea scan、engine il2korea export(--mode、--nuke-untouched-devices、--include-keyboard、--dry-run)。engine il2korea pathsはファイルを表示します。 - 設定とカーブ:
engine ffb set--device * --game IL2Korea --param ffForce=80、engine binds tuning set--scope game:IL2Korea(またはfamily:il2)、engine binds tuning preview(中央のオフセットの平らな側を除き、ゲームがコンパイルした表と 1e-6 の精度で一致)。 - テレメトリ:
engine ffb telemetry setupil2korea。
#既知の制限
- ゲーム独自のアクションのテキストは圧縮アーカイブ内にあり、JoyPro はそれを読み取らないため、JoyPro 独自の名前を使います。
- Key mapping ページの約 60 のアクションは、新しい
general.actionsに入力がないため、新しく作った一覧には入りません。 - テスト:
engine\tests\smoke\il2korea.ps1、il2koreainstall.ps1。ゲーム内ではtools\e2e\games\IL2Korea.ps1(49 ステップ中 49 ステップ)、IL2KoreaCurves.ps1、IL2KoreaSettings.ps1。
このゲームに関するすべての技術メモ(リポジトリから生成): il2-korea.md.