AIO 催泪枪

集成催泪喷射、指向、扳机、命中和弹药状态控制的 AIO 外设资源。

资源文件

项目	内容
分类	武器与喷射外设
最新资源	外设-AIO催泪枪v2.0.7.xobj
原始说明	外设-AIO催泪枪_文档.json
更新记录	更新记录.md
来源目录	通用外设/外设资源/外设-AIO催泪枪

使用前提

• 已将 外设-AIO催泪枪v2.0.7.xobj 导入课程工程。
• 已将 AIO 催泪枪绑定到实际持枪的参训人员，并准备可被指向和命中的目标实体。
• 已确定横向FOV、垂直FOV和深度的识别范围，并根据课程规则确定初始子弹数、弹匣数、弹匣容量和上膛状态。
• 使用模拟操作时，应确认换弹夹键和扳机键未与课程快捷键冲突；接入真枪时应避免模拟输入重复触发。

参数说明

属性栏提供武器面板、模拟输入、识别范围和快捷键配置。

参数	作用	推荐配置	注意事项
是否打开武器状态面板	控制是否显示武器状态信息。	调试时开启；正式课程按界面需求设置。	面板可能占用画面空间，应避免遮挡课程中的重要信息。
是否在试玩和实训端模拟该武器	允许通过键盘、鼠标模拟催泪枪操作。	无实体设备调试时开启；使用真实设备时按需关闭。	同时启用模拟输入和真实设备输入时，注意避免同一操作重复触发。
横向FOV	设置识别区域的横向范围。	默认 2，根据实际识别范围调整。	图片未标明单位，应通过试玩确认边界。
垂直FOV	设置识别区域的垂直范围。	默认 2，根据实际识别范围调整。	图片未标明单位，应与横向FOV配合调试。
深度	设置识别区域的纵深范围。	默认 3，根据使用距离调整。	数值过小可能无法识别，过大可能扩大误识别范围。
是否打开快捷键面板	控制是否显示模拟操作快捷键。	调试时开启，正式训练时按需关闭。	仅影响快捷键提示面板，不替代设备绑定。
AIO催泪枪换弹夹	设置模拟换弹夹操作的按键。	默认 F1。	避免与课程中的其他快捷键冲突。
AIO催泪枪扳机	设置模拟扣动扳机的按键。	默认 Mouse0。	使用鼠标左键操作时，注意避免与编辑或交互操作冲突。

监听事件

事件	触发条件	典型用途
指向并按下	指定的参训人员使用催泪器指向任意实体并按下扳机时触发。	判断外设瞄准目标或进入操作条件。
指向	指定的参训人员使用催泪器指向任意实体时触发。	判断外设瞄准目标或进入操作条件。
*被命中	任意实体被当前资源开火后生成的特效粒子碰撞到时触发。	判断喷射或攻击是否作用到目标实体。
*按下扳机	指定的参训人员按下扳机时触发。	触发操作计分、提示或后续课程逻辑。
*换弹夹	指定的参训人员换弹夹时触发。	连接课程中的判断、提示、评分或流程控制。

可执行行为

行为	效果	常见调用时机
设置武器内子弹数为	设置指定参训实体武器的子弹数	初始化武器、补充弹药或切换武器状态时。
设置剩余弹匣数为	设置指定参训实体武器的剩余弹夹数	初始化武器、补充弹药或切换武器状态时。
设置单个弹匣容量为	设置指定参训实体武器的单个弹匣容量	初始化武器、补充弹药或切换武器状态时。
设置上膛状态	设置指定参训实体武器的上膛状态	初始化武器、补充弹药或切换武器状态时。

使用步骤

1. 导入资源并将 AIO 催泪枪绑定到对应参训人员。
2. 根据训练距离调整横向FOV、垂直FOV和深度；需要键鼠调试时配置换弹夹键和扳机键。
3. 在课程初始化阶段调用设置子弹数、剩余弹匣数、弹匣容量和上膛状态的行为。
4. 按课程需要监听“指向”“指向并按下”“按下扳机”“换弹夹”或“被命中”，并填写参训人员和目标实体。
5. 分别测试只指向、扣动扳机、命中特效粒子和换弹流程，确认每个事件只触发一次。

常见问题

问题	建议
指向目标时没有触发事件。	检查事件中的参训人员和目标实体，并逐步增大横向FOV、垂直FOV或深度后重试。
扣动扳机后目标没有触发“被命中”。	确认使用的是“被命中”事件，并检查目标是否位于催泪特效粒子的运动路径上。
子弹数、弹匣数或上膛状态不正确。	检查初始化行为的执行顺序和参数，确认没有其他逻辑在训练开始后再次覆盖武器状态。
一次操作触发两次。	检查是否同时启用了模拟输入和真实设备输入，以及同一事件是否被重复连接。