JoyPro2 Discord GitHub
游戏

Tiny Combat Arena

显示:

Tiny Combat Arena 是一款所有飞机共用一套绑定的空战飞行游戏。它把控制设置保存在 Windows 注册表(Unity 的设置存储)中:每个设备、每个 Control Mapper 标签页(Flight、Weapons、Camera、View Select、Map UI、System)各有一个 Rewired 摇杆映射。JoyPro 会把这些映射读入你的配置文件,并把你的绑定写回每个设备的正确标签页。

Tiny Combat Arena 原生(使用游戏自己的绑定文件)
支持
原生(使用游戏自己的绑定文件)
引擎命令
engine tinycombatarena
绑定文件
注册表 HKCU\Software\TinyCombat\Arena(Unity PlayerPrefs,每个映射器页签一个 Rewired 映射)
命令列表来源
游戏的 sharedassets(Rewired 输入管理器)
游戏内测试
通过 21/21 个步骤(2026-10-11)
  • ✓ 导入
  • ✓ 导出
  • ✗ 键盘绑定
  • ✗ 修饰键
  • ✓ 在你的电脑上生成命令列表
  • ✓ 游戏监视器
  • ✗ 轴曲线和死区Tiny Combat Arena:不写入 Controls.cfg(曲线)。
  • ✗ 游戏控制设置
  • ✗ 游戏内力反馈设置
  • ✗ 基于遥测数据的力反馈
  • ✗ 遥测录制
  • ✓ 虚拟摇杆(vJoy)
  • ◐ 虚拟 Xbox 手柄
  • ✓ 虚拟功能
  • ◐ 设置向导 / 自动分配
  • ✓ 座舱
  • ✓ 速查表
  • ✓ 游戏内测试

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

新手入门

#3 步上手

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

之前:启动一次 Tiny Combat Arena 并打开它的 Control Mapper。然后关闭游戏。

之后:你的绑定会出现在游戏 Control Mapper 的各个标签页上。

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

#JoyPro 能为 Tiny Combat Arena 做什么

  • 导入:你已连接设备的摇杆映射会从每个标签页导入你的配置文件:带反转设置的轴、按钮、苦力帽方向,以及轴上的按钮(例如 Throttle Up / Down)。
  • 关联:一个关联就是一个功能,适用于所有飞机。
  • 导出:JoyPro 把每个绑定写入其标签页的映射中(俯仰写入 Flight,机炮写入 Weapons,视角写入 View Select),每个映射的其余部分保持不变。

#导入你的绑定

  1. 启动一次 Tiny Combat Arena,打开 Control Mapper(游戏随后会为每个已连接的设备保存一个映射),然后关闭游戏。
  2. 打开开始页面,在 Tiny Combat Arena 卡片上按 导入,然后按 立即导入。

#建立并检查关联

像其他游戏一样建立关联(关联流程)。JoyPro 还没有为这款游戏手工制作的功能表:设置向导和自动分配会使用一个根据游戏自身的名称和类别推导出的功能表。然后在导出页面上运行检查。

#导出到 Tiny Combat Arena

  1. 关闭 Tiny Combat Arena。 游戏运行时(进程 Arena)JoyPro 会拒绝写入;在 Control Mapper 中按 Done 时,游戏会保存所有映射。
  2. 打开 导出,保持 在我的设备上替换 并勾选 同时清除我的其他设备,然后在 Tiny Combat Arena 卡片上按 立即导出。
导出页面导出页面
导出页面 (图片显示的是英文版应用。)
在游戏中: 你在 Tiny Combat Arena 中会看到什么

打开游戏的 Control Mapper 并选择你的设备:你的绑定位于 Flight、Weapons、Camera、View Select 和 Map UI 标签页上。映射器按 Rewired 的编号命名输入:“Axis 0”是 X 轴,按钮 1 显示为“Button 0”,第一个苦力帽的向上显示为“Hat 0 Up”。打开映射器的菜单路径尚未确认。

#你在 Tiny Combat Arena 中需要自己做的事

  • 第一次导入或导出之前,先启动一次游戏,让它创建注册表项。第一次启动时会要求进行快速游戏设置和头部追踪设置;按你的喜好回答即可。
  • 曲线:游戏自己的摇杆和方向舵曲线以及油门速度保存在它的设置文件中;请在游戏中设置,JoyPro 不会写入这些内容。

#常见问题

  • “Tiny Combat Arena 正在运行”:关闭游戏,然后再次导出。
  • 某个设备被跳过:在游戏的映射中无法区分两个已连接的同型号设备;JoyPro 会跳过它们并给出警告。
  • Logitech Extreme 3D 或 T.16000M 的扭转轴或油门:游戏的 Rewired 能识别这些设备,并把它们的映射保存在另一个键下;JoyPro 目前还不支持。
  • 缺少苦力帽的斜向方向:JoyPro 只写入苦力帽的四个主方向。
高级

#JoyPro 读取和写入的内容

位置 这是什么
HKCU\Software\TinyCombat\Arena 注册表中该游戏的 Unity 设置;Rewired 的值是二进制的(UTF-8 文本加一个零字节),名称以 _h<hash> 结尾
每个设备和选项卡一个值,名称中带有 dataType=ControllerMap 和该设备的 hardwareIdentifier 一个设备在一个选项卡上的摇杆映射(Rewired XML),对应玩家 Player
<install>\Arena_Data\sharedassets*.assets 游戏的 Rewired 操作列表:只读,用于命令列表
%USERPROFILE%\AppData\LocalLow\TinyCombat\Arena\Settings\Controls.cfg 游戏的曲线和油门速度:不写入

每次写入之前,JoyPro 都会把该玩家的控制器映射值放入备份库;撤销上次导出 会把它们写回。

这些选项卡就是 Rewired 的映射类别:0 System、3 Flight、8 Weapons、11 Camera、4 View Select、9 Map UI。每个操作都会放到其操作类别对应的选项卡上(Flight Control 到 Flight,Weapon Control 到 Weapons,Camera Control 到 Camera,View Control 到 View Select,Map Control 到 Map UI,Default 到 System)。

#Tiny Combat Arena 中的导出模式

Tiny Combat Arena 是一个纯飞行游戏:每个可分配的操作都归 JoyPro 管理。

模式 你设备的映射中会发生什么
仅添加 游戏的内容不会有任何改变;如果某个绑定的输入已经在驱动另一个操作(或轴的另一极),该绑定会被略过并列出。
更新,保留游戏的绑定 如果你把某个输入分配给另一个操作,原先在该输入上的操作会失去它;该操作保留它的其他输入。
更新,以我的配置文件为准 同上,另外你绑定的每个操作都会失去它在 JoyPro 能读取的已连接设备上的其他输入。
在我的设备上替换 已写入设备上的其他所有可分配操作都会被清除,涉及每个选项卡。
+ 同时清除我的其他设备 其他已连接设备(每个型号一个)会失去这些操作;没有已保存映射的设备会得到空映射,这在游戏中不会有任何变化,因为游戏不会给未知设备默认绑定。

#绝不会改动的内容

  • 玩家无法分配的操作(菜单导航和少数固定操作)。
  • 键盘和鼠标映射、校准映射、输入行为、控制器分配以及游戏的设置文件。
  • 未连接的设备、同一型号的两个或更多设备、导入时被忽略的设备,以及 JoyPro 用于转发的 vJoy 设备。

#粒度、曲线及其他

  • 粒度:全局,所有飞机共用一套绑定。
  • 轴曲线:不写入(游戏的曲线保存在 Controls.cfg 中)。
  • 键盘和修饰键:不写入。
  • 力反馈、遥测:无。
  • 监视器:监听游戏注册表键的变更通知(监视器)。
  • HUD:HUD 通过进程(Arena)识别该游戏。
技术细节

#Tiny Combat Arena 集成的内部机制

flowchart LR
  A["sharedassets*.assets<br/>(游戏的操作列表,<br/>由 refresh-db 读取)"] --> E["engine tinycombatarena export<br/>(先给控制器映射值<br/>拍一个快照)"]
  P["你的配置文件"] --> E
  E --> T["HKCU / Software / TinyCombat / Arena:<br/>每个设备和选项卡一个映射<br/>(Flight、Weapons、Camera、<br/>View Select、Map UI、System)"]
  T --> G["游戏的 Control Mapper"]
该游戏把控制设置保存在 Windows 注册表中,每个设备和选项卡一个映射。JoyPro 在写入之前会保存一份快照。

代码:engine\Games\TinyCombatArenaIntegration.cs(注册表键、玩家名称、选项卡、目录结构),建立在 engine\Games\RewiredMapIntegration.cs(读取和写入 Rewired 摇杆映射,与 Nuclear Option 共用)之上。

  • 设备:未知设备的 hardwareGuid 为零,hardwareIdentifier = WindowsRawInput + 去掉空白的 HID 产品字符串 + PID + VID。导出时设备必须已连接,因为键是根据它的 HID 产品名和 VID/PID 生成的。
  • 元素:轴 X、Y、Z、Rx、Ry、Rz = 0 到 5,按钮 n = 31 + n,苦力帽 h(从 1 开始)的上 / 右 / 下 / 左 = 160 + 4(h-1) + 0 到 3。映射器在按钮元素上写入 axisRange 1;JoyPro 也写入 1,比较按钮时则忽略它。
  • 命令列表:engine tinycombatarena refresh-db 从第一个能解析的 Arena_Data\sharedassets*.assets 中读取 Rewired InputManager;玩家无法分配的操作会被略过,轴操作会有各极的行,使用游戏中各极的名称(DB\TinyCombatArena\actions.tsv)。
  • 命令:engine tinycombatarena paths、engine tinycombatarena catalog、engine tinycombatarena scan、engine tinycombatarena import、engine tinycombatarena export(简称 engine tca);撤销用 engine backups restore。

#已知限制

  • 游戏的 Rewired 能识别的设备(hardwareGuid 不为零)不在处理范围内。
  • 苦力帽斜向和键盘绑定不会被写入。
  • 测试:engine\tests\smoke\tinycombatarena.ps1;在游戏中运行 tools\e2e\games\TinyCombatArenaSettings.ps1(随机 vJoy 轴上的 Pitch、Roll 和 Yaw、两个按钮和一个苦力帽方向会显示在 Flight、Weapons 和 View Select 选项卡上,并且在游戏退出后导入能把它们全部读回来)。

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