JoyPro2 Discord GitHub
遊戲

Microsoft Flight Simulator 2020

顯示:

MSFS 2020 為每個裝置保存一個操控設定檔,適用於所有飛機。在 Steam 版中,每個設定檔都是模擬器在 Steam remote 資料夾中的一個小型 XML 檔案;JoyPro 會把這些檔案讀入您的設定檔,並把您的綁定直接寫回這些檔案。Microsoft Store 版的設定檔只會匯入,不會寫入。和 MSFS 2024 不同,這裡沒有預設集套件、沒有匯入檔案,也沒有依飛機區分的設定檔。

Microsoft Flight Simulator 2020 原生(使用自己的綁定檔案)
支援
原生(使用自己的綁定檔案)
引擎指令
engine msfs2020
綁定檔案
Steam userdata\<id>\1250410\remote\inputprofile_*(每個裝置一個 XML 片段)
遊戲讀取的輸入
每支 joystick 讀取 8 個軸、1 個帽子開關(4 個方向)(有文件說明)
指令清單來源
同 MSFS 2024
遊戲內測試
通過 41/41 個步驟(2026-10-10)
  • ✓ 匯入
  • ✓ 匯出
  • ✗ 鍵盤綁定
  • ◐ 修飾鍵MSFS:修飾鍵按鈕只能來自同一個裝置。
  • ✓ 在您的電腦上建立指令清單
  • ✓ 遊戲監看
  • ✓ 軸曲線與死區
  • ✗ 遊戲操作設定
  • ✗ 遊戲內力回饋設定
  • ✗ 由遙測資料產生力回饋
  • ✓ 遙測錄製
  • ✓ 虛擬 joystick(vJoy)
  • ◐ 虛擬 Xbox 手把
  • ✓ 虛擬功能
  • ✓ 設定精靈 / 自動指派
  • ✓ 座艙
  • ✓ 速查表
  • ✓ 遊戲內測試

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

給新手

#3 個步驟就能用

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

事前準備:在模擬器中為每個裝置建立一次設定檔(Settings > Controls)。JoyPro 只會寫入 Steam 版;Microsoft Store 版只能匯入。

接著:啟動模擬器。您的綁定會出現在每架飛機的 Settings > Controls 中。

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

#JoyPro 為 MSFS 2020 做了什麼

  • 匯入:每個已連接裝置的設定檔(Steam 或 Microsoft Store)都會進入您的設定檔:飛行綁定、General 綁定(攝影機、視角、暫停)以及 Sensitivity 頁面的軸設定。
  • 關聯:一個關聯就是一個功能。一個關聯適用於所有飛機,因為 MSFS 2020 每個裝置只有一個設定檔。
  • 匯出:JoyPro 會編輯 Steam 版 remote 資料夾中的裝置設定檔。模擬器會在下次啟動時讀取它們。

#匯入您的 MSFS 2020 綁定

  1. 開啟 開始 頁面,然後在 Microsoft Flight Simulator 2020 卡片上按 匯入。
  2. 同時匯入未連接的裝置(預設關閉):MSFS 會保存它看過的每個裝置的設定檔;關閉表示只匯入目前已連接的裝置。同時匯入模擬器可能未使用的預設預設集(預設關閉)會為沒有自己設定檔的裝置加入模擬器內建的預設集,即使不確定模擬器是否會使用它。
  3. 按 立即匯入,或按 先預覽 查看模擬器中有什麼,而不變更您的設定檔。

#建立並檢查關聯

和其他遊戲一樣,在 關聯 頁面建立關聯(請參閱 關聯流程),然後在「匯出」頁面執行 檢查。在這裡,檢查功能不會把固定翼飛機的油門和直升機的總距桿放在同一個軸上回報為錯誤:MSFS 2020 沒有分開的飛機清單。

#匯出到 MSFS 2020

  1. 關閉 MSFS 2020。 模擬器執行期間 JoyPro 會拒絕寫入。
  2. 開啟 匯出,如果您是用 JoyPro 設定裝置,請保留 取代我的裝置上的綁定 和 同時清除我的其他裝置,然後在 MSFS 2020 卡片上按 立即匯出。
  3. 啟動模擬器。remote 資料夾是 Steam Cloud 資料夾,所以 Steam 會同步已變更的檔案。
「匯出」頁面「匯出」頁面
「匯出」頁面 (圖片顯示的是英文版應用程式。)
在遊戲中: 您在 MSFS 2020 中會看到什麼

開啟 Settings > Controls 並選擇您的裝置:您的綁定會以模擬器的動作名稱出現在裝置的設定檔中,而裝置的 Sensitivity 頁面會顯示 JoyPro 寫入的軸曲線。每架飛機都使用同一個設定檔。

#您在 MSFS 2020 中需要自己做的事

  • 在模擬器中為每個裝置建立一次設定檔(Settings > Controls)。JoyPro 只會編輯已存在的設定檔;對沒有設定檔的裝置,匯出時會顯示「請先在模擬器中建立一個」。
  • Microsoft Store 版:JoyPro 會匯入您的設定檔,但無法寫入。請使用 Steam 版進行匯出,或在模擬器中設定綁定。
  • 限定於特定飛機的關聯:MSFS 2020 無法把它們分開。在「開始」頁面的 其他遊戲 表單中,匯出飛機 也會把限定於單一飛機的關聯匯出到所有飛機。

#常見問題

  • 「MSFS 2020 正在執行」:關閉模擬器,然後重新匯出。
  • 模擬器顯示的是舊的綁定:Steam Cloud 放回了較舊的副本。請關閉模擬器,然後重新匯出。
  • 一個裝置有多個設定檔:JoyPro 會使用在 其他遊戲 表單中以 遊戲設定檔 選定的那一個,或唯一的那一個;否則會略過該裝置,並顯示列出這些名稱的警告。
  • 缺少一個綁定:一個動作最多保留兩組輸入組合(Primary 和 Secondary);第三組會被回報並略過。
進階

#JoyPro 讀取和寫入的檔案

檔案 這是什麼
<Steam>\userdata\<id>\1250410\remote\inputprofile_<n> 一個裝置設定檔,沒有副檔名的 XML;就地寫入(先備份為 .jpbak)
<Steam>\userdata\<id>\1250410\remote\profile_00 模擬器的裝置設定檔二進位索引:唯讀,永遠不會寫入
%LOCALAPPDATA%\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ Microsoft Store 存檔:唯讀(匯入和掃描)
<install>\Input\*.xml、fs-base\en-US.locPak 模擬器隨附的預設集及其選單名稱:唯讀
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS、...\Backups\MSFS JoyPro 的擁有權資料和備份,永遠不會放在 Steam 資料夾中

Steam 的 remote 資料夾是 Steam Cloud 資料夾。只會編輯現有的 inputprofile_* 檔案:模擬器的 profile_00 會指名特定檔案,所以新檔案不會被採用。

#MSFS 2020 的匯出模式

模式 裝置設定檔中會發生什麼
僅新增 只有在設定檔中該輸入組合上沒有其他動作時,才會寫入綁定;否則會列在「綁定未寫入,按鈕在遊戲中已被佔用」下。不會移除任何東西。
更新,保留遊戲的綁定 您的組合上的其他動作會失去該組合;其他一切保留,包括動作原本的組合。
更新,以我的設定檔為準 同上,而且您綁定的每個動作在已連接裝置的設定檔中會失去其他組合。
取代我的裝置上的綁定 JoyPro 綁定的已連接裝置,其設定檔只保留您的綁定。
+ 同時清除我的其他裝置 在您設定檔中沒有綁定的已連接裝置,其設定檔會被清除。

#永遠不會變更的內容

  • 選單、世界地圖和開發者情境(MENU、MENU_*、WORLDMAP_*、DEBUG、DEVMODE*、EDITOR_*、MISSION_FLOW_TOOLS),在任何模式下皆然。
  • 鍵盤、滑鼠和遊戲手把設定檔(GUID="{0}"):MSFS 中不會寫入鍵盤綁定。
  • 未連接裝置的設定檔、profile_00、Store 存檔、匯入時忽略的裝置,以及 JoyPro 轉送輸入的 vJoy 裝置。

#曲線與其他

  • 細緻度:每個裝置一個設定檔,適用於所有飛機。
  • 軸曲線:裝置的 Sensitivity 頁面,每個實體軸一組:Sensitivity + 和 -、Neutral、Dead zone、Extremity dead zone、Reactivity、無曲線旗標和反向。MSFS 2020 沒有個別動作的覆寫:要求覆寫的關聯會改用裝置頁面,並發出警告。曲線預覽與模擬器一致(在 MSFS 2020 中實測)。調校範圍 family:msfs 涵蓋兩個模擬器;請參閱 axis-curves。
  • 力回饋:MSFS 本身沒有力回饋。
  • 遙測錄製:透過 SimConnect,唯讀,使用模擬器安裝資料夾中的 SimConnect.dll(或 MSFS SDK 的;JoyPro 不附帶)。
  • HUD:HUD 會依據處理程序(FlightSimulator)找到模擬器,並顯示其綁定。
  • 監看程式:JoyPro 會監看 inputprofile_* 檔案和 Store 存檔的 containers.index,並在模擬器關閉後詢問(監看程式)。

#與 MSFS 2024 的差異

MSFS 2020 MSFS 2024
匯出目標 就地寫入 Steam 設定檔 您自己的設定檔(Steam 和 Store)、JoyPro 的預設集套件、匯入檔案
Microsoft Store 版本 僅匯入 匯入並寫入
設定檔 每個裝置一個 依裝置和類別,依飛機選擇
限定飛機的關聯 僅限 匯出飛機(之後適用於所有飛機) 寫入那些飛機的設定檔
設定檔中的動作清單 只有已綁定的動作 其情境中的每個動作
個別動作的軸覆寫 否 是
技術細節

#MSFS 2020 整合的內部運作

flowchart LR
  P["您的設定檔<br/>(關聯 + 綁定)"] --> E["engine msfs2020 export"]
  E --> R["Steam remote /<br/>inputprofile_n<br/>(每個裝置一個)"]
  R --> C["Steam Cloud<br/>(下次同步)"]
  R --> G["MSFS 2020:<br/>Settings > Controls"]
Steam 版本。Microsoft Store 版本:僅匯入。

程式碼:engine\Games\MsfsIntegration.cs(兩個模擬器共用一個類別,sim == 2020)、MsfsProfileFile.cs(以行為單位的編輯器)、MsfsUserProfiles.cs(讀取 Steam 和 Store)、MsfsSimDefaults.cs、MsfsGameData.cs、MsfsAircraft.cs、engine\AxisModels\Msfs.cs。

  • 格式:一個 XML 片段(以片段相容模式讀取):<Version>、<FriendlyName>、<Device DeviceName GUID ProductID>、<Axes> 含 <Axis AxisName AxisSensitivy AxisDeadZone ...>(拼錯的屬性名稱是模擬器自己的)、<Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>。被釋放的動作會被移除;新的動作會放到它在資料夾中其他設定檔所屬的情境,否則放到其目錄情境,再否則放到 PLANE(並發出警告)。
  • 裝置:GUID 是 DirectInput 執行個體 GUID,所以讀取時不需要連接裝置;ProductID 是十進位的 USB 產品 ID。代碼:按鈕 N = N-1,帽子開關 256-259,軸 1026/1042/1058、770/786/802,滑桿 514/530;組合中的最後一個 KEY 是主要輸入,同一裝置的其他按鈕是修飾鍵。
  • 指令清單:engine msfs2020 refresh-db 會讀取模擬器的預設集(<install>\Input、其官方套件)以及 en-US.locPak 中提到的每個飛行事件;它與 MSFS 2024 的清單共用相同的起點。
  • 指令:engine msfs2020 paths、engine msfs2020 catalog、engine msfs2020 scan、engine msfs2020 import(--game-profile、--include-disconnected、--include-sim-defaults)、engine msfs2020 export(--mode、--nuke-untouched-devices、--dry-run、--aircraft <key>);以 engine backups restore 復原。
  • 舊的設定檔:在 JoyPro 只有一個 MSFS 遊戲時儲存的設定檔(MSFS:<action>),載入時會為每個模擬器各取得一個節點。

#已知限制

  • Microsoft Store 版本為唯讀;以其存檔資料夾作為路徑的匯出會被拒絕。
  • 不會建立新的 inputprofile_* 檔案;裝置需要有在模擬器中建立的設定檔。
  • Steam Cloud 可能會把較舊的設定檔放回來。
  • 半軸、帽子開關斜向和第二個帽子開關不會讀取或寫入;每個動作最多兩個組合。
  • MSFS 2020 隨附的預設集未在實際安裝上檢查過,所以 2020 的預設集也必須帶有裝置名稱,才會被當作預設值。
  • 測試:engine\tests\smoke\msfs.ps1(Sensitivity 頁面、覆寫、旗標、衝突、合併);模擬器內為 tools\e2e\games\MsfsCurves.ps1(綁定、Sensitivity 頁面、飛行中的按鈕和軸曲線,透過 SimConnect 讀回)。

此遊戲的所有技術說明(由儲存庫產生): msfs.md.