指南：Xbox 武器检测，Per Weapon 模式
本指南面向从未接触过武器检测的用户。它会逐步讲解如何开启、它在屏幕上的表现，以及在每种情况下该怎么做。
本文档只涵盖 Xbox 手柄 + "Per Weapon" 模式这一组合。如果你使用 PS5 手柄，或者更喜欢 "Per Profile" 模式，每种情况都有单独的指南。
按钮采用 Xbox 风格命名：RT=开火，LT=瞄准，A=确认，B=返回/蹲下，Y=切换武器，X=换弹，Menu=打开 Cronus 菜单。
⚠️ 开始之前请阅读
在 PS5 上，检测读取的是自适应扳机的阻力，这是 PS5 独有的精确传感器。Xbox 手柄没有这个传感器。 脚本改为使用手柄的震动，这是一个精度较低的信号，其实际表现仍在确认中。
与 PS5 的重要区别： 在 Xbox 上没有"开箱即用"的自动识别，也就是没有已校准武器的表。每把武器都必须由你亲自教会，通过 "Teach Weapon" 向导（第 6 节）完成，Per Weapon 模式才能对其做任何处理。否则，你的武器只会使用当前配置文件的手动设置，就像 Weapon Detect 被关闭一样。
1. 它的作用
武器一旦被教会，就会获得它自己的防后坐力（Anti-Recoil）设置，与你的 2 个配置文件分开保存，这与 PS5 完全一样。对于这把武器，不再存在可能被混淆的配置文件。
2. 开始之前
- Xbox 手柄，且震动已开启（主机/PC 与游戏中都要开）。
3. 开启 Per Weapon 模式
步骤 1 — 打开 Cronus 菜单。
步骤 2 — 进入 COMBAT 类别 → WEAPON DETECT 行 → 如需启用，按 A（Right/Dpad），然后再按一次 A 进入其设置。
- Device：Xbox，这里最重要的设置。
向下移动（Down）：
- Type：Per Weapon（Xbox 上两个可选项中的第 2 个）。
切换到 Per Weapon 后，下方会出现两个新行：Teach Weapon 和 Tolerance，在另一种模式中是隐藏的。详见第 6 和第 7 节。
步骤 3 — 多次按 B 退出。自动保存。
4. 在未教任何武器时会发生什么
在你教会任何武器之前，屏幕上不会显示武器：
这是正常的：在此期间，你的武器会使用当前配置文件的手动设置。没有任何故障，只是还没有更精确的内容可显示。
自动学习（FPS 版）。 当一次 Fire 按压产生的震动与任何已教会的槽位都不匹配时，脚本会自动创建一个槽位（"Custom N"，类别暂定为 AR），该武器接下来的几发会使用它。之后你可以更改其类别并进行微调，或者正式教会这把武器（第 6 节）。Raiders 版关闭了此功能：其武器的震动几乎相同，一个自动槽位就会吞掉所有武器。在那里，未教会的武器会保留配置文件的手动设置。
5. 教会武器之后
教会一把武器（第 6 节）之后，开火时它会与对应的槽位关联：
开火时的实时调整：
| 手势 | 效果 |
|---|---|
| LT + Up (Dpad) | 增加当前武器的垂直值 |
| LT + Down (Dpad) | 减少垂直值 |
这项调整对这把确切的武器是永久的，下次仍会记住。
如果两把已教会的武器太相似： 震动峰值落在 Tolerance 容差范围内的武器会组成一个组。在组内，脚本会自行选择那个震动形态（脉冲有多饱满、持续多久）与这一发最接近的成员。形态每发都会有些许变化，因此这只是一个最佳猜测。LT + Left / Right 可无需菜单切换到另一个候选项；你的选择会保留 30 秒，之后自动选择重新生效。
要手动强制指定某把武器，或修正错误的检测： LT + B + Down (Dpad) 会打开你所有已教会槽位的完整列表。
6. 教会武器（Teach Weapon）：在 Xbox 上必需
你拥有 48 个个人槽位（比 PS5 的 64 个略少）。
如何逐步登记一把武器：
步骤 1 — 菜单 → COMBAT → WEAPON DETECT → A。你会进入 Type 行。
步骤 2 — 向下滚动到 Teach Weapon（仅在 Per Weapon 模式下可见），然后按 A。
步骤 3 — 选择一个槽位（Up/Down 后按 A）。每行显示 Empty 或已保存的类别。对于已占用的槽位，A 会先显示其内容；再按一次 A 可重新登记；B 则返回且不做任何更改。
步骤 4 — 在游戏中用这把武器开火。 屏幕会实时显示测得的震动数值（两个值，分别对应手柄的两个马达；比读取四个值的 PS5 少）。开 2–3 枪：每次都应得到相同的数字。如果每一枪的数字都在变化，按 B 取消：说明读数不可靠。
步骤 5 — 数值稳定后 → 按 A 确认。
步骤 6 — 选择武器类别（AR、LMG、SMG、Pistol、Sniper、Shotgun）→ A。
步骤 7 — 选择名称（可选），或保留 No Name 以维持 Custom N。按 A 确认。
自动返回 WEAPON DETECT 菜单。
如果该特征已存在于你的另一个槽位中，会出现警告画面（SAME AS SLOT）：按 A 仍然保存，按 B 取消。（与 PS5 不同，Xbox 没有内置表可供比较，因此不会出现 "SAME AS BUILT-IN" 警告。）
需要知道的事：
- 开火期间（步骤 4），手柄不会被锁定：只有在此画面打开时，A 和 B 会被屏蔽。
- 关机并重新刷写后，你的槽位仍会保留。
- 如果还想在电脑上保留副本，可在 Zen Studio Live 中导出你的 BVARs 和 SPVARs。
- 在槽位列表或详情画面中按 X (Square) 可删除一个槽位（需确认：A 确认，B 取消）。
7. Tolerance 设置：Xbox 专属
PS5 上没有这一行。武器的震动每发可能会有轻微变化（与非常稳定的 PS5 扳机不同）。Tolerance（1 到 20）设定了一个读数仍被识别为"同一把已教会武器"时所允许的误差范围。
如果不确定，宁可选择较低（更严格）的值，也不要选较高的。 两种可能的错误并不等价：
- 过严：武器只是不被识别，回退到当前配置文件的手动设置。无害，只是没那么方便。
- 过松：脚本可能会自信地识别为错误的已教会武器，并应用不匹配的防后坐力。这更像是程序故障而非设置没调好，而且更难发现。
只有当一把教得很好的武器始终无法被可靠识别时，才逐步提高该值。
Peak Window (ms)：Tolerance 下方的一行（100 到 1000，默认 400）。一发射击的震动是弱、强、再弱，因此脚本会在按下 Fire 后的这个窗口内保留两个马达的峰值。如果你武器的强力部分出现得较晚，就调高它；如果你经常快速连点 Fire，就调低它。更改后请重新教会你的武器，因为已保存的数值是用旧窗口测量的。新武器的槽位会在窗口结束后（第一次按下后约 0.4 秒）生效。
8. Per Weapon 中的防后坐力开关
与 PS5 相同：在 Per Weapon 中，你所有个人武器只有一个开关（AIM → ANTI RECOIL），而不是每个配置文件一个。
9. 临时回退到手动配置文件（应急通道）
按住 View + Y（或 + B）1 秒，会强制切换到 Primary（或 Secondary）配置文件，并丢弃当前激活的自定义武器：防后坐力回退到该配置文件的手动预设。
| 手势 | 在 Per Weapon 中的效果 |
|---|---|
| View + Y，1 秒 | 回退到 Primary 配置文件的手动预设，忽略当前武器 |
| View + B，1 秒 | 对 Secondary 配置文件执行相同操作 |
如果一把已教会的武器在交战中调得不好，这可以作为安全网。
10. 与 Weapon Detect 相关的两个不太显眼的设置
- FIELD MODE（UTILITY 类别）：如果你的游戏将武器切换键（Y）的长按用于其他操作（例如大逃杀中的护甲板），请开启此项。
- RAPID FIRE → Only Gun（COMBAT 类别）：如果当前已教会的武器被归类为 Pistol，则自动调整射速。在 Xbox 和 PS5 上均可使用。
11. 快捷键速查（Per Weapon，Xbox）
| 手势 | 效果 |
|---|---|
| LT + Up / Down | 实时调整当前武器的垂直值 |
| LT + Left / Right | 切换到组中的下一个/上一个武器（保留 30 秒） |
| LT + B + Down | 打开你所有已教会槽位的完整列表 |
| X，在列表中 | 删除该槽位（需确认） |
12. 故障排除
即使教会了武器，也从未有任何反应：
- 震动是否已开启（主机/PC 与游戏中都要开）？
- Device = Xbox？Type = Per Weapon？
- 重新教会该武器（第 6 节），并确认步骤 4 中显示的数值在 2–3 发之间是稳定的，而不是每次都不同。
- 是否更改过 Peak Window？之前教会的所有槽位都必须重新教会。
已教会的武器有时会应用另一把已教会武器的设置：
- 降低 Tolerance（第 7 节）：这是容差过松、混淆了两个相近特征的典型迹象。
你已经分不清哪个槽位对应哪把武器：
- LT + B + Down 会显示完整列表，包含每个已占用槽位的类别和名称。