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 個步驟就能用
- 全部幫我設定好
在「開始」頁面 - 使用這些按鈕
先查看清單 - 寫入我的遊戲
保持模擬器關閉
事前準備:每個裝置都連接一次。
接著:閱讀 您的 MSFS 2024 設定檔 框。裡面有提到匯入檔案嗎?那麼請在模擬器中匯入該檔案(請參閱下方的 您需要自己做的事)。
您之前在 MSFS 2024 中綁定過按鈕嗎?那麼「開始」頁面會提供 匯入,然後填補空缺。您的綁定會保留,只有空閒的按鈕會被指派新功能。請參閱 快速入門:讓我的搖桿能用。
#JoyPro 為 MSFS 2024 做了什麼
- 匯入:您在模擬器 Controls 選單中建立的設定檔(Steam 或 Microsoft Store)會進入您的設定檔,包括飛行綁定和 General 綁定(攝影機、視角、主動暫停等),以及 Sensitivity 頁面的軸設定。如果您從未在模擬器中變更某個裝置,而模擬器自己的紀錄顯示它使用內建預設集,就會匯入該預設集。
- 關聯:一個關聯就是一個功能。在 MSFS 2024 中,關聯可以適用於所有飛機(預設),也可以像在 DCS 中一樣,只適用於您勾選的飛機。
- 匯出:JoyPro 會把您的綁定寫入模擬器為每個裝置和類別所使用的設定檔,為模擬器尚未設定的飛機寫入它的預設集套件,並在無法更新您設定檔的地方寫入匯入檔案。
#匯入您的 MSFS 2024 綁定
- 開啟 開始 頁面,然後在 Microsoft Flight Simulator 2024 卡片上按 匯入。
- 對 MSFS 來說,有兩個選項很重要,除非您勾選,否則都是關閉的:
- 同時匯入未連接的裝置:MSFS 會保存它看過的每個裝置的綁定。關閉:只匯入目前已連接的裝置。
- 同時匯入模擬器可能未使用的預設預設集:適用於模擬器紀錄中看不出是否使用內建預設集的裝置。這可能會加入模擬器中沒有的綁定。
- 按 立即匯入(或按 先預覽 查看模擬器中有什麼,而不變更您的設定檔)。
匯入的關聯適用於所有飛機。如果某個綁定只存在於部分飛機的設定檔中,關聯 頁面會在匯入後顯示提示,並提供每個關聯的 限定為這些飛機、全部限定 和 保留給所有飛機。


#建立並檢查關聯
在 關聯 頁面上,MSFS 2024 動作會以勾選標記顯示模擬器的飛機:全部飛機都勾選表示適用於所有飛機。只存在於某些附加飛機中的動作會顯示「僅適用於:」及這些飛機,加入它時也只會勾選這些飛機。請參閱 關聯流程,然後在「匯出」頁面執行 檢查:它會在模擬器之前找出有兩個功能的按鈕。
#匯出到 MSFS 2024
- 關閉 MSFS 2024。 模擬器執行期間 JoyPro 會拒絕寫入(Microsoft Store 版在其啟動輔助程式執行期間也一樣)。
- 開啟 匯出。在 匯出到遊戲 下,有兩個勾選項目是 MSFS 2024 專用的:
- MSFS 2024:寫入我的 MSFS 設定檔(預設開啟):匯出會更新模擬器為每個裝置和類別所使用的設定檔,並先備份。
- MSFS 2024:為每個裝置產生匯入檔案(預設關閉):為每個裝置和類別產生匯入檔案,而不只是在 JoyPro 無法寫入您設定檔的地方。
- 如果您是用 JoyPro 設定裝置,請保留 取代我的裝置上的綁定 和 同時清除我的其他裝置,然後在 MSFS 2024 卡片上按 立即匯出。
匯出後,您的 MSFS 2024 設定檔 框會列出 JoyPro 寫入的每個設定檔,以及其飛機和綁定數量。如果寫入了匯入檔案,第二個框會列出它們,並提供 開啟資料夾。


啟動模擬器並開啟 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
程式碼: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.