X-Plane 把你所有设备的分配保存在其安装目录中的一个首选项文件里:每个硬件轴一个轴“用途”(俯仰、油门、襟翼 ……),每个按钮一个命令,以及可选的响应曲线。JoyPro 会把该文件读入你的配置文件,在关联中把它与你的其他游戏合并,然后写回,只修改它所管理的飞行相关行。X-Plane 12 和 X-Plane 11 在 JoyPro 中是两个游戏,各有自己的安装、命令列表和设置;两者可以同时安装。
X-Plane 12 原生(使用游戏自己的绑定文件)
- 支持
- 原生(使用游戏自己的绑定文件)
- 引擎命令
engine xplane12- 绑定文件
Output\preferences\X-Plane Joystick Settings.prf、control profiles\*.prf(按行)- 游戏读取的输入
- 每个摇杆读取 160 个按钮、25 个轴、1 个苦力帽(已验证)
- 命令列表来源
Resources\plugins\Commands.txt- 游戏内测试
- 通过 33/33 个步骤(2026-10-11)
- ✓ 导入
- ✓ 导出
- ✗ 键盘绑定
- ✗ 修饰键
- ✓ 在你的电脑上生成命令列表
- ✓ 游戏监视器
- ✓ 轴曲线和死区
- ✓ 游戏控制设置
- ◐ 游戏内力反馈设置X-Plane 12:只有针对力反馈摇杆的按设备开关“control-loaded axes”;模拟器本身没有摇杆力反馈效果(只能靠插件)。
- ✗ 基于遥测数据的力反馈
- ✓ 遥测录制
- ✓ 虚拟摇杆(vJoy)
- ◐ 虚拟 Xbox 手柄
- ✓ 虚拟功能
- ✓ 设置向导 / 自动分配
- ✓ 座舱
- ✓ 速查表
- ✓ 游戏内测试
X-Plane 11 原生(使用游戏自己的绑定文件)
- 支持
- 原生(使用游戏自己的绑定文件)
- 引擎命令
engine xplane11- 绑定文件
- 同 X-Plane 12
- 游戏读取的输入
- 每个摇杆读取 160 个按钮、25 个轴、1 个苦力帽(已验证)
- 命令列表来源
Resources\plugins\Commands.txt
- ✓ 导入
- ✓ 导出
- ✗ 键盘绑定
- ✗ 修饰键
- ✓ 在你的电脑上生成命令列表
- ✓ 游戏监视器
- ✓ 轴曲线和死区
- ✓ 游戏控制设置
- ✗ 游戏内力反馈设置
- ✗ 基于遥测数据的力反馈
- ✓ 遥测录制
- ✓ 虚拟摇杆(vJoy)
- ◐ 虚拟 Xbox 手柄
- ✓ 虚拟功能
- ✓ 设置向导 / 自动分配
- ✓ 座舱
- ✓ 速查表
- ✗ 游戏内测试
摘自支持矩阵(根据引擎代码生成): 所有游戏.
#3 步上手
- 全部帮我设置好
在开始页面 - 使用这些按钮
先查看列表 - 写入我的游戏
保持 X-Plane 关闭
之前:连接你的设备后启动一次 X-Plane,然后退出。
之后:在 X-Plane 中校准你的设备(Settings > Joystick)。你的分配也会显示在那里。
以前在 X-Plane 中绑定过按钮?那么开始页面会提供 导入,然后填补空缺。你的绑定会保留,只有空闲的按钮会获得新功能。请参见快速入门:让我的摇杆工作。
#JoyPro 能为 X-Plane 做什么
- 导入:你设备的轴用途、按钮命令、反向标记和响应曲线会导入你的配置文件。
- 关联:一个关联就是你所有游戏中的同一个功能(X-Plane、MSFS 和 DCS 中的“起落架”在同一个按钮上)。X-Plane 的飞行命令来自它自己的
Commands.txt。 - 导出:JoyPro 写入你所导出版本的摇杆首选项。X-Plane 会在 Settings > Joystick 中显示你的分配。
#导入你的 X-Plane 分配
- 打开开始页面。X-Plane 12(或 X-Plane 11)卡片会显示游戏的图片。如果它要求命令列表,请按 生成列表:JoyPro 会读取已安装 X-Plane 的
Resources\plugins\Commands.txt。 - 在卡片上按 导入 并选择 添加到我的配置文件(X-Plane 的这个文件中没有键盘绑定)。
- 按 立即导入。查看我的关联 会打开导入的内容。


#建立并检查关联
在 关联 页面上,关联中的 X-Plane 命令或轴会显示在你其他游戏中的相同功能旁边。用关联流程把它们合并,然后在导出页面上按 立即检查(检查)。
#导出到 X-Plane
- 关闭 X-Plane。 它会在设置窗口关闭时和退出时重写首选项。两个版本都以
X-Plane.exe运行,所以只要其中任何一个在运行,JoyPro 都会拒绝写入。 - 打开 导出。每个已安装的版本都有自己的卡片。
- 如果你是在 JoyPro 中设置设备的,请保持选择 在我的设备上替换 并勾选 同时清除我的其他设备。在卡片上按 立即导出。
启动 X-Plane 并打开 Settings > Joystick,然后选择你的设备。每个轴都会显示 JoyPro 写入的用途,按钮会显示它们的命令,轴上的 Edit Response Curve 会显示 JoyPro 写入的控制点和插值方式。
#你在 X-Plane 中需要自己做的事
- 连接你的设备后启动一次 X-Plane,然后退出。 从未启动过的版本还没有首选项文件。第一次启动时会进入教程飞行,X-Plane 会在退出时写入它的摇杆首选项。
- 在 X-Plane 中校准。 校准和零区仍由 X-Plane 管理(Settings > Joystick);JoyPro 从不写入它们。
- 插件和飞机命令不在 JoyPro 的列表中:请在 X-Plane 中绑定它们,JoyPro 不会改动它们。
#常见问题
- 某个轴没有反应(“Multiple axes assigned to yaw”):X-Plane 会忽略两个已连接轴共用的用途。导出时会发出警告;同时清除我的其他设备 或替换模式会清除另一个轴。
- 油门方向反了:X-Plane 会自行反转油门轴。JoyPro 会原样写入你的反转设置,所以除非你的油门杆确实是反方向的,否则请保持反转关闭。
- 你在 X-Plane 中做的曲线被改了:在更新模式和仅添加模式下,如果 JoyPro 的调校是线性的,它会保留(并给出警告);“我的配置文件优先”和替换模式会写入 JoyPro 的曲线。
#JoyPro 读取和写入的文件
| 文件 | 这是什么 |
|---|---|
<install>\Output\preferences\X-Plane Joystick Settings.prf |
所有设备的当前分配(按行存储) |
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf |
已保存的控制配置文件,格式相同 |
<file>.joypro.json、<file>.joypro-meta.json |
JoyPro 写入的输入和曲线;供下次导入使用的名称、分组和调校 |
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt |
X-Plane 安装程序列出其安装位置的地方(只读) |
X-Plane Keys.prf(键盘)从不改动。通过 Steam 安装但从未启动过的版本会在其 Steam 文件夹中被找到。其他文件夹可在 设置 > 游戏 中设置。
#X-Plane 中的导出模式
| 模式 | X-Plane 中会发生什么 |
|---|---|
| 仅添加 | 只使用空闲的输入。如果某个绑定的输入已有其他用途或命令,该绑定不会被写入,并会被列出;X-Plane 在另一个轴上已有的轴用途会保留在那里(警告)。 |
| 更新,保留游戏的绑定 | 替换你的输入上原有的其他用途或命令,其他一切保持不变;轴用途会移动(如果两个轴共用一个用途,X-Plane 会忽略它)。 |
| 更新,以我的配置文件为准 | 此外还会清除已连接设备上占用了你所绑定的用途或命令的其他轴和按钮,连同它们的曲线。 |
| 在我的设备上替换 | 此外还会清除你写入的设备上的其他所有飞行轴和命令。 |
| + 同时清除我的其他设备 | 你没有写入的已连接设备会失去它们的飞行用途和命令。 |
#绝不会改动的内容
- 未连接设备的槽位、导入时被忽略的设备,以及 JoyPro 用于转发的 vJoy 设备。
- 视角、摄像机、VR 和自定义命令轴,插件和飞机命令,键盘。
- 校准键(
_joy_center、_joy_null、原始校准数据)、_eq_pfc_*以及其他每一行。
#曲线和设置
- 粒度:所有飞机共用一个文件(X-Plane 可以把飞机关联到控制配置文件;JoyPro 会写入它找到的文件)。
- 响应曲线(轴模型
xplane):任意数量的节点,可选 LINEAR、CATMULL_ROM 或 CUBIC_AVG,以及油门、螺旋桨和混合比轴的固定区间(beta、顺桨、切断、FADEC ……)。默认曲线 会转换为节点;未更改的曲线保持原有字节。调校可以只针对一个版本,也可以同时针对两个版本(family:xplane)。 - 反向:
_joy_rev_axis,即你的反转设置原样写入(X-Plane 会自行反转油门)。 - 游戏设置(设置 > 游戏的力反馈设置):俯仰、横滚和偏航的控制响应;X-Plane 12 还有副驾驶轴以及用于力反馈摇杆的“control-loaded axes”;X-Plane 11 有增稳系统;两者都有襟翼档位。只会更改文件中已有的行。
- 力反馈:X-Plane 本身没有力反馈;只有 control-loaded 开关。
- 遥测录制:来自 X-Plane 的 UDP 数据输出(端口 49000),带有位置信息,因此可以生成 Tacview 航迹。
- 监视器:X-Plane 关闭后会发现首选项中的更改(监视器)。
#X-Plane 集成的内部机制
flowchart LR P["你的配置文件<br/>(关联 + 绑定)"] --> E["engine xplane12 export<br/>(或 xplane11)"] D["设备槽位<br/>VID:PID + HID 路径"] --> E E --> J["Output / preferences /<br/>X-Plane Joystick Settings.prf"] E --> C["control profiles /<br/>Name - Joysticks.prf"] J --> G["X-Plane: Settings > Joystick"] C --> G
代码:engine\Games\XPlaneIntegration.cs(每个版本一个实例)、engine\Games\XPlanePrf.cs、engine\AxisModels\XPlane.cs、engine\FfbModels\XPlane.cs、engine\Games\LegacyGameIds.cs(拆分为两个版本之前的配置文件会在加载时迁移)。
- 行:
_joy_AXIS_use<i>(用途代码)、_joy_rev_axis<i>、_joy_BUTN_use<i>(命令路径,sim/none/none= 空闲)、axis_response_curve<i>。全局索引:轴 = 槽位 × 25 + 轴,按钮 = 槽位 × 160 + 按钮。 - 设备:槽位
_joy_unique_id<slot> VID:<dec>PID:<dec>;有相同设备时,DirectInput HID 接口路径必须等于_joy_location<slot>。按钮是设备的按钮,接着是第一个苦力帽,从上开始顺时针作为 8 个按钮;其他苦力帽不映射。每个设备读取 160 个按钮和 25 个轴。 - 用途代码:两个版本中都有 0 到 66;X-Plane 12 增加了油门 9、副驾驶的俯仰/横滚/偏航/刹车/前轮转向以及两个机轮刹车。代码 74 到 77 和视角轴未编入目录。
- 命令列表:
engine xplane12 refresh-db/engine xplane11 refresh-db:该版本的轴表加上Commands.txt中的飞行命令组(sim/flight_controls、engines、autopilot、lights……;不包括sim/view、operation、replay……)。 - 导入 / 导出:
engine xplane12 import、engine xplane12 scan、engine xplane12 export(--mode、--nuke-untouched-devices、--dry-run),engine xplane11 export同理。会先备份到.jpbak。 - 设置和曲线:
engine ffb set--game XPlane12、engine binds tuning set--scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1、engine binds tuning preview(在 X-Plane 12.4.3 中实测误差在 0.0001 以内)。
#已知限制
- 用途代码 74 到 77 的含义;HID 与 DirectInput 的轴顺序对应关系是推断出来的。
- X-Plane 中没有曲线时的 Control Sensitivity 不在预览中。
- X-Plane 11 只对照其安装文件做过检查;游戏内菜单检查尚待进行。
- 测试:
engine\tests\smoke\xplane.ps1;在游戏(X-Plane 12)中,绑定和响应曲线通过了 33 个步骤中的全部 33 个;tools\e2e\games\XPlaneCurves.ps1会对照 JoyPro 的预览扫描每个轴。
关于此游戏的所有技术说明(根据代码仓库生成): xplane.md.