JoyPro2 Discord GitHub
遊戲

Microsoft Flight Simulator 2024

顯示:

MSFS 2024 把您的操控設定保存在設定檔中,每個裝置和類別(Airplanes 和 General)各一個,並記住每個裝置和飛機使用哪個設定檔。JoyPro 會把這些設定檔讀入它自己的一個設定檔,並在 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);無法寫入您的設定檔時,匯入檔放在 Documents\JoyPro2\MSFS 2024 import files
遊戲讀取的輸入
每支 joystick 讀取 8 個軸、1 個帽子開關(4 個方向)(有文件說明)
指令清單來源
Asobo 的預設組檔案、fs-base\en-US.locPak 中列出的飛行事件、已安裝的飛機
遊戲內測試
通過 26/26 個步驟(2026-10-11)
  • ✓ 匯入
  • ✓ 匯出
  • ✗ 鍵盤綁定
  • ◐ 修飾鍵MSFS:修飾鍵按鈕只能來自同一個裝置。
  • ✓ 在您的電腦上建立指令清單
  • ✓ 遊戲監看
  • ✓ 軸曲線與死區
  • ✗ 遊戲操作設定
  • ✗ 遊戲內力回饋設定
  • ✗ 由遙測資料產生力回饋
  • ✓ 遙測錄製
  • ✓ 虛擬 joystick(vJoy)
  • ◐ 虛擬 Xbox 手把
  • ✓ 虛擬功能
  • ✓ 設定精靈 / 自動指派
  • ✓ 座艙
  • ✓ 速查表
  • ✓ 遊戲內測試

摘自支援矩陣(由引擎程式碼產生): 所有遊戲.

給新手

#3 個步驟就能用

  1. 全部幫我設定好
    在「開始」頁面
  2. 使用這些按鈕
    先查看清單
  3. 寫入我的遊戲
    保持模擬器關閉

事前準備:每個裝置都連接一次。

接著:閱讀 您的 MSFS 2024 設定檔 框。裡面有提到匯入檔案嗎?那麼請在模擬器中匯入該檔案(請參閱下方的 您需要自己做的事)。

您之前在 MSFS 2024 中綁定過按鈕嗎?那麼「開始」頁面會提供 匯入,然後填補空缺。您的綁定會保留,只有空閒的按鈕會被指派新功能。請參閱 快速入門:讓我的搖桿能用。

#JoyPro 為 MSFS 2024 做了什麼

  • 匯入:您在模擬器 Controls 選單中建立的設定檔(Steam 或 Microsoft Store)會進入您的設定檔,包括飛行綁定和 General 綁定(攝影機、視角、主動暫停等),以及 Sensitivity 頁面的軸設定。如果您從未在模擬器中變更某個裝置,而模擬器自己的紀錄顯示它使用內建預設集,就會匯入該預設集。
  • 關聯:一個關聯就是一個功能。在 MSFS 2024 中,關聯可以適用於所有飛機(預設),也可以像在 DCS 中一樣,只適用於您勾選的飛機。
  • 匯出:JoyPro 會把您的綁定寫入模擬器為每個裝置和類別所使用的設定檔,為模擬器尚未設定的飛機寫入它的預設集套件,並在無法更新您設定檔的地方寫入匯入檔案。

#匯入您的 MSFS 2024 綁定

  1. 開啟 開始 頁面,然後在 Microsoft Flight Simulator 2024 卡片上按 匯入。
  2. 對 MSFS 來說,有兩個選項很重要,除非您勾選,否則都是關閉的:
    • 同時匯入未連接的裝置:MSFS 會保存它看過的每個裝置的綁定。關閉:只匯入目前已連接的裝置。
    • 同時匯入模擬器可能未使用的預設預設集:適用於模擬器紀錄中看不出是否使用內建預設集的裝置。這可能會加入模擬器中沒有的綁定。
  3. 按 立即匯入(或按 先預覽 查看模擬器中有什麼,而不變更您的設定檔)。

匯入的關聯適用於所有飛機。如果某個綁定只存在於部分飛機的設定檔中,關聯 頁面會在匯入後顯示提示,並提供每個關聯的 限定為這些飛機、全部限定 和 保留給所有飛機。

顯示您遊戲的「開始」頁面顯示您遊戲的「開始」頁面
顯示您遊戲的「開始」頁面 (圖片顯示的是英文版應用程式。)

#建立並檢查關聯

在 關聯 頁面上,MSFS 2024 動作會以勾選標記顯示模擬器的飛機:全部飛機都勾選表示適用於所有飛機。只存在於某些附加飛機中的動作會顯示「僅適用於:」及這些飛機,加入它時也只會勾選這些飛機。請參閱 關聯流程,然後在「匯出」頁面執行 檢查:它會在模擬器之前找出有兩個功能的按鈕。

#匯出到 MSFS 2024

  1. 關閉 MSFS 2024。 模擬器執行期間 JoyPro 會拒絕寫入(Microsoft Store 版在其啟動輔助程式執行期間也一樣)。
  2. 開啟 匯出。在 匯出到遊戲 下,有兩個勾選項目是 MSFS 2024 專用的:
    • MSFS 2024:寫入我的 MSFS 設定檔(預設開啟):匯出會更新模擬器為每個裝置和類別所使用的設定檔,並先備份。
    • MSFS 2024:為每個裝置產生匯入檔案(預設關閉):為每個裝置和類別產生匯入檔案,而不只是在 JoyPro 無法寫入您設定檔的地方。
  3. 如果您是用 JoyPro 設定裝置,請保留 取代我的裝置上的綁定 和 同時清除我的其他裝置,然後在 MSFS 2024 卡片上按 立即匯出。

匯出後,您的 MSFS 2024 設定檔 框會列出 JoyPro 寫入的每個設定檔,以及其飛機和綁定數量。如果寫入了匯入檔案,第二個框會列出它們,並提供 開啟資料夾。

「匯出」頁面「匯出」頁面
「匯出」頁面
在遊戲中: 您在 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 app 詢問要保留哪一份存檔,請保留這台電腦上的那一份;另一份會丟失 JoyPro 的綁定(這時請重新匯出)。

#常見問題

  • 「MSFS 2024 正在執行」:關閉模擬器;在 Microsoft Store 版中,模擬器的啟動輔助程式(gamelaunchhelper.exe)也必須結束。
  • 某架飛機缺少綁定:該飛機使用的是您的另一個設定檔。請查看 您的 MSFS 2024 設定檔 清單;標示「匯入檔案」的那一行,表示您需要在模擬器中匯入該檔案。
  • 某個關聯沒有被寫入:它限定於某些飛機,但模擬器在那裡使用的設定檔也和其他飛機共用。警告會列出該設定檔和飛機。
  • 一個裝置有多個設定檔:匯入時會採用模擬器紀錄中指定的那一個,否則採用最新的那一個,並列出其他設定檔。請在「開始」頁面的 其他遊戲 表單中以 遊戲設定檔 選擇另一個。
  • 在模擬器中綁定時出現「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>,每個設定檔一個 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 JoyPro 的裝置 General 綁定預設集
%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 中的 InstalledPackagesPath(Store:%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt)。每次寫入前,整個 Store 存檔資料夾或 Steam 檔案都會放入備份組,所以 復原上次匯出 可以把存檔放回去。

#MSFS 2024 的匯出模式

這些模式依設定檔運作(也就是依飛機群組),而且只作用於受管理的情境。

模式 您的 MSFS 2024 設定檔中會發生什麼
僅新增 只有在該設定檔中沒有其他動作使用該輸入組合時,才會寫入綁定;否則會列為未寫入。不會移除任何東西。
更新,保留遊戲的綁定 您的輸入組合上的其他動作會失去該組合;其他一切保留,包括動作原本的組合(每個動作有兩個:Primary 和 Secondary)。
更新,以我的設定檔為準 同上,而且您綁定的每個動作會失去其他組合,在其他已連接裝置的設定檔中也是(那些設定檔也會被寫入)。
取代我的裝置上的綁定 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 頁面,每個實體軸一組:Sensitivity + 和 -、Neutral、Dead zone、Extremity dead zone、Reactivity、無曲線旗標和反向。關聯可以為單一動作指定自己的值(MSFS 2024 的個別動作覆寫)。同一裝置軸上的關聯共用其頁面:匯出會寫入第一個關聯的值並發出警告。請參閱 axis-curves。
  • 力回饋:MSFS 本身沒有力回饋。
  • 遙測錄製:透過 SimConnect,唯讀,使用您自己的 SimConnect.dll(JoyPro 不附帶):Steam 版的 MSFS 2024 沒有附帶,所以請安裝 MSFS 2024 SDK,或安裝 MSFS 2020(它的副本也能用)。
  • HUD:HUD 會依據處理程序找到模擬器,並顯示其綁定。
  • 監看程式:JoyPro 會監看它的套件、Steam 設定檔和 Store 存檔的 containers.index;模擬器關閉後(Store 存檔會在最後一次寫入後等待 10 秒),它會詢問是否採用您在遊戲中所做的變更(監看程式)。
  • 重新匯入:關聯名稱、群組和調校會透過 JoyPro 存放在檔案旁的中繼資料帶回來(重新匯入)。
  • 進階選項(「開始」頁面上的 其他遊戲):遊戲設定檔(裝置有多個設定檔時選擇其中一個)、匯出飛機(也匯出限定單一飛機的關聯,並套用到所有飛機)、寫入我的 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,每個裝置一個預設集)用於模擬器尚未設定的飛機。匯入檔(Documents / JoyPro2)需要您自己在模擬器中載入。

程式碼:engine\Games\MsfsIntegration.cs(兩個模擬器共用一個類別)、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>、<Device DeviceName GUID ProductID CompositeID HWVer>,含 <Axes> 和 <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>。2024 的設定檔會列出其情境中的每個動作,未綁定的動作為空的 <Action/>。代碼:按鈕 N = N-1,帽子開關 256-259,左軸 X/Y/Z 1026/1042/1058,右軸 770/786/802,滑桿 514/530。旗標:2 數位、4 軸、128 反向、1024 無靈敏度曲線、4096 個別動作軸覆寫。只有變更過的 <Action> 元素會重新產生。
  • 裝置:設定檔以 DirectInput 執行個體 GUID(GUID)來指稱裝置,因此讀取時不需要連接任何裝置。模擬器以 USB 產品 ID(十六進位)來對應預設配置:JoyPro 使用模擬器記在 profile_00 裡的那個 ID,否則使用 USB PID(vJoy 的產品 ID 顯示為 0)。
  • 目前使用哪個設定檔:profile_00 中的記錄會針對每個裝置和每架飛機保存一個 General 欄位和一個類別欄位;其中自己的設定檔是 inputprofile_<n>,這也是 Steam 版的檔名和 Store 版的容器名稱。
  • Store 版存檔:只有在索引具有已知的結構時才會寫入(版本 14、沒有衝突旗標、容器只列出一次且處於已知狀態);接著寫入新的 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>;--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 的預設配置只會套用到模擬器尚未替某個裝置設定過的飛機;其他飛機則由您自己的設定檔或匯入檔案攜帶綁定。
  • 每個動作最多兩組輸入組合;第三組會被回報。半軸、帽子開關的斜向和第二個帽子開關不會讀取也不會寫入。修飾鍵:只限同一個裝置上的按鈕。
  • 已封裝的附加元件套件(.fsarchive)會被略過;超過 260 個字元的 Store 版存檔路徑不會讀取。
  • 如果另一台電腦較晚存檔,雲端副本(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.