#跟随输入
切换按钮已撰写工具提示 跟随输入:按下按钮或大幅移动轴,列表就会跳到其关联;再按一次跳到它上的下一个关联(先无修饰键的)。录制或输入文字时不生效。此开关会在下次启动时保留(“设置 > 绑定”中也有)。
绑定页面把每个关联放到一个物理输入上:你某个设备的按钮、苦力帽方向或轴。关联说明发生 什么(每款游戏和每架飞机中的“Gear Up/Down”);它的绑定说明在 哪里 按下(“Throttle - HOTAS Warthog,按钮 22”)。关联在 关联 页面上创建;导出时绑定才会进入游戏(导出到你的游戏)。


flowchart LR L["在列表中<br/>选择一个关联"] --> R["录制输入<br/>(或在图片上)"] R --> S["立即保存:<br/>输入 1,有自己的<br/>修饰键和曲线"] S -.-> A["录制另一个输入:<br/>输入 2,有自己的<br/>修饰键和曲线"]
页面知道一个关联是轴还是按钮:轴关联只接受你大幅移动的轴,按钮关联只接受按钮、苦力帽或开关。标题下方的一行会说明它在等待什么(“正在查找:轴”)。
跟随输入(默认开启)的作用正好相反:按下设备上的任意按钮,列表就会跳到绑定在它上面的关联。再按一次同一个按钮,会跳到它上面的下一个关联。用来回答“这个按钮是干什么的?”非常方便。在录制进行中、你打字时以及设备图片打开时,它会暂停。


| 方式 | 时间 |
|---|---|
| 录制输入 | 常用方式:按下真实的按钮 |
| 在图片上绑定(可视化分配) | 你会看到设备的线稿,每个按钮上都有一个标记;点击标记,选择关联,然后点 绑定到此处 |
| 手动选择输入 | 设备未连接,或者你想直接输入输入名(JOY_BTN22、JOY_X) |


没有关联时,页面会显示 尚无可绑定的内容 和 前往关联。请先在 开始 页面导入一款游戏,或者先创建关联。
导出后,游戏自己的控制设置菜单会在该操作上显示绑定的按钮,关联涵盖的每架飞机都是如此。带修饰键时,DCS 会把它显示为修饰键组合(例如“JOY_BTN5 + JOY_BTN22”),IL-2 和 Star Citizen 则以各自的修饰键形式显示。轴曲线会变成游戏自己的轴设置(DCS:Axis Tune;IL-2:响应曲线;Star Citizen:该轴的选项),所以你在游戏中看到的是同一条曲线。


标题栏工具
所选绑定(右侧):设备图片(小图)、关联、设备、输入、轴或按钮、修饰键。作用 按游戏列出关联的操作(只读;在“关联”中打开 可以修改它们,移动... 把一个操作移到另一个按钮上,其余的留在这里)。
用你的设备绑定:录制输入、取消录制、清除输入(关联保留其修饰键和曲线,只去掉输入)、清除修饰键。手动选择输入:设备和输入列表、设置绑定、刷新选项、清除绑定。录制设置:超时(毫秒)、预热(毫秒)、轴阈值(行程的百分比)以及“同时获取松开时保持按下的按钮”(用于三段开关的中间位置)。
此绑定上的修饰键:勾选修饰键后点 将所选附加到绑定 / 将所选从绑定分离,或者新建一个(创建修饰键:名称、设备和输入,或 录制修饰键输入;反转 用于松开时为“开”的开关)。它的 x 会把它收起到只剩标题行(会被记住);显示 再次展开。
轴响应:曲线、死区、饱和度(仅限轴关联;选择轴时会自动展开,关闭一次后,下一个轴也保持关闭),见下文。卡位模式(带加力卡位的油门),见下文。绑定行为(高级):反转、滑块、双击。在所有位置解除输入的绑定(高级):在整个配置文件中释放一个物理输入。


一条默认曲线、每个游戏一条,或为你勾选的飞机设一条。飞机优先使用自己的曲线,否则使用所属游戏的曲线,再否则使用默认曲线。应用于 用复选框列出它们:
| 行 | 示例 | 用于 |
|---|---|---|
| 默认曲线 | 所有没有专属曲线的游戏和飞机(2.6.5 及之前这一行叫“所有游戏”) | |
| 一个游戏 | DCS、IL-2 Korea | 该游戏在此关联中所有没有专属曲线的飞机 |
| 一架飞机(DCS) | AH-64D BLK.II CPG | 仅限该飞机 |
| 一个游戏系列 | MSFS 系列(MSFS 2024、MSFS 2020) | 两个游戏一起;只有当关联中有两个游戏(或已保存该系列的曲线)时才显示 |
每一行旁边写着它目前使用的曲线:专属曲线、与 ... 相同(专属曲线完全相同的飞机)、使用 DCS / 使用默认曲线(没有自己的曲线;修改那条曲线也会改变它)。它的提示文字用一句话说明同样的内容。只有 DCS 每架飞机有一行:它是唯一按飞机写入曲线的游戏。DCS 行指的是列在它下方的此关联中的 DCS 飞机,而不是整个 DCS;当它有自己的曲线时会显示 专属曲线,用于下方没有专属曲线的飞机。
使用虚拟 Xbox 手柄的游戏(ACE COMBAT 8、Hell Let Loose: Vietnam,以及在 虚拟摇杆 页面上设为 Xbox 手柄的任何游戏)不导出,所以 JoyPro 自己在手柄上应用它们的曲线;面板会用粗体说明这一点。它们的反转从不来自 DCS:而是游戏自己的设置(只勾选该游戏并保存),否则使用该游戏的手柄惯例(ACE COMBAT 8 的俯仰默认是反向的)。
打开关联时勾选的内容: 使用 DCS 曲线的飞机(对于新关联:全部飞机)。有专属曲线的飞机保持未勾选,以免保存时被意外覆盖。如果你上次为此关联保存过某些行,就会恢复那些行(重启后也是),并显示它们的曲线。
“保存”会做什么 写在按钮上方:
可以同时勾选多架飞机;其他任何行只能单独勾选。逐架勾选飞机时,只要还有一架没勾选,DCS 行就不会自动勾选:只勾选一架飞机时,它会获得专属曲线,即使它是唯一使用 DCS 曲线的飞机。只有全部勾选时,DCS 行才会一起勾选。如果勾选的飞机目前曲线不同,上方的那行文字会说明,并显示第一架勾选飞机的曲线;不会合并任何内容。当前曲线(点击勾选) 按共用的曲线给飞机分组(“AH-64D BLK.II CPG、AH-64D BLK.II Pilot、Ka-50 III:相同曲线”、“SA342 Copilot、SA342 Pilot:使用 DCS”);点击即可勾选该组。
面板用蓝色显示曲线;当显示的曲线不是该行自己的曲线时,默认曲线以橙色虚线显示。每个游戏都有自己的曲线类型(DCS:死区、饱和度 X/Y、曲率或 11 点自定义曲线;IL-2:它自己的灵敏度和死区;X-Plane:自由的曲线点),因此右侧的滑块会随所选行变化。当某个游戏退回使用默认曲线时,JoyPro 会在该游戏能表达的范围内,尽量让它的参数贴合默认曲线。
拖动白点来调整曲线形状,或者使用滑块。每项设置旁边还有一个标明范围的数字框:输入精确数值,或者按向上 / 向下键(按住 Shift:一次十步),也可以在当前所在的框上滚动鼠标滚轮。超出范围的数字在你按 Enter 或离开该框时会回到最近的端点,框下方的那行文字会说明这一点。自定义曲线 有 11 个数字框,每 10 % 摇杆行程一个(0 % ... 100 %),与曲线上的白点一一对应。
数字使用各游戏自己的单位;数字框上方的那行文字会说明是哪种单位。对 DCS(以及基础曲线)来说,单位与 DCS 自己的轴调校对话框相同:死区、饱和度 X/Y 和自定义曲线点为 0 .. 100,曲率为 -100 .. 100,所以死区为 8 时就输入 8。你的配置文件和导出保存的是 DCS 文件中保存的值(0.08),小数位更多的数值在你修改之前保持精确不变。Falcon BMS 使用启动器的 0 .. 3 档,FSX 为 0 .. 127,依此类推。
修改会立即预览(摇杆的实时位置也会以圆点显示);保存 会一步把它们应用到勾选的行(一次 Ctrl+Z)。重新使用游戏的曲线 会移除勾选飞机的专属曲线(对于游戏:重新使用默认曲线),同样是一步完成。重新加载 会重新读取它们。
在卡位模式下,被卡位模式弯折的飞机曲线(“使用默认曲线,在卡位处弯折”)会按游戏实际得到的样子显示,并且不能在这里修改或保存:为它保存的曲线会优先于卡位模式,从而关闭该飞机的卡位模式。要修改它,请勾选 默认曲线(卡位模式所弯折的曲线),或修改下方的卡位设置。
复制到另一个轴... 一步把相同的设置应用到另一个已绑定的轴上,例如从 Thrust Left 复制到 Thrust Right:选择轴,只有当两个轴应该以相同方式反转时才勾选 同时复制反转,然后点 复制。设置会应用到另一个轴的相同游戏或飞机(勾选的那些);一次 Ctrl+Z 即可撤回。
带加力卡位的油门以前需要为每种加力位置各建一个油门关联。在卡位模式下,一个 油门关联就能服务所有飞机:JoyPro 按飞机弯折曲线,使你油门的卡位正好位于该飞机加力开始的位置(F-16C 在 77 %,F-14 在 70 %,……)。停在卡位上时刚好低于加力;推过卡位就会点燃加力。
下方的飞机分组显示每组的加力从哪里开始,以及这个数值的来源;输入你自己的数值后点 设置,或点 游戏数据 恢复。
在每架导出的飞机中,油门都正好在你设备的卡位处进入加力。DCS 获得按飞机的曲线(死区和饱和度,或自定义曲线),X-Plane 获得曲线点;所有飞机共用一条曲线的游戏会得到关联中大多数飞机所需的曲线,导出时会列出其余飞机。
一个关联可以使用多个输入,每个输入都有自己的设备、修饰键和轴曲线(同一个握把装在两个底座上,第二个开火按钮)。卡片会显示 +1(其他输入在其提示文字中),选中的关联会有 更多输入 面板:
在游戏允许一个操作有多个输入时,导出会写入每个输入;不允许时会列出相关的关联(导出)。详情和各游戏的对照表:docs/multi-bind.md。只有一个输入的关联与以前完全相同;无需打开任何设置(2.6.5 及之前它位于 设置 > 实验性)。
每个页面都能通过关联的任一输入找到它:跟随输入 和 HUD(按下第二个摇杆时)、布局页面的图片和表格、本页面和关联页面的 设备 筛选、范围设为 全部 的搜索(“MOZA”会找到在该设备上有输入的关联)、检查页面以及替换/移除设备。对于有多个输入的轴,轴响应 部分顶部有一个 输入 列表:每个输入都有自己的曲线、死区和饱和度;选择要调校的那一个(主输入是输入 1)。
视图模型:MainWindowViewModel.cs(绑定列表、录制、设置/清除、修饰键)、MainWindowViewModel.AxisTuning.cs(曲线、通过链接的 engine/AxisTuning.cs 实时预览)、MainWindowViewModel.AxisTuningAppliesTo.cs(“应用于”的勾选、保存方案、分组、记住的勾选)、MainWindowViewModel.Detent.cs、MainWindowViewModel.AutoAssign.cs、MainWindowViewModel.LayoutWithAi.cs、MainWindowViewModel.LayoutWorkspace.cs 和 MainWindowViewModel.VisualAssign.cs(在图片上绑定)、MainWindowViewModel.LiveInput.cs(跟随输入)、MainWindowViewModel.BindPeek.cs(作用)、MainWindowViewModel.MoveAction.cs。
从点击 录制输入 到保存绑定:
| # | 谁 | 会发生什么 |
|---|---|---|
| 1 | 你 | 按 录制输入。 |
| 2 | 绑定页面 | 启动捕获服务(DirectInput,CaptureNextAsync):轴或按钮模式、时间限制、预热、阈值。 |
| 3 | 你 | 按一个按钮或移动一个轴。 |
| 4 | 捕获服务 | 报告设备和输入(例如 JOY_BTN22)。 |
| 5 | 引擎 | binds set "Gear Up/Down" --device ... --input JOY_BTN22 保存绑定(配置文件自动保存,历史版本)。 |
| 6 | 绑定页面 | binds list 刷新卡片。 |
Services/JoystickCaptureService.cs 轮询 DirectInput;Services/RecordButtonTracker.cs 只接收状态变化,绝不会接收开始录制时已经按下的按钮(除非勾选了“同时获取松开时保持按下的按钮”)。模拟键盘的轴会被忽略,除非在 设置 > 设备 中允许。详情:实时输入。engine binds list、engine binds show、engine binds set(设备、输入、--inverted、--slider、--curvature、--deadzone、--saturation-x/-y、--double-tap)、engine binds clear(--input-only 对应“清除输入”)、engine binds unbind、engine binds import / engine binds export(JSON)。engine binds modifier add、engine binds modifier remove、engine binds modifier list。engine binds tuning show、engine binds tuning set(--scope plane:DCS:F-16C_50 | game:IL2Korea | family:il2 | base,--param key=value,--curve-points)、engine binds tuning clear。按绑定保存为 TuningOverrides(范围 -> inv=0;sl=0;dz=0.05;sx=1;sy=1;cv=0.2)。参考:axis-curves。engine binds detent show、engine binds detent set(--on/--off,--no-ab full|linear)、engine binds detent calibrate(--idle --detent [--full] [--cutoff],按设备轴保存)、engine binds detent merge(方案;--apply 合并为一个历史版本)。卡位数据:DB\Detents\throttle-gates.json。engine devices kb(识别、列出、显示)、engine relations auto-assign(--dry-run 用于预览,--explain,--overwrite [--include-missing],--relation,--max-modifiers,--add-device,--ignore-device)。engine arrange ask、engine arrange apply --proposal、engine arrange prefs。本页背后的功能文档,由代码仓库生成:
109 个控件,读取自程序的源代码:109 个已撰写,0 个附有源代码中的信息(工具提示、代码注释、引擎调用),0 个尚待扩充。
工具提示 跟随输入:按下按钮或大幅移动轴,列表就会跳到其关联;再按一次跳到它上的下一个关联(先无修饰键的)。录制或输入文字时不生效。此开关会在下次启动时保留(“设置 > 绑定”中也有)。
工具提示 只有一个操作移到另一个按钮;其他操作留在此按钮上
当配置文件还没有关联时显示:打开“关联”页面,你需要先在那里创建关联,才能绑定任何东西。
工具提示 在设备图片上选择关联
“可视化分配”:在编辑器的位置显示你设备的图片,每个按钮和轴上都有一个标记,用来在上面选择关联;图片上的 x 会再次关闭它。
工具提示 从所有使用该输入的关联中移除所选绑定的输入
工具提示 修饰键库:重命名、删除、查看使用位置
打开“修饰键”页面:修饰键库,你可以在这里重命名和删除修饰键,并查看它们在哪里被使用。
工具提示 自动分配:JoyPro 会将你的关联绑定到设备上合适的控件(TMS 放在 TMS 苦力帽上,起落架放在起落架手柄上)。请先预览;点击“应用”前不会有任何更改。
工具提示 用你自己的话说出你喜欢的操控方式(throttle and left-hand stick, trim on the hat, curves softer for helis);JoyPro 会布局绑定、曲线、力反馈和 vJoy,并在应用任何内容之前显示每项更改。
打开或关闭“绑定”页面上的“用 AI 布局”,并读取此配置文件保存的偏好。
说出你喜欢怎样的控制方式;在应用任何内容之前,JoyPro 会显示对绑定、曲线、力反馈和 vJoy 的每项更改。
工具提示 设置向导:一次性为你监视的游戏生成关联和绑定(设备角色、飞机优先级、修饰键、功能位置),然后在做任何更改前由你检查
工具提示 刷新、导入和导出绑定,保存
打开“更多”菜单:刷新绑定、在“输出”面板中显示所选绑定、替换所选绑定的设备、以 JSON 导入或导出绑定、保存并合并配置文件。
工具提示 把该设备的所有绑定逐个输入地移到另一个设备,并带预览
立即保存配置文件。JoyPro 在每次更改后都会自动保存;这会立刻写入待保存的编辑,并重新写入文件。
“用 AI 布局”:把这个示例添加到你的文字中;在“预览”之前可以编辑它。
工具提示 与设置向导相同:为你的游戏中配置文件里没有的重要功能创建关联,并与其余关联一起放置
工具提示 显示 JoyPro 理解的内容和每项更改;目前不会更改任何内容
工具提示 将勾选的更改作为一步应用(撤销会全部还原)
在“用 AI 布局”中“应用”之后显示:一步撤回整个已应用的布局。
工具提示 放弃此预览;不更改任何内容
工具提示 忘记此配置文件中保存的所有偏好
工具提示 忘记此偏好
“用 AI 布局”:“忘记”会移除这一条偏好,并丢弃显示的预览;再按一次“预览”可得到新的预览。
“用 AI 布局”:勾选或取消勾选预览中该分组的所有更改;只有勾选的更改会被应用。
列表中某一项的勾选:在“用 AI 布局”中是一项建议的更改;在“此绑定上的修饰键”的修饰键列表中是一个要附加、取下或删除的修饰键。
工具提示 根据设备目录识别已连接的设备
工具提示 不为此设备分配任何内容
“自动分配”:“略过”会把此设备排除在外,不会给它分配任何内容。
工具提示 JoyPro 对此设备每个输入的了解(设备目录)
把选中的目录设备作为尚未连接的设备添加到“自动分配”:它的绑定会先放在一个占位设备上,等真实设备插上后,你再把它换成真实设备。
工具提示 JoyPro 对所选目录设备每个输入的了解
关闭由“布局”/“显示布局”显示的设备布局。
把添加的目录设备再从“自动分配”中移除;不会在它上面放置任何内容。
工具提示 关联回到它们之前所在的控件(设备获得新 id 后也是如此)
工具提示 重新布置这些设备上的绑定;键盘、vJoy 和未连接的设备保持不变
工具提示 只分配列表中选中的关联;其他关联保留其绑定,其控件仍被占用
工具提示 选中的关联为何得到其控件:最佳候选及其得分,以及占用它们的内容(预览,不做任何更改)
工具提示 在“布局”页面打开此图片:把标记移到真实部件上、使用你的照片、标记助手
“可视化分配”:“编辑标记”会在“布局”页面以标记编辑模式打开此设备:把标记移到真实部件上,使用你自己的照片或标记助手。
工具提示 旋转设备(拖动;滚轮缩放;双击重置);将关联拖放到部件上即可绑定
工具提示 将左侧(或列表中)选择的关联绑定到此输入
工具提示 在关联编辑器中打开此关联以更改其操作
作用:“在‘关联’中打开”会在“关联”页面的关联编辑器中打开此关联,你可以在那里更改它的操作。
作用:点击操作的飞机数量可以显示或隐藏它的飞机名称。
工具提示 只有一个操作移到另一个按钮;其他操作留在此按钮上
停止正在进行的“录制”;不会绑定任何内容。
工具提示 从此关联移除输入
重新读取已连接的设备及其输入,并重新填充设备和输入列表,例如在你插上摇杆之后。
工具提示 “录制”只获取状态会变化的按钮。录制开始时已按下的按钮(三位开关的中间位、模式开关)永远不会被计入;勾选后,松开会被计为该按钮。
工具提示 此输入成为主输入;主输入移到它的位置。每个操作只保留一个输入的游戏会使用主输入。
工具提示 上方“手动选择输入”中的设备和输入将成为此关联的又一个输入
“添加手动选择的输入”:把上方选择器中选好的设备和输入,作为所选关联的又一个输入添加进去,适用于难以录制的输入。
“刷新选项”:根据配置文件绑定中的设备和输入选择器中的设备,重新生成两个设备列表,例如在新建绑定之后。
打开“修饰键”页面:配置文件的每个修饰键、它在哪里使用,以及重命名和删除。
工具提示 再次显示此绑定的修饰键
在已收起的“此绑定上的修饰键”行上的“显示”:重新打开该绑定的修饰键列表。
把勾选的修饰键从所选绑定上取下;修饰键本身仍保留在配置文件中。
重新读取配置文件的修饰键和绑定,并刷新修饰键列表。
让新修饰键反转:松开它的输入时视为按住。
取消勾选列表中的每个修饰键。
从配置文件重新读取所选轴关联的曲线,并丢弃面板中未保存的编辑。
轴响应,“应用于”:勾选显示的曲线要保存到哪里。
工具提示 游戏的响应曲线,可有任意数量的点:x = 轴行程,y = 输出,均为 0..1,x 递增
工具提示 在最大间隔的中间新增一个点
工具提示 一步将相同的死区、饱和度、曲线和滑块应用到另一个已绑定的轴(例如 Thrust Left 到 Thrust Right)
工具提示 关闭:另一个轴保留自己的反转(左右两侧常常不同)
“复制到另一个轴”中的“同时复制反转”:关闭时,另一个轴保留它自己的反转;开启时,它也会获得此轴的反转。
工具提示 一步操作:Ctrl+Z 可撤销
“复制到另一个轴”中的“复制”:一步把显示的设置写入选中的轴,即用相同的 --scopes 为另一个关联执行 binds tuning set。
按一次 Ctrl+Z 即可撤回;此轴保留它的值。
工具提示 没有加力的飞机在卡位之后没有任何内容,所以在卡位处就达到全推力;否则最后一段你得推过卡位。关闭:其曲线覆盖整个行程。
工具提示 把油门移到怠速、卡位和全开;JoyPro 会实时读取设备。保存在此设备轴上,适用于该轴上的每个油门关联。
工具提示 同一设备轴上按飞机划分的油门关联会合并为卡位模式下的一个关联(先预览,之后可撤销)。
重新读取关联的卡位设置、校准和飞机分组。
校准:跳过可选步骤。
校准:回到上一步,重新记录那个位置。
关闭校准而不保存;旧的校准保持不变。
把配置文件恢复到进行合并时所基于的版本:油门关联恢复原样。
关闭合并助手;已经完成的合并保留。
工具提示 此分组的每架飞机都采用这个加力起点;留空 = 游戏数据。
工具提示 恢复为 JoyPro 游戏数据中这些飞机的加力起点。
卡位模式,飞机分组:“游戏数据”会移除你为这些飞机设置的加力值;它们会使用 JoyPro 游戏数据中的加力起点。
把绑定标记为双击。只保存在配置文件中;可作为速查表的备注,也可用于虚拟功能。