X4: Foundations 把你的绑定保存在 inputmap.xml 中,并按槽位(1 到 8)而不是按名称来命名摇杆。哪个设备在哪个槽位记录在 config.xml 中。JoyPro 会把太空飞行绑定读入你的配置文件,并就地写回到 X4 已为你的设备固定的槽位上。在 X4 中反转和死区是全局游戏设置,所以 JoyPro 会根据你的关联为整个游戏设置它们。
X4: Foundations 原生(使用游戏自己的绑定文件)
- 支持
- 原生(使用游戏自己的绑定文件)
- 引擎命令
engine x4- 绑定文件
Documents\Egosoft\X4\<id>\inputmap.xml(XML)+config.xml中的槽位- 游戏读取的输入
- 每个摇杆读取 64 个按钮、8 个轴、1 个苦力帽(已验证)
- 命令列表来源
X4.exe的名称表和.cat/.dat存档- 游戏内测试
- 通过 36/36 个步骤(2026-10-11)
- ✓ 导入
- ✓ 导出
- ✓ 键盘绑定
- ◐ 修饰键X4:键盘绑定可用 Shift/Ctrl;摇杆绑定不能用修饰键。
- ✓ 在你的电脑上生成命令列表
- ✓ 游戏监视器
- ✗ 轴曲线和死区X4:只有游戏全局的死区和反转(Game settings),没有按绑定的设置。
- ✓ 游戏控制设置
- ✗ 游戏内力反馈设置
- ✗ 基于遥测数据的力反馈
- ✗ 遥测录制
- ✓ 虚拟摇杆(vJoy)
- ◐ 虚拟 Xbox 手柄
- ✓ 虚拟功能
- ✓ 设置向导 / 自动分配
- ✓ 座舱
- ✓ 速查表
- ✓ 游戏内测试
X Rebirth 仅有文档说明
- 支持
- 仅有文档说明
- 引擎命令
- 无
- — 导入
- — 导出
- — 键盘绑定
- — 修饰键
- — 在你的电脑上生成命令列表
- — 游戏监视器
- — 轴曲线和死区
- — 游戏控制设置
- — 游戏内力反馈设置
- — 基于遥测数据的力反馈
- — 遥测录制
- — 虚拟摇杆(vJoy)
- — 虚拟 Xbox 手柄
- — 虚拟功能
- — 设置向导 / 自动分配
- — 座舱
- — 速查表
- — 游戏内测试
X3 (Reunion, Terran Conflict, Albion Prelude) 仅有文档说明
- 支持
- 仅有文档说明
- 引擎命令
- 无
- — 导入
- — 导出
- — 键盘绑定
- — 修饰键
- — 在你的电脑上生成命令列表
- — 游戏监视器
- — 轴曲线和死区
- — 游戏控制设置
- — 游戏内力反馈设置
- — 基于遥测数据的力反馈
- — 遥测录制
- — 虚拟摇杆(vJoy)
- — 虚拟 Xbox 手柄
- — 虚拟功能
- — 设置向导 / 自动分配
- — 座舱
- — 速查表
- — 游戏内测试
摘自支持矩阵(根据引擎代码生成): 所有游戏.
#3 步上手
- 全部帮我设置好
在开始页面 - 使用这些按钮
先查看列表 - 写入我的游戏
保持 X4 关闭
之前:为每个设备分配一次槽位。在 X4 的控制设置中打开 Manage Controllers/Joysticks。把每个设备分配到一个槽位,然后正常退出游戏。
之后:你的绑定位于 Settings > Controls 中。
以前在 X4 中绑定过按钮?那么开始页面会提供 导入,然后填补空缺。你的绑定会保留,只有空闲的按钮会获得新功能。请参见快速入门:让我的摇杆工作。
#JoyPro 能为 X4 做什么
- 导入:你的摇杆、油门和脚舵的太空飞行绑定会导入你的配置文件,包括游戏的反转和油门模式。
- 关联:一个关联就是所有游戏中的同一个功能。“Boost”可以是 X4、Elite Dangerous 和 Star Citizen 中的同一个按钮。
- 导出:JoyPro 在你设备的槽位上就地编辑
inputmap.xml。菜单、第一人称、键盘和鼠标绑定保持不变。
#导入你的 X4 绑定
- 打开开始页面。如果 X4 卡片要求命令列表,请按 生成列表:JoyPro 会从你的安装中读取游戏的控制项(只读)。
- 在 X4 卡片上按 导入。保持选择 添加到我的配置文件。如果你也想把飞行按键放进 JoyPro,请勾选 同时获取键盘按键。
- 按 立即导入。查看我的关联 会打开导入的内容。
#建立并检查关联
用关联流程把你各个游戏中的相同功能合并起来,然后在导出页面上按 检查。摇杆绑定请不要使用修饰键:X4 的摇杆绑定不接受修饰键。
#导出到 X4
- 关闭 X4。 游戏会在一次会话结束时写入
inputmap.xml和config.xml,所以游戏运行时 JoyPro 会拒绝写入。 - 打开 导出 并勾选 X4 卡片。
- 如果你是在 JoyPro 中设置摇杆的,请保持选择 在我的设备上替换 并勾选 同时清除我的其他设备。在卡片上按 立即导出。
启动游戏并打开 Settings > Controls。你的绑定位于每个太空飞行控制项的控制器/摇杆列中,在你设备的槽位上。Invert Controller / Joystick Axes 会显示 JoyPro 设置的反转,双向油门、摇杆死区和自适应转向这几行会显示你的值。自动滚转和震动位于游戏设置中。
#你在 X4 中需要自己做的事
- 为每个设备分配一次槽位。 在 X4 的控制设置中打开 Manage Controllers/Joysticks,把每个摇杆、油门和脚舵分配到一个槽位,然后正常退出游戏。X4 随后会在
config.xml中记住该设备。没有这种条目的设备在每次会话之间会在槽位间移动,所以 JoyPro 会跳过它(“请在 X4 中为该设备分配一次槽位”)。在那里设为“none”的设备也会被跳过。 - 导出前插上你的设备。
#常见问题
- “X4 正在运行”:退出游戏,然后再次导出。
- 某个设备被跳过:它在 X4 中没有固定到槽位。请在 Manage Controllers/Joysticks 下分配它。
- 槽位 1 中的摇杆执行了手柄的功能:槽位 1 是 X4 默认映射中的手柄槽位,所以放在那里的摇杆会继承默认的手柄绑定。在我的设备上替换 会移除它们。
- 64 号以上的按钮或第二个苦力帽没有反应:X4 每个设备只读取 64 个按钮、8 个轴和一个苦力帽。超出范围的绑定 JoyPro 会跳过并给出警告。
- 某个反转没有被修改:一个反转设置对该控制项上的所有设备都生效。如果你的关联之间不一致,或者有手柄绑定到同一个控制项,JoyPro 会保留游戏的值并发出警告。
#JoyPro 读取和写入的文件
| 文件 | 这是什么 |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
生效的绑定(每个控制和输入的 <action>、<state>、<range>)以及 <config> 参数(反转、死区、双向油门、自适应转向)。<id> 是 Steam 账号的文件夹。 |
...\X4\<id>\config.xml |
设备槽位(<joysticks>)以及震动、自动横滚和手柄模式等游戏设置;槽位只读取,设置则就地编辑 |
...\X4\<id>\inputmap.xml.joypro-meta.json |
JoyPro 为已写入的绑定保存的名称、分组和调校,下次导入时会读回 |
inputmap.xml.jpbak、config.xml.jpbak |
首次写入之前的副本,以及 JoyPro 带版本的备份存储 |
该文件以文本方式写入:声明、换行符、缩进、各节的注释、<config>、根属性以及每个未改动的行都逐字节保持不变。新行会放在它所属的节中,位于同类且控制编号更小的最后一个条目之后。JoyPro 从不改动已保存的配置文件 inputmap_1.xml 到 inputmap_5.xml,也不改动你的存档。Steam Cloud 会同步该文件夹;具体同步哪些文件尚未确认。
#X4 中的导出模式
冲突是指同一槽位和输入上有另一个飞行控制。某个控制在地图和详细监视器中的孪生控制算作同一个控制。
| 模式 | inputmap.xml 中会发生什么 |
|---|---|
| 仅添加 | 不删除任何内容。如果某个绑定的输入已被另一个飞行控制使用,该绑定不会被写入,并被标记为“未写入游戏”。 |
| 更新,保留游戏的绑定 | 你的行会与该控制的其他输入并存;只删除冲突项。 |
| 更新,以我的配置文件为准 | 同上,另外你绑定的控制会失去它在已连接设备的固定槽位上的其他行(开启键盘选项时还包括其键盘行)。 |
| 在我的设备上替换 | 已写入槽位上不在你配置文件中的飞行绑定会被删除,槽位 1 上自带的手柄飞行绑定也会被删除。 |
| + 同时清除我的其他设备 | 对于 config.xml 固定给已连接设备、但导出没有使用的槽位,也同样处理。没有固定设备的槽位不会改动:它对应的设备未知。 |
X4 的菜单会把一些控制绑在一起:“Toggle Travel Mode”会在地图中设置同一个输入,“Dock”同时也会解除停靠。JoyPro 像菜单一样成组写入和删除这些控制,并且从不删除第一人称视角的“Interact”孪生控制。
#绝不会改动的内容
- 菜单、地图、第一人称、选项和辅助功能控制;环形菜单条目。
- 键盘和鼠标行;只有开启键盘选项时才写入键盘,而且只针对飞行控制,从不使用 X4 菜单拒绝的按键(Escape、Delete、Ctrl+X/C/V ……)。
- 未连接或未固定的设备的槽位、手柄、导入时被忽略的设备,以及 JoyPro 用于转发的 vJoy 设备。
- JoyPro 没有设置的每一行
<config>。
#曲线和游戏设置
- 粒度:所有飞船共用一套绑定(太空飞行控制)。
- 反转是每个控制一个值,对所有设备有效(
invert_steering_yaw、_pitch、_roll、invert_throttle、invert_strafe_*)。你的关联保持 DCS 的方向;X4 自带的 HOTAS 映射把俯仰、横滚和油门视为反转,所以对这几项 JoyPro 会把参数设为你的反转设置取反后的值。只有当该控制上的所有 JoyPro 轴都一致时,它才会设置该参数。 - 双向油门取决于油门关联的 滑块 设置:滑块 = 只能向前,非滑块 = 中间位置为零推力。
- 死区:X4 为每个摇杆的所有轴只设一个死区。关联的死区不会被写入(导出会说明这一点);请在 设置 > 游戏的力反馈设置(选择 X4)中或用
engine ffb set设置游戏的死区。自适应转向、震动、自动横滚和手柄模式也在同一个地方。你在那里保存的设置优先于关联;如果与关联相反,会给出警告。 - X4 没有按轴的曲线或饱和度;没有力反馈;没有遥测。
- 监视器:你在游戏中更改的绑定或选项会在游戏关闭后被发现(
inputmap.xml和config.xml),JoyPro 会询问是否接受这些更改。 - HUD:HUD 通过进程识别该游戏,并显示你的 X4 绑定。
#X Rebirth 和 X3
X Rebirth 使用与 X4 相同的 inputmap.xml 词汇,但它的命令列表需要从安装中另行提取。X3(Reunion、Terran Conflict、Albion Prelude)使用另一个引擎,文件格式未知。两者都只有文档记录:JoyPro 不会导入或导出它们。
#X4 集成的内部机制
flowchart LR D["你的设备<br/>(实例 GUID)"] --> C["config.xml<br/>joysticks"] C --> S["固定到槽位:<br/>槽位 1 ... 8"] C --> K["未固定或已禁用:<br/>跳过,请在 X4 中<br/>分配一次"] P["你的配置文件"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>每个槽位的绑定"] E --> O["全游戏范围的选项:<br/>反转、油门模式"]
代码:engine\Games\X4Integration.cs、engine\Games\X4CatalogSource.cs 以及设置模型 engine\FfbModels\X4.cs。
- 槽位:绑定会指明来源:
INPUT_SOURCE_JOYBUTTONS(按钮和苦力帽)或INPUT_SOURCE_JOYAXES,槽位 1 不带后缀,其他槽位为_2到_8。config.xml通过 DirectInput 实例 GUID 把设备映射到槽位,以 X4 自己的格式书写({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00});num0 到 7 是槽位,disabled="1"表示没有。JoyPro 只写入当前已启用条目与某个已连接设备匹配的槽位。 - 编码:按钮 1 到 11 使用 X4 的手柄名称(
INPUT_XBUTTON_A...BIGBUTTON),12 到 64 为INPUT_XBUTTON_12...;苦力帽为INPUT_XBUTTON_DPAD_*(八个方向);轴为INPUT_JOYAXIS_X...RZ、SLIDER1、SLIDER2。范围不带sgn。键盘:INPUT_KEYCODE_<DIK>,加_SHIFT/_CONTROL。 - 命令列表:
engine x4 refresh-db以只读方式从.cat/.dat存档中读取gameoptions.lua和英文文本页,并读取X4.exe的名称表;共 128 个太空飞行控制(6 个轴,122 个按钮)。各行显示为“Yaw (Primary Steering Axis)”、“Roll (Secondary Steering Axis)”这样的形式。engine x4 catalog列出该列表,engine x4 paths显示找到的文件。 - 导入 / 导出:
engine x4 import、engine x4 scan;engine x4 export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run。 - 游戏设置:
engine ffb set --device * --game X4 --param <key>=<value>;参数就地编辑,缺少的参数会作为<config>的最后一行添加。即使导出时没有 X4 绑定,也会写入已保存的设置。
#已知限制
- 没有固定槽位的设备会被跳过;JoyPro 目前还不会自己去固定它们。
- 摇杆修饰键不会被写入:它们在文件中的标记方式尚未确认。
- 每个设备 64 个按钮、8 个轴和一个苦力帽;八个槽位,与手柄共用。
- 震动:游戏的滑块显示的是数值乘以 100 后截断的结果(21 % 显示为 20);文件中保存的是精确值。
- 测试:
engine\tests\smoke\x4.ps1(也包括目录刷新);在游戏中运行tools\e2e\games\X4.ps1(绑定和模式矩阵,使用独立的配置文件夹)和tools\e2e\games\X4Settings.ps1(反转、油门模式、游戏设置)。
关于此游戏的所有技术说明(根据代码仓库生成): x4.md.