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
游戏读取的输入
每个摇杆读取 8 个轴、1 个苦力帽(4 个方向)(有文档说明)
命令列表来源
Asobo 的预设文件、fs-base\en-US.locPak 中列出的飞行事件、已安装的飞机
游戏内测试
通过 26/26 个步骤(2026-10-11)
  • ✓ 导入
  • ✓ 导出
  • ✗ 键盘绑定
  • ◐ 修饰键MSFS:修饰键按钮只能来自同一设备。
  • ✓ 在你的电脑上生成命令列表
  • ✓ 游戏监视器
  • ✓ 轴曲线和死区
  • ✗ 游戏控制设置
  • ✗ 游戏内力反馈设置
  • ✗ 基于遥测数据的力反馈
  • ✓ 遥测录制
  • ✓ 虚拟摇杆(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 应用询问要保留哪个存档,请保留这台电脑上的那个;另一个会丢失 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 云会在下次同步时上传
%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 不附带):MSFS 2024 的 Steam 版没有这个文件,所以请安装 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,L 轴 X/Y/Z 1026/1042/1058,R 轴 770/786/802,滑块 514/530。标志:2 数字量,4 轴,128 反转,1024 无灵敏度曲线,4096 按操作的轴覆盖。只有发生变化的 <Action> 元素会被重新生成。
  • 设备:配置文件通过 DirectInput 实例 GUID(GUID)来指明设备,因此读取它时不需要连接任何设备。模拟器按 USB 产品 ID(十六进制)匹配预设:JoyPro 使用模拟器在 profile_00 中记下的那个,否则使用 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 中列出的每个飞行事件、你的通用配置文件,以及已解包的附加组件包(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.