JoyPro2 Discord GitHub
游戏

Arma 3

显示:

Arma 3 把你的绑定保存在玩家配置文件 <name>.Arma3Profile 中:每个操作一行数字代码,外加一份游戏见过的摇杆列表。JoyPro 会把固定翼飞机和直升机绑定读入你的配置文件,并且只写回这些行。步兵、载具和菜单绑定保持原样。在 Arma 中,响应曲线是按设备和物理轴设置的,因此一条曲线对所有载具都有效。

Arma 3 原生(使用游戏自己的绑定文件)
支持
原生(使用游戏自己的绑定文件)
引擎命令
engine arma3
绑定文件
Documents\Arma 3\<name>.Arma3Profile(ParamFile 文本,数字输入代码)
命令列表来源
游戏配置(bin.pbo > config.bin)以及 languagecore 中的英文名称;无需先启动游戏
游戏内测试
通过 25/25 个步骤(2026-10-10)
  • ✓ 导入
  • ✓ 导出
  • ✗ 键盘绑定
  • ✗ 修饰键
  • ✓ 在你的电脑上生成命令列表
  • ✓ 游戏监视器
  • ✓ 轴曲线和死区
  • ✓ 游戏控制设置
  • ✗ 游戏内力反馈设置
  • ✗ 基于遥测数据的力反馈
  • ✗ 遥测录制
  • ✓ 虚拟摇杆(vJoy)
  • ◐ 虚拟 Xbox 手柄
  • ✓ 虚拟功能
  • ✓ 设置向导 / 自动分配
  • ✓ 座舱
  • ✓ 速查表
  • ✓ 游戏内测试

摘自支持矩阵(根据引擎代码生成): 所有游戏.

新手入门

#3 步上手

  1. 全部帮我设置好
    在开始页面
  2. 使用这些按钮
    先查看列表
  3. 写入我的游戏
    保持 Arma 3 关闭

之前:在连接好所有设备的情况下启动一次 Arma 3,然后退出。

然后:你的绑定就在 Options > Controls 中。

你以前在 Arma 3 中绑定过按钮吗?那么开始页面会提供 导入,然后填补空缺。你的绑定会保留,只有空闲的按钮会获得新功能。参见 快速入门:让我的摇杆能用。

#JoyPro 为 Arma 3 做了什么

  • 导入:你的摇杆、油门和脚舵上的固定翼飞机和直升机绑定会连同每个轴的灵敏度、死区和陡度一起进入你的配置文件。
  • 关联:一个关联就是所有游戏中的同一个功能。“Gear”可以是 Arma 3、DCS 和其他游戏中的同一个开关。
  • 导出:JoyPro 只重写飞行操作的按键行。你的键盘和鼠标绑定保持不变,这些操作上的也一样。

#导入你的 Arma 3 绑定

  1. 打开 开始 页面。如果 Arma 3 卡片要求生成命令列表,按 生成列表:JoyPro 会从游戏配置中读取操作及其英文名称(只读,不需要先启动游戏)。
  2. 在 Arma 3 卡片上按 导入,保持选择 添加到我的配置文件。
  3. 按 立即导入。查看我的关联 会打开导入的内容。

在 Arma 3 中,键盘绑定不会被导入或导出:JoyPro 只管理你的摇杆。

#建立并检查关联

用 关联流程 把你各个游戏中的同一功能连接起来,然后在导出页面按 检查。导出时直升机和固定翼飞机算作不同的载具:同一个按钮分别用于一个固定翼飞机操作和一个直升机操作不算冲突;两个固定翼飞机操作用同一个按钮则算冲突。

#导出到 Arma 3

  1. 关闭 Arma 3。 游戏会在退出时以及你更改设置时保存配置文件,因此游戏运行时 JoyPro 拒绝写入。
  2. 打开 导出 并勾选 Arma 3 卡片。
  3. 如果你是在 JoyPro 中设置摇杆的,请保持选择 在我的设备上替换 并勾选 同时清除我的其他设备。在卡片上按 立即导出。
在游戏中: 你在 Arma 3 中看到的内容

启动游戏,在主菜单中打开 Options > Controls。你的绑定位于固定翼飞机和直升机操作上,在你原有的键盘按键旁边。在 Controllers 下会列出你的设备并处于启用状态;设备的 Customize 会显示 JoyPro 写入的灵敏度、死区和陡度。

#在 Arma 3 中需要你自己做的事

  • 在连接好所有设备的情况下启动一次 Arma。 游戏第一次看到某个设备时才会把它加入列表(并为它分配编号范围)。JoyPro 无法写入列表中没有的设备:它会跳过该设备,并提示你在连接它的情况下启动一次游戏。
  • 你在游戏的 Controllers 列表中禁用的设备,如果获得了绑定,导出时会被开启(导出会说明这一点),除非你在 JoyPro 中为 Arma 3 关闭了它(enabled=0,参见“技术细节”)。

#常见问题

  • “Arma 3 正在运行”:退出游戏,然后重新导出。
  • 某个设备被跳过:Arma 还没见过它,或者它获得了新的 ID(换一个 USB 接口会产生一个带新编号范围的新条目)。请在连接该设备的情况下启动一次游戏。
  • 一个轴上有两个曲线不同的关联:Arma 每个物理轴只有一条曲线。按名称排在前面的关联生效;导出会列出这两个关联。
  • 油门只在半个油门杆行程上起作用:模拟推力需要油门杆的两半。JoyPro 会把固定翼飞机的油门和减速板写成全轴;请检查该关联是否绑定在轴上,而不是按钮上。
高级

#JoyPro 读取和写入的文件

文件 这是什么
%USERPROFILE%\Documents\Arma 3\<name>.Arma3Profile 默认配置:key<Action>[]={...}; 行、class JoysticksList(设备及其数组)和游戏选项
%USERPROFILE%\Documents\Arma 3 - Other Profiles\<name>\<name>.Arma3Profile 你的其他配置(文件夹名和文件名经过 URL 编码,Mission%20Builder)
<profile>.joypro-meta.json JoyPro 为已写入的绑定保存的名称、分组和调校,下次导入时会读回
<profile>.jpbak 首次写入之前的副本,以及 JoyPro 带版本的备份存储

JoyPro 从不改动 <name>.vars.Arma3Profile 或 .3den.Arma3Profile,如果配置是二进制(rapified)文件而不是文本,它会停止。-profiles= 文件夹或其他“文档”文件夹可以在导出页面的 选项和路径(供专家使用) 下设置。

#Arma 3 中的导出模式

只有已收录的固定翼飞机和直升机操作的行会改变。键盘、鼠标、TrackIR 和 Xbox 手柄的代码始终保持不变。

模式 配置中会发生什么
仅添加 不会移除任何内容。如果某个绑定的代码已被同一载具的另一个操作使用,该绑定不会被写入,并标记为“未写入游戏”。
更新,保留游戏的绑定 写入你的代码;同一载具的另一个操作上、被你放到别处的代码会被丢弃。该操作的其他代码保留。
更新,以我的配置文件为准 同上,此外,你绑定的操作会失去已连接摇杆上的其他摇杆代码。
在我的设备上替换 飞行相关的行还会失去已写入设备的所有其他代码。
+ 同时清除我的其他设备 其他已连接摇杆的代码也是如此。未连接的摇杆保留它的代码。

#绝不会改动的内容

  • 步兵、载具、视角和菜单操作;所有不属于已收录飞行操作的行。
  • 键盘、鼠标、TrackIR 和 Xbox 手柄的代码。
  • 未连接的摇杆、编号范围在列表中没有对应设备的代码、导入时忽略的设备,以及 JoyPro 转发到的 vJoy 设备。
  • 设备列表本身:JoyPro 不会添加条目,只会更改现有条目的数组、模式和模拟量点击值。

#载具、曲线、游戏设置

  • 粒度:所有固定翼飞机和直升机共用一套绑定。有些操作是共用的(方向舵、起落架)。
  • 轴曲线,按设备和物理轴,与 Customize 对话框中的保存方式相同:每一半的灵敏度(-1 = 三次方,0 = 线性,+1 = 立方根)、死区(0 到 0.1)和陡度(1.0、1.2、1.5、1.9、2.4 或 3.0;其他值会就近取整并给出警告)。陡度是相乘后饱和,不是指数。JoyPro 只写入你为 Arma 3 设置的值或来自导入的值;你在 JoyPro 中的通用曲线不会被沿用。
  • 反转:Arma 没有反转标志。JoyPro 通过绑定轴的另一半来实现反转。
  • 整轴油门:“Thrust (Analog)”和“Speedbrake (Analog)”获得油门杆的两半,负半在前(油门杆向前),反转时正半在前。
  • 游戏设置:直升机高级飞行模型及其自动配平、仪表、粗暴着陆、风和应力损伤选项,以及手柄振动;每个设备的开/关和模拟量点击阈值。在 设置 > 游戏的力反馈设置(选择 Arma 3)中或用 engine ffb set 设置。即使导出中没有 Arma 3 的绑定,也会写入这些设置,并且不改动任何按键行。
  • 力反馈:Arma 3 没有摇杆力反馈选项。
  • 监视器:你在游戏中更改的绑定或曲线会在游戏关闭后被发现;JoyPro 会询问是否采用这些更改。
  • HUD:HUD 通过进程识别游戏,并显示你的 Arma 3 绑定。
技术细节

#Arma 3 集成的内部原理

flowchart LR
  D["你的设备"] --> J["JoysticksList"]
  J --> C["已见过:带<br/>offset 的代码"]
  J --> S["未见过:<br/>跳过"]
  P["你的配置文件"] --> E["engine arma3 export"]
  C --> E
  E --> L["按键行"]
  E --> A["设备数组"]
Arma 必须至少见过一次设备(它在配置文件 JoysticksList 中的实例 GUID)。它见过的每个设备都有自己的代码范围(offset 256、512 ……);尚未见过的设备会被跳过:请连接该设备启动一次 Arma。导出会写入飞机和直升机操作的按键行,以及设备数组(灵敏度、死区、陡度)。

代码:engine\Games\Arma3Integration.cs,基于与 Arma 2 共用的 Arma 配置代码(ArmaProfileIntegration.cs、ArmaGameData.cs)、轴模型 engine\AxisModels\Arma3.cs 和设置模型 engine\FfbModels\Arma3.cs。

  • 设备:class JoysticksList { class Joystick1 { guid="..."; name="..."; offset=256; isXInput=0; sensitivity[]={...}; deadZone[]={...}; steepness[]={...}; mode="Custom"; ... }; }。guid 是 DirectInput 的 实例 GUID,大写,不带花括号。offset 是 256 的 N 倍,在游戏第一次见到该设备时分配;拔出设备后条目仍会保留。mode="Disabled" 会关闭一个设备。
  • 代码(有符号 32 位,off = 设备的 offset):按钮 0x20000 + off + button;轴 0x30000 + off + a,a 为 0 到 7 表示正半轴,a + 8 表示负半轴(X、Y、Z、RotX、RotY、RotZ、Slider 1、Slider 2);苦力帽 0x40000 + off + direction(八个方向,一个苦力帽)。键盘代码是 DIK 编号。
  • 数组:sensitivity[](16 个值,先是正半轴,再是负半轴)、deadZone[](8 个)和 steepness[](8 个)。缺失的数组只有在某个值与默认值不同时才会创建,按游戏的保存顺序放在它前一个数组之后,其他轴使用游戏的默认值。导入 + 导出逐字节一致。
  • 命令列表:engine arma3 refresh-db 从 bin.pbo > config.bin 读取 CfgDefaultKeysPresets,并从 languagecore_f.pbo 的 stringtable.xml 读取英文菜单名称;配置还会加入模组的操作。共 51 个操作。engine arma3 catalog 列出它们,engine arma3 paths 显示找到的配置。
  • 导入 / 导出:engine arma3 import、engine arma3 scan;engine arma3 export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --ignore-device <d> --dry-run。
  • 设置:engine ffb set --device "<name> {GUID}" --game Arma3 --param enabled=0|1(还有 analogClickHigh、analogClickLow);全局设置用 --device *,参数为 RTDEnabled、RTDAutoTrim、RTDFullHUD、RTDRoughLanding、RTDWindDynamic、RTDStressDamage、vibrations。

#已知限制

  • 带修饰键的摇杆按钮尚未确认;JoyPro 不会为 Arma 3 写入修饰键,也不会写入键盘绑定。
  • 每个设备最多可以编码 256 个按钮、8 个轴和一个苦力帽(根据文件格式得出)。
  • Customize 滑块是否会把同一个值写入两半,以及部分操作额外叠加的单操作曲线,尚未确认(预览只显示设备曲线)。
  • 测试:engine\tests\smoke\arma.ps1(数组、设置、整轴油门、冲突警告、导入往返、只含设置的导出);游戏内测试 tools\e2e\games\Arma3Settings.ps1(测试配置 JoyProE2E,只使用主菜单 > Options > Controls)。

关于此游戏的所有技术说明(根据代码仓库生成): arma3.md.