🎯 新模组指南
本指南介绍 Arc Raiders 控制器脚本 Raiders 版相对于标准 RocketAIM FPS 版的新功能。
打开菜单
按住 ADS (L2/LT)，然后按下并松开 MENU/Options。用 上/下（类别）和 A/D-Pad 右（打开模组 / 切换开关）导航。按 B 返回。按 蹲下（圆圈/B） 保存并退出。Raiders 的设置是全局的（不按配置分别保存）。
在主界面，OLED 会在游戏的前一分钟显示一行提示：PlayStation 为 L2+OPTIONS = MENU，Xbox 为 LT+MENU = MENU。60 秒后消失以节省 CPU。
新功能一览
| 模组 | 菜单类别 | 设置 | 默认值 |
|---|---|---|---|
| Snap Hook / Gun Swap | RAIDERS | Snap Mode, Snap Trigger | ON |
| Dont Shoot | RAIDERS | DS Trigger, DS Delay, DS Hold | OFF |
| Easy Roll | RAIDERS | Roll Delay | ON |
| Rapid Light | RAIDERS | Light Speed | ON |
| Drop Shot | RAIDERS | Spam Rate, ADS + Btn Toggle | OFF |
| Aim Slowdown | AIM | Strength, Active When | ON |
另外有变化：Weapon Detection 在 Vibration 引擎上只保留 Per Weapon，提供 8 个武器类别（使用 Arc Raiders 的武器名称），布局 0 改名为 "Arc Raiders"（见下文各节）。
本版本移除的功能（在 Arc Raiders 中没有用处）：Hold Breath、Slide Cancel、Spam 和 Field Mode。VIEW+Y / VIEW+B 强制切换配置的手势也已移除（Per Weapon 中没有 Primary/Secondary 配置，而且 PS5 上 VIEW/Create 会开始录制）。
Snap Hook / Gun Swap
按住 ADS，再按 Snap Trigger 按钮：会运行一个宏。Snap Mode 可设为 "Snap Hook"（抓钩宏）或 "Gun Swap"（收起武器宏）。宏会用 Touchpad（PlayStation）/ View（Xbox） 打开地图，然后发送一组固定的摇杆和 A/B 输入（约 0.5 秒）。运行期间，ADS、扳机和右摇杆 的输入会被忽略。
| 设置 | 范围 | 默认值 | 作用 |
|---|---|---|---|
| Snap Mode | Snap Hook / Gun Swap | Snap Hook | 在抓钩宏和收起武器宏之间选择。 |
| Snap Trigger | X/Square、Y/Triangle、LB/L1、RB/R1、LS/L3、RS/R3 | LS/L3 | 与 ADS 同时按下的按钮。MENU 和 VIEW 不可选（ADS+MENU 会打开设置菜单；VIEW/Create 为保留按键）。不提供方向键：ADS+左/右 会被取消，ADS+上/下 用于调整后坐力。默认 LS/L3，因为在 Arc Raiders 中 RS/R3 是换肩。 |
默认: ON
Dont Shoot
自动执行通讯轮的 "别开枪" 手势。按住 DS Trigger 达 DS Delay 毫秒；随后脚本会按住 方向键上，并将右摇杆向上推 DS Hold 毫秒（带轻微随机偏差），然后等待你松开扳机，之后才会再次开火。
| 设置 | 范围 | 默认值 | 作用 |
|---|---|---|---|
| DS Trigger | X/Square、Y/Triangle、LB/L1、RB/R1、LS/L3、RS/R3、方向键左、方向键下 | X/Square | 按住以启动手势的按钮（不需要 ADS）。方向键上（手势本身会按它）和方向键右（Rapid Light）不可选。按住时该按钮仍会发送到游戏，因此请选择按住时不会造成影响的按钮。 |
| DS Delay | 50-500 毫秒（步长 10） | 150 毫秒 | 宏开始前需要按住扳机的时间。 |
| DS Hold | 50-500 毫秒（步长 10） | 250 毫秒 | 手势持续的时间。 |
默认: OFF
按钮选择。 Drop Shot 的 Snap Trigger、DS Trigger 和 "ADS + Btn Toggle" 三行使用同一份按钮列表。已被其他 Raiders 功能使用的按钮（或在启用 Easy Roll 时布局中的蹲下按钮）仍可选择，但数值下方会显示 USED: SNAP、USED: DONT SHOOT、USED: DROP SHOT 或 USED: EASY ROLL。如果保留该设置，两个宏会同时运行。无法生效的按钮（如上文说明的方向键）在滚动时会被跳过。
Easy Roll
按住 蹲下 按钮：达到 Roll Delay 后，脚本会松开并再次点按它（间隔 40 毫秒，按下 100 毫秒）= 闪避翻滚。每次按住只触发一次；松开 蹲下 可重新启用。
| 设置 | 范围 | 默认值 | 作用 |
|---|---|---|---|
| Roll Delay | 100-300 毫秒（步长 10） | 150 毫秒（+0-20 毫秒随机） | 脚本自动点按 蹲下 进行闪避翻滚之前的延迟。 |
默认: ON
Rapid Light
按住 方向键右 超过 300 毫秒：手电筒会频闪。Light Speed 控制闪烁频率（1-10 = 每秒 4 到 20 次闪烁）。
| 设置 | 范围 | 默认值 | 作用 |
|---|---|---|---|
| Light Speed | 1-10 | 7（14 Hz） | 手电筒频闪效果的速度。 |
默认: ON
Drop Shot
在 Arc Raiders 中，蹲下（B/圆圈）是 切换 操作：点按一次蹲下，再按一次站起，连按两次则是闪避翻滚。Drop Shot 遵循这一行为。Spam Rate 0 时，按下 Fire 脚本会点按 蹲下（200 毫秒），松开 Fire 时再点按一次站起。Spam Rate 1-5 时，在按住 Fire 期间每个周期点按一次，因此你会在蹲下 / 站立 / 蹲下 / 站立 之间交替。脚本会统计你自己的蹲下操作，从而知道你是否蹲着。站起的点按只会在脚本上一次点按至少 500 毫秒之后发送，以避免意外连按（闪避翻滚）。你的 Fire 按键不受影响。Spam Rate 4-5 时点按间隔很近，仍可能触发闪避翻滚；游戏的连按判定窗口没有公开，请在你的手柄上自行调整。
| 设置 | 范围 | 默认值 | 作用 |
|---|---|---|---|
| Spam Rate | 0-5（0 = 每次按下 Fire 一次） | 0 | 0 = 按下 Fire 时蹲下，松开时站起。1-5 = 按住 Fire 期间每约 500-148 毫秒点按一次蹲下（蹲下和站起交替）。 |
| ADS + Btn Toggle | OFF / X/Square、Y/Triangle、LB/L1、RB/R1、LS/L3、RS/R3 | OFF | ADS + 所选按钮可开关 Drop Shot（LED 闪烁；不保存；瞄准时会屏蔽该按钮）。不提供方向键（与 ADS 冲突，已保留）。 |
默认: OFF
Aim Slowdown
对右摇杆输入进行轻微的 "黏滞" 减速（没有圆圈：Rocket AA 的形状仍然是瞄准移动的唯一来源）。在摇杆缓慢移动时生效（完整行程的 3-55%）。在 ADS（或 ADS+Fire） 激活期间，缓慢的摇杆移动会减少 Strength x 3%。快速转向不受影响。只衰减 你的摇杆输入；后坐力补偿和 Rocket AA 形状不受影响。
| 设置 | 范围 | 默认值 | 作用 |
|---|---|---|---|
| Strength | 1-10 | 3（9%） | 减速强度：你的输入减少 Strength x 3%（3% 到 30%）。 |
| Active When | ADS / ADS + FIRE | ADS | 何时应用减速。 |
默认: ON
仅在许可证验证后生效（与 Rocket AA 相同）。
Weapon Detection
在 Vibration（手柄震动）引擎上只保留 Per Weapon。每次加载都会强制启用，因此 Device、Type 和 Hold 行已不存在。子菜单只有一行：
| 行 | 作用 |
|---|---|
| Teach Weapon | 按 A 打开教学向导。 |
你需要自己教会每把武器：开一枪以捕获其震动，选择类别，并可选择名称。之后可以在向导中编辑已教会的槽位（类别、名称、纵向/横向后坐力值）。
Raiders 中没有自动学习。 未知武器不会自行创建槽位（xbox_no_auto_claim，参见 src/README.md）。Arc Raiders 的武器震动峰值几乎相同，如果在第一发时自动创建槽位，就会吞掉所有其他武器。未教会的武器使用基础 Anti-Recoil 设置。教学方法：在菜单中选择 Teach Weapon，或按 ADS + CROUCH + 方向键下 打开槽位选择器，然后在空槽位上按 A。
默认值。 Raiders 以 Peak Window = 900 毫秒 和 Tolerance = 1 启动（FPS 为 400 毫秒和 5）。这两项在 Raiders 菜单中都无法编辑：两行被隐藏，数值固定。
震动相同的武器。 峰值落在 Tolerance 范围内的武器会组成一组。在组内，脚本会选择震动脉冲形状（饱满度和长度，在同一 Peak Window 内测量）与该次射击最接近的成员。可以用 ADS + 方向键左/右 或选择器手动切换：手动选择会保持 30 秒，之后又恢复自动检测。每次射击的形状都会变化，因此自动选择只是估计而非确定。Ferro、Burletta 和 Jupiter 最难区分。
类别（8）: AR、LMG、SMG、PST（手枪）、SNR（狙击枪）、SG（霰弹枪）、BR（战斗步枪）、SPL（特殊）
武器（20）:
- AR: Kettle, Rattler, Arpeggio, Tempest, Bettina
- BR: Ferro, Renegade
- SMG: Stitcher, Bobcat
- SG: Il Toro, Vulcano
- PST: Hairpin, Burletta, Anvil, Venator
- LMG: Torrente
- SNR: Osprey, Jupiter
- SPL: Equalizer, Hullcracker
按键布局
布局 0 现在为 "Arc Raiders"。其他 21 个布局保持不变。
| 功能 | 按键 |
|---|---|
| Fire | RT / R2 |
| ADS | LT / L2 |
| Lethal | LB / L1 |
| Tactical | LB / L1 |
| Jump | A / Cross |
| Crouch | B / Circle |
| Melee | RS / R3 |
| Sprint | LS / L3 |
| Reload | X / Square |
| Weapon Swap | Y / Triangle |
| Ping | RB / R1 |
游戏控制与脚本的影响范围
- 当 ADS 和 Crouch 同时按住时，方向键的四个方向不会发送到游戏。它们用于脚本手势（ADS + Crouch + 方向键：配置锁定、Anti-Recoil 菜单、Rapid Fire、武器覆盖）。在 Arc Raiders 中，方向键上是表情动作，方向键下是近距离一键通话。Crouch 本身仍然正常工作：瞄准时蹲下是正常游戏操作。
- Fast Melee 在所有 Raiders 版本中都已禁用。布局中的 Melee 按键是 RS/R3，但在 Arc Raiders 中 RS 点击是换肩；近战武器在方向键左。
- Arc Raiders 的手柄按键在游戏中是固定的：RT 开火，LT 瞄准，RB 标记，LB 道具，Y 切换武器 / 空手，X 互动 / 装填，B 蹲下（切换）且连按两次 = 闪避翻滚，A 跳跃，LS 点击冲刺（切换），RS 点击换肩，方向键上 表情，方向键右 手电筒，方向键左 近战武器，方向键下 近距离一键通话。
版本
Raiders 仅以 Donator+ 版本 发布：包含所有功能，并需通过许可证（QR）验证。目前没有计划推出其他版本。
状态
实验性功能：Raiders 版本可为 Cronus Zen 编译，但宏的时序、在 Arc Raiders 上基于震动的武器教学（包括最近成员选择）以及新的菜单行 尚未在真实设备上验证。如果发现任何不对劲的地方，请反馈。