JoyPro2 Discord GitHub
ゲーム

Microsoft Flight Simulator 2024

表示:

MSFS 2024 は、操作設定をデバイスとカテゴリ(Airplanes と General)ごとのプロファイルに保存し、デバイスと機体ごとにどのプロファイルを使うかを記憶します。JoyPro はこれらのプロファイルを自分の 1 つのプロファイルに読み込み、Steam 版でも Microsoft Store 版でも、シムが実際に使っているプロファイルに割り当てを書き戻します。シムがまだそのデバイス用に設定していない機体については、JoyPro がシムの Community2024 フォルダーに小さなパッケージとして独自のプリセットを追加します。プロファイルに書き込めない場合は、シムの Controls メニューでインポートするためのファイルを用意します。

Microsoft Flight Simulator 2024 ネイティブ(ゲーム独自の割り当てファイル)
対応
ネイティブ(ゲーム独自の割り当てファイル)
エンジン コマンド
engine msfs2024
割り当てファイル
シムがデバイスとカテゴリーごとに使うあなた自身のプロファイル(Steam の remote\inputprofile_* XML または Microsoft Store のセーブ、--user-profiles)+ JoyPro の Community パッケージ(joypro-input-profiles、デバイスごとにプリセット XML を1つ)。プロファイルに書き込めない場合は Documents\JoyPro2\MSFS 2024 import files にインポート用ファイル
ゲームが読み取る入力
ジョイスティック1台につき軸8本、ハット1個(4方向)を読み取ります(ドキュメントに記載)
コマンド リストの取得元
Asobo のプリセットファイル、fs-base\en-US.locPak に記載された飛行イベント、インストール済みの機体
ゲーム内テスト
26/26 ステップ合格(2026-10-11)
  • ✓ インポート
  • ✓ エクスポート
  • ✗ キーボードの割り当て
  • ◐ モディファイアMSFS:モディファイアボタンは同じデバイスのものだけです。
  • ✓ PC 上で作成するコマンド リスト
  • ✓ ゲーム監視
  • ✓ 軸のカーブとデッドゾーン
  • ✗ ゲームの操作設定
  • ✗ ゲーム内のフォースフィードバック設定
  • ✗ テレメトリによるフォースフィードバック
  • ✓ テレメトリ記録
  • ✓ 仮想ジョイスティック(vJoy)
  • ◐ 仮想 Xbox パッド
  • ✓ 仮想機能
  • ✓ セットアップ ウィザード / 自動割り当て
  • ✓ コックピット
  • ✓ チートシート
  • ✓ ゲーム内テスト

エンジンのコードから生成した対応表より: すべてのゲーム.

初心者向け

#3 ステップで使えるようにする

  1. すべて自動で設定
    スタート ページで
  2. このボタンを使う
    先に一覧を確認
  3. ゲームに書き込む
    シムは閉じたまま

事前準備:すべてのデバイスを一度接続します。

その後:MSFS 2024 プロファイル の欄を確認します。インポート ファイルが挙げられていますか? その場合は、そのファイルをシムでインポートします(下記の 自分で行うこと を参照)。

以前に MSFS 2024 でボタンを割り当てたことがありますか? その場合、スタート ページに インポートしてから空きを埋める が表示されます。今の割り当てはそのまま残り、空いているボタンにだけ新しい役割が付きます。クイック スタート:スティックを使えるようにする を参照してください。

#JoyPro が MSFS 2024 で行うこと

  • インポート:シムの Controls メニューで作ったプロファイル(Steam 版または Microsoft Store 版)を取り込みます。飛行の割り当てと General の割り当て(カメラ、視点、アクティブ ポーズなど)が、Sensitivity ページの軸設定ごと対象です。シムで一度も変更していないデバイスについては、シム自身の記録でそのプリセットを使っていると分かる場合に、シム付属のプリセットを取り込みます。
  • リレーション:1 つのリレーションは 1 つの機能です。MSFS 2024 では、DCS と同じように、リレーションをすべての機体用(既定)にも、チェックを入れた機体だけ用にもできます。
  • エクスポート:JoyPro は、シムがデバイスとカテゴリごとに使うプロファイルに割り当てを書き込みます。シムがまだ設定していない機体にはプリセット パッケージを書き出し、プロファイルを更新できなかった場合はインポート ファイルを書き出します。

#MSFS 2024 の割り当てをインポート

  1. スタート を開き、Microsoft Flight Simulator 2024 のカードの インポート を押します。
  2. MSFS で重要なオプションが 2 つあります。どちらも、チェックを入れない限りオフです:
    • 接続されていないデバイスもインポート:MSFS はこれまでに認識したすべてのデバイスの割り当てを保存しています。オフの場合は、今接続しているデバイスだけが対象です。
    • シミュレーターが使っていない可能性のある既定のプリセットもインポート:付属のプリセットを使っているかどうかがシムの記録から分からないデバイスが対象です。シムにない割り当てが追加されることがあります。
  3. 今すぐインポート を押します(プロファイルを変えずにシムの内容を見たい場合は 先に確認)。

インポートしたリレーションは、すべての機体に適用されます。一部の機体のプロファイルにしかない割り当てがある場合、インポート後に リレーション ページにお知らせが表示され、リレーションごとの これらの機体に限定、すべて限定、すべての機体で維持 を選べます。

ゲーム一覧が表示されたスタート ページゲーム一覧が表示されたスタート ページ
ゲーム一覧が表示されたスタート ページ (画像は英語版のアプリを表示しています。)

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

リレーション ページでは、MSFS 2024 のアクションにシムの機体がチェックマーク付きで表示されます。すべての機体にチェックが入っていれば、全機体用という意味です。一部のアドオン機にしかないアクションには「only for:」とその機体が表示され、追加するとその機体だけにチェックが入ります。リレーションの流れ を参照し、エクスポート ページで 確認 を実行します。1 つのボタンが 2 つの機能を持っている箇所を、シムより先に見つけます。

#MSFS 2024 へのエクスポート

  1. MSFS 2024 を閉じます。 シムの実行中は JoyPro が書き込みを拒否します(Microsoft Store 版では、起動ヘルパーの実行中も拒否します)。
  2. エクスポート を開きます。ゲームにエクスポート には、MSFS 2024 用のチェックボックスが 2 つあります:
    • MSFS 2024: MSFS プロファイルに書き込む(オン):エクスポートで、シムがデバイスとカテゴリごとに使うプロファイルを、先にバックアップしてから更新します。
    • MSFS 2024: すべてのデバイスのインポート ファイル(オフ):JoyPro がプロファイルに書き込めなかった場合だけでなく、すべてのデバイスとカテゴリについてインポート ファイルを作成します。
  3. JoyPro でデバイスを設定しているなら、自分のデバイスで置き換え と ほかのデバイスもクリア のまま、MSFS 2024 のカードの 今すぐエクスポート を押します。

エクスポート後、MSFS 2024 プロファイル の欄に、JoyPro が書き込んだすべてのプロファイルが機体と割り当ての数とともに表示されます。インポート ファイルが書き出された場合は、2 つ目の欄にそのファイル名が フォルダーを開く とともに表示されます。

エクスポート ページエクスポート ページ
エクスポート ページ
ゲーム内: MSFS 2024 での表示

シムを起動して Settings > Controls を開き、デバイスとカテゴリ(Airplanes または General)を選びます。割り当ては自分のプロファイルに、シムのアクション名で表示されます。デバイスのページ(デバイスの歯車にある Hardware Settings)には、JoyPro が書き込んだ軸のカーブが表示されます。シムがまだそのデバイス用に設定していない機体では、デバイスは JoyPro のプリセットで始まります。

#MSFS 2024 で自分で行うこと

  • MSFS 2024 プロファイル で更新済みと表示されているプロファイルについては、何もする必要はありません。
  • インポート ファイル:エクスポートでインポート ファイルが表示されたら、Settings > Controls を開き、デバイスとカテゴリ(Airplanes または General)を選び、プロファイルの歯車(プリセットの歯車ではありません)をクリックして Import を選び、JoyPro がそのデバイスとカテゴリ用に書き出したファイルを選択します。シムが受け付けるのは、同じデバイスとカテゴリのファイルだけです。ファイルにプロファイルと同じ名前が付いていると、上書きするかどうかをシムが尋ねます。確認すると、プロファイルに JoyPro の割り当てが入ります。ファイルを再びインポートするのは、エクスポートで新規または変更と表示されたときだけです。
  • 最初のエクスポートの前に、すべてのデバイスを一度接続します。JoyPro はプリセットのためにデバイスの製品 ID を必要とします。
  • ある機体だけほかと違う割り当てにしたい:シム内でその機体専用のプロファイルを作り(その機体を読み込んだ状態で Controls を開き、プロファイルを複製)、もう一度エクスポートします。配置できなかったリレーションは、エクスポートですべて表示されます。
  • Xbox クラウドの確認:シムや Xbox アプリがどちらのセーブを残すか尋ねたら、この PC のものを残してください。もう一方を選ぶと JoyPro の割り当てが消えます(その場合はもう一度エクスポートしてください)。

#よくある落とし穴

  • 「MSFS 2024 が実行中です」:シムを閉じます。Microsoft Store 版では、シムの起動ヘルパー(gamelaunchhelper.exe)も終了している必要があります。
  • ある機体で割り当てがない:その機体は、あなたの別のプロファイルを使っています。MSFS 2024 プロファイル の一覧を確認してください。「import file」と書かれた行は、そのファイルをシムでインポートする必要があるという意味です。
  • リレーションが書き込まれなかった:そのリレーションは一部の機体に限定されていますが、シムがその機体で使うプロファイルはほかの機体と共有されています。警告にプロファイル名と機体名が表示されます。
  • 1 台のデバイスに複数のプロファイルがある:インポートでは、シムの記録にあるプロファイル、なければ最新のものを使い、ほかのプロファイル名を表示します。別のものを選ぶには、スタート ページの その他のゲーム フォームにある ゲームのプロファイル を使います。
  • シムで割り当て中に「WRONG DEVICE」と表示される:値を送り続けるデバイス(一部のフォースフィードバック スティック)が、シムの入力検出を奪っています。これはシム自身の割り当て機能で起きることで、JoyPro とは関係ありません。
  • シムの Reset to Defaults は、すべてのデバイスと機体のプリセットをリセットします。JoyPro が代わりにこれを行うことはありません。
詳細

#JoyPro が読み書きするファイル

ファイル これは何か
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> 自分のプロファイル(Steam)。拡張子なしのプレーンな XML で、その場で書き換えます。Steam Cloud が次の同期でアップロードします
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ Microsoft Store 版のセーブ(containers.index、container.<n>、プロファイルごとに 1 つの blob)。JoyPro は新しい blob、新しいコンテナーファイル、索引を書き込みます
remote\profile_00(Store 版:コンテナー profile_00) シムのデバイスの記録:各デバイスが機体ごとにどのプロファイルやプリセットを使うか。読み取り専用、書き込みません
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml デバイス用の JoyPro のプリセット(飛行アクション)。layout.json と manifest.json 付き
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml デバイスの General の割り当て用の JoyPro のプリセット
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml インポート用ファイル。シム独自のプロファイル形式
<install>\Packages\fs-input-profiles、asobo-input-profiles-pc、fs-base\en-US.locPak Asobo が同梱するプリセットとメニュー名:読み取り専用。コマンド一覧と既定のプリセットに使います
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS、...\Backups\MSFS JoyPro の所有データとバックアップ。同期されるフォルダーには置きません

<packages> は %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt(Store 版:%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt)の InstalledPackagesPath です。書き込みのたびに、その前に Store 版のセーブフォルダー全体または Steam のファイルをバックアップに入れるため、前回のエクスポートを元に戻す でセーブを戻せます。

#MSFS 2024 のエクスポートモード

モードはプロファイルごと(つまり機体グループごと)に、管理対象のコンテキストでだけ動作します。

モード MSFS 2024 のプロファイルで起きること
追加のみ 割り当ては、そのプロファイルで別のアクションがその入力の組み合わせを使っていない場合にだけ書き込まれます。そうでなければ、書き込まれなかったものとして一覧に表示されます。何も削除されません。
更新(ゲームの割り当てを優先) あなたの入力の組み合わせにある別のアクションはそれを失います。それ以外はすべて残り、アクションの古い組み合わせも残ります(アクションには Primary と Secondary の 2 つがあります)。
更新(プロファイルを優先) 上と同じで、さらに割り当てるすべてのアクションが他の組み合わせを失います。接続されている他のデバイスのプロファイルでも同様です(それらのプロファイルにも書き込みます)。
自分のデバイスで置き換え JoyPro が書き込む接続済みデバイスのプロファイルには、あなたの割り当てだけが残ります。
+ ほかのデバイスもクリア 自分の MSFS 2024 プロファイルを空にすることはありません。

すべての機体向けのリレーションは、シムの記録にあるすべてのプロファイルに入ります。機体を限定したリレーションは、対象の機体がすべてチェックされているプロファイルにだけ入ります。限定したリレーションは、プリセットパッケージやインポート用ファイルには決して入りません。それらはすべての機体に適用されるためです。

#一切変更しないもの

  • メニュー、ワールドマップ、開発者用のコンテキスト(MENU、MENU_*、WORLDMAP_*、DEBUG、DEVMODE*、EDITOR_*、MISSION_FLOW_TOOLS)。どのモードでも変更しません。
  • キーボード、マウス、ゲームパッドのプロファイル(GUID="{0}"):MSFS ではキーボードの割り当てを書き込みません。
  • profile_00、Asobo が同梱するプリセット、機体専用のプリセット枠、Store 版のセーブの他のすべてのコンテナー(ログブック、他のタイトル)。
  • 接続されていないデバイス、インポートで無視したデバイス、JoyPro が転送先にしている vJoy デバイス。

#機体、カーブ、その他

  • 単位:デバイスとカテゴリー(Airplanes、General)ごと、プロファイルごと。シムがデバイスと機体ごとにプロファイルを選び、JoyPro はその選択に従います。
  • 軸カーブ:デバイスの Sensitivity ページ。物理軸ごとに 1 セット:Sensitivity + と -、Neutral、Dead zone、Extremity dead zone、Reactivity、カーブなしのフラグ、反転。リレーションで 1 つのアクションに専用の値を与えることもできます(MSFS 2024 のアクションごとの上書き)。同じデバイスの軸にあるリレーションはそのページを共有します:エクスポートは最初のリレーションの値を書き込み、警告を出します。axis-curves を参照してください。
  • フォースフィードバック:MSFS には独自のものがありません。
  • テレメトリ記録:SimConnect 経由で読み取り専用。自分で用意した SimConnect.dll を使います(JoyPro には同梱していません)。MSFS 2024 の Steam 版には含まれていないため、MSFS 2024 SDK をインストールするか、MSFS 2020 をインストールしておいてください(そのコピーも使えます)。
  • HUD:HUD はプロセスからシムを見つけ、その割り当てを表示します。
  • 監視:JoyPro は自身のパッケージ、Steam のプロファイル、Store 版のセーブの containers.index を監視します。シムの終了後(Store 版のセーブは最後の書き込みから 10 秒待ちます)、ゲーム内での変更を取り込むかどうかを尋ねます(監視)。
  • 再インポート:リレーション名、グループ、チューニングは、ファイルの隣にある JoyPro のメタデータから戻ります(再インポート)。
  • 上級者向けのオプション(スタート ページの その他のゲーム):ゲームのプロファイル(デバイスに複数のプロファイルがあるときに 1 つを選ぶ)、エクスポートする機体(1 つの機体に限定したリレーションも、すべての機体向けにエクスポート)、MSFS プロファイルに書き込む、すべてのデバイスの MSFS インポート ファイルも書き出す、ドライラン。
技術的な内部情報

#MSFS 2024 連携の内部

flowchart LR
  P["あなたのプロファイル"] --> E["engine msfs2024 export"]
  E --> U["自分の<br/>プロファイル"]
  E --> K["JoyPro の<br/>プリセット"]
  E --> F["インポート用ファイル"]
  F --> I["あなた:歯車、<br/>Import"]
  U --> S["Settings ><br/>Controls"]
  K --> S
  I --> S
自分のプロファイル(Steam の inputprofile_n または Store 版のセーブ)には直接書き込みます。JoyPro のプリセット(Community2024 / joypro-input-profiles、デバイスごとに 1 つのプリセット)は、シムでまだ設定していない機体のためのものです。インポート用ファイル(Documents / JoyPro2)は、シムで自分で読み込みます。

コード:engine\Games\MsfsIntegration.cs(両方のシムで 1 つのクラス)、MsfsIntegration.UserProfiles.cs(直接の書き込み)、MsfsIntegration.ImportFiles.cs、MsfsCommunityPackage.cs、MsfsUserProfiles.cs(Steam と Store の読み取り)、WgsContainers.cs(Store 版のセーブ)、MsfsSimProfile.cs(profile_00 内の記録)、MsfsSimDefaults.cs、MsfsProfileFile.cs(行単位のエディター)、MsfsGameData.cs、MsfsAircraft.cs、engine\AxisModels\Msfs.cs。

  • 形式:XML フラグメント(複数のトップレベル要素):<Version>、<FriendlyName>、<Axes> と <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY> を含む <Device DeviceName GUID ProductID CompositeID HWVer>。2024 のプロファイルにはコンテキストのすべてのアクションが並び、未割り当てのものは空の <Action/> になります。コード:ボタン N = N-1、ハット 256-259、L 軸 X/Y/Z 1026/1042/1058、R 軸 770/786/802、スライダー 514/530。フラグ:2 デジタル、4 軸、128 反転、1024 感度カーブなし、4096 アクションごとの軸の上書き。再出力されるのは変更した <Action> 要素だけです。
  • デバイス:プロファイルはデバイスを DirectInput のインスタンス GUID(GUID)で示すため、読み込むのに接続済みのデバイスは必要ありません。シミュレーターはプリセットを USB の製品 ID(16 進)で照合します。JoyPro はシミュレーターが profile_00 に記録した ID を使い、なければ USB PID を使います(vJoy は製品 ID 0 として表示されます)。
  • どのプロファイルが有効か:profile_00 のレコードは、デバイスと機体ごとに General スロットとカテゴリー スロットを持ちます。そこにある自分のプロファイルは inputprofile_<n> で、これが Steam 版のファイル名であり、Store 版のコンテナー名でもあります。
  • Store 版のセーブ:インデックスが既知の構成(バージョン 14、競合フラグなし、コンテナーが既知の状態で 1 回だけ記載)の場合にのみ書き込みます。その場合、新しい blob container.<n+1> を書き、最後にインデックスを書き(一時ファイルを作って置き換え)、読み戻して確認し、古い世代を削除します。どこかで失敗するとすべて元に戻します。不明な点があれば何も書かず、割り当てはインポート ファイルが運びます。
  • コマンド一覧:engine msfs2024 refresh-db は、Asobo のプリセット、en-US.locPak が名前を付けているすべてのフライト イベント、自分の General プロファイル、展開済みのアドオン パッケージ(Community、Marketplace)とその機体を読み込みます。機体の一覧はシミュレーターのコンテンツ一覧から取得します。新しくインストールした場合は、最初のインポート時に一覧が作られます。
  • コマンド:engine msfs2024 paths、engine msfs2024 catalog、engine msfs2024 scan、engine msfs2024 import(--game-profile、--include-disconnected、--include-sim-defaults、--limit-to-profile-aircraft、--replace)、engine msfs2024 export(--mode、--nuke-untouched-devices、--dry-run、--aircraft <key>。エクスポート ページの 2 つのチェックに当たるのが --user-profiles false と --import-files)。機体ごとのリレーションは engine relations aircraft set、元に戻すのは engine backups restore、監視機能は engine sync status と engine sync diff で行います。古い CLI 名 engine msfs ... も引き続き MSFS 2024 を指します。

#既知の制限

  • 機体専用のプリセット スロットには書き込みません(機体自身のパッケージにのみ含まれるため)。JoyPro が profile_00 に書き込むことはありません(ファイルの末尾にチェックサムがあるため)。
  • JoyPro のプリセットが届くのは、シミュレーターがまだそのデバイス用に設定していない機体だけです。それ以外では、自分のプロファイルかインポート ファイルが割り当てを運びます。
  • 1 つのアクションにつき入力の組み合わせは最大 2 つです。3 つ目は報告されます。半分の軸、ハットの斜め方向、2 つ目のハットは読み書きしません。モディファイアは同じデバイスのボタンのみです。
  • 圧縮されたアドオン パッケージ(.fsarchive)は読み飛ばします。260 文字を超える Store 版のセーブ パスは読み込みません。
  • 別の PC があとから保存した場合、クラウドのコピー(Steam Cloud、Xbox クラウド)が JoyPro の書き込みより優先されることがあります。
  • テスト:engine\tests\smoke\msfs.ps1、smoke\msfsuserprofiles.ps1、gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs(Steam 版と Store 版のセーブ、機体ごとのプロファイル、ロールバック)、MsfsStoreWatcherEndToEndTests。シミュレーター内では tools\e2e\games\Msfs2024Settings.ps1(Controls のプリセット、軸、ボタン、アクションごとのカーブ)。

このゲームに関するすべての技術メモ(リポジトリから生成): msfs.md.