Custom Action Framework · 自定义作战框架

适用：CAF V2.3.7 Base ·《七日杀》V3.2 · 作者：猫猫鱼 / Nanami

面向使用 XML 制作武器、技能、Buff 和战斗效果的 MOD 作者。本指南介绍接入方式、关键参数、事件上下文与升级注意事项；完整字段、默认值和别名见配套《CAF V2.3.7 参数字典》。以下能力不要求安装 CAF Affix。

配置入口 · HUB · 开火模块 · 智能武器 · MinEvent · 触发器 · 条件判断 · 伤害反馈 · 旧版迁移 · 资源排错 · 参数字典 · 模板示例

正确名称是 MinEventAction；“MiniEvent”是旧称，不是 XML 类型名。HUB 参数名不能直接当作 MinEventAction 属性，CAF_SW_ 属性也不能放进 HUB 模板代替物品属性。

客户端、主机与专属服务器须安装一致的 CAF 和相关资源。制作依赖 CAF 的 MOD 时，只携带自己的 XML 与资源，并声明 CAF V2.3.7 前置；不要重复携带另一份 CAF DLL。升级先完整移除旧版 CAF。

2.1 模板结构

Config/CAF_Templates.xml 是 CAF 专用配置，不使用 XPath。根节点下直接放 template，template 下直接放 property。模板名称应加自己的 MOD 前缀；重名时后加载者覆盖前者。

2.2 武器动作接入

以下片段用于已有远程武器的 Action0；保留该武器原有的射程、射速、弹匣、动画等原版属性。新建 item 时还需完整的原版武器定义。

路由先查 CAF_Ammo_[当前弹药 item 名]_Template，未设置或为空才查 CAF_Default_Template。专属映射指向不存在的模板时，不会自动改用默认模板。键中的弹药名是 item name，不是显示名或本地化键。路由属性放在武器 Action 中，不能靠模板引用自身，也不能靠配件改写 Snapshot 中同名值来完成模板切换。

2.3 数值公式和覆盖顺序

基础值优先级由低到高：Action 属性 → 所选模板 → 普通配件 → 扩展提供者。普通配件包含功能配件和外观配件；同层多次赋值以后读入的值为准。配件直接属性、针对武器名称的覆盖与通配覆盖都会参与，因此避免用相互冲突的 set 值依赖安装顺序。

支持数值后缀的字段按以下规则求值：

_mult 是实际乘数，1.2 表示乘以 1.2。只有字典标记支持的键接受 _add 和 _mult；未注册键和不允许的后缀不会产生效果。HUB 当前共有 389 个基础键，其中 216 个允许这两个后缀；弹药路由动态键与 CAF_SW_ 不计入此数。

HUB 数值基础值和后缀可写 @CVar名，从当前持有者取值。缺少基础 CVar 时回退字段默认值；缺少后缀 CVar 时忽略该项。HUB 整数求值后向零截断。布尔字段的 CVar 大于 0 视为 true；不要用数值 CVar 拼资源路径、标签列表或模块名称。

CR/DR 的自定义投射物与枪口 AOE 可以同时触发；没有这两类载荷时会回退到原版射线。不要通过旧版 CR_Proj_Ammo、DR_Proj_Ammo 或 LASER_Ammo 筛选弹药，改用 HUB 的弹药模板路由。

投射物的 HitRadius、命中 AOE 与自定义 HitBox 是不同控制面；普通投射物穿透、子弹体分裂和激光表面反弹也不能混用字段。ZoneLifetime 不大于 0 时，不创建对应持续区域。

3.1 智能即时射线

这两个布尔开关不支持 _add/_mult。即时射线的射程、伤害和穿透按原版远程武器路径处理，不使用自定义飞行物的速度、重力和命中伤害字段。智能目标有效时修正瞄准方向；没有有效目标时沿原本瞄准方向射击。

3.2 激光弹射

前三项支持 _add/_mult。所有分叉共用次数上限，主束穿透和延迟反弹产生的弹射起点也共享它；主束自身的穿透、反弹不扣该弹射额度。连续激光每个实际伤害 tick 的初始射线重新取得额度，多条初始射线分别计数。

弹射选择存活、可伤害且敌对的实体，并应用激光目标与排除标签；搜索范围不受 HUD 八个候选的限制。子射线不继续穿透或表面反弹，也不自动追加主束的命中预制体、音效、RayHit 事件、投射物或 Zone。弹射 AOE 不创建持续区域。

在已有 Laser 或 ContinuousLaser 模板中加入：

这组配置最多追加五次命中，每个节点至多分成两路，每跳搜索八米。它不会额外扣除弹药。主束的伤害、光束资源和标签仍由原有 LASER 配置提供。

非空 CAF_SW_VirtualMagCVar 启用虚拟弹匣。锁定使用独立的 CAF_SW_LockEnabled 开关；新版 HUD 与候选扫描还要求武器 Tags 包含 cyber_scope。把此标签追加到原有标签中，不要覆盖武器原有标签集合。

4.1 弹匣与备用能量

弹匣和能量的持久状态随武器保存，CVar 是显示与兼容投影。系统为基名附加武器实例身份；不要自行给同型号武器共用一个最终状态键，也不要把内部 metadata 名当作 XML 配置。全新实例按容量初始化；旧实例迁移会保留其可读状态。

按住射击期间暂停充能。配置了能量池且 ChargeUsesAmmo 为 true 时，没有至少一单位能量就不能继续补弹；未配置能量池时充能不收费。容量、充能时间和延迟等数值支持 @CVar 以及配件 _add/_mult；布尔项使用物品根级 true/false。

4.2 锁定与精确瞄准

普通锁定使用 LockAimPart；满足精准锁定及体力资格时按精准头部目标处理。显示宽限不会让已丢失的目标继续作为本次开火的有效主目标。穿墙候选不等于光束穿墙，最终碰撞仍由武器模块处理。

4.3 威胁、反馈与曲线重试

威胁半径与高度只限制近身预警；正在攻击玩家的敌人可通过紧迫威胁判断进入提示。该感知不使用锁定的视线选项。重试参数不是增加射击次数、弹射次数或命中伤害的开关。

4.4 奔跑、瞄准与旧界面兼容

CAF_SW_RunWhileAiming 与 CAF_SW_NoAimMovePenalty 默认 false，分别允许奔跑时维持瞄准、移除瞄准移动惩罚。CAF_SW_RunAndShoot 是同时开启两者的兼容开关；这些选项不要求虚拟弹匣，但仍受体力、游泳、蹲伏、载具等原版状态约束。

新版主 HUD 的视觉系统不由旧 UIShow、UIColor 或 UIEnergyBarPos 参数控制。这些旧项只在备用 XUi 界面生效，完整列表见字典的兼容章节。CAF_SW_UIColorMarkerNormal、CAF_SW_UIColorMarkerLocked 与 CAF_SW_CurveRetryVisualTime 当前没有有效显示或重试用途，不应作为新版界面调节参数。

4.5 能量罐

消耗品动作使用 ItemActionChargeHeldWeapon, CustomAoeParticleEffect。其 Action 属性 CAF_EnergyAmount 默认 500，表示一次补充量；不使用智能武器的 _add/_mult 公式。目标是当前手持、配置了能量池的武器，补充受上限限制。须显式设置武器的 CAF_SW_EnergyPoolMax 为正值，成功写入后才消耗能量罐。

完整写法示例：

trigger 决定执行时机，action 决定行为。并非每个 CAF 动作都接受原版 target 属性：ConsumeCAFWeaponShockScope 使用原版目标选择，ApplyCAFRobotAura 有自己的目标列表，其余动作按自身规则定位和筛选。不要用一个通用 target 写法套全部动作。

5.1 动态值规则

中文 CVar 名可用，前提是对应实体上确实存在同名变量。不要把 HUB 的乘数语法套给 MinEvent：例如 AOEDamage 的 damage_mult 为增量，实际先算 damage × (1 + damage_mult)。

5.2 AOE、Zone 和投射物的易错点

AOEDamage 仅在最终即时伤害大于 0 或 add_buff 非空时扫描实体，因此只写 force 不会产生即时推力。其 hit_particle 用于附带 Zone 的视觉，需 zone_lifetime 大于 0，并不是每个命中目标各播放一次。武器面板伤害贡献与固定伤害相加；Zone 分支不肢解。

SpawnZone 的 zone_damage 默认 0，zone_lifetime 默认 10 秒。radius 控制判定，particle_radius 控制表现；有粒子不代表伤害大于 0。Zone 的 TickRate 表示间隔秒数，数值越小频率越高。标签和 ignore_self 仍参与目标排除，正向 target_tags 不会绕过排除规则。

CustomProjectile 的 closest_player、attacker 方向要求 monster_mode=true；普通模式按瞄准或朝向发射。monster_mode 默认 false，怪物扫描半径默认 30，默认仅找玩家；direction_mode 的最近玩家扫描仍以玩家集合为范围。普通动作没有可写的 lockAimPart XML 属性，不要与智能武器 CAF_SW_LockAimPart 混淆。

5.3 弹药与状态动作

AddWeaponAmmo 不是凭空造弹，也不是直接增加智能能量。ConsumeWeaponAmmo 的 count 和 reserve 默认都为 1；buff 仅在扣弹成功后添加，result_cvar 先写 0、成功写 1，以下划线开头的结果名被拒绝。

机器人动作要求主机侧、当前归属实例与匹配的机器人事件上下文。ModifyCAFRobotHealth 不能复活，最终生命至少为 1，且不超过机器人原始物品允许的生命上限。

ModifyCAFCombatState 的 consume 删除整个记录，min/max 仅限制 add，ttl 不大于 0 时采用 30 秒默认值，最多 300 秒。ModifyCAFRobotState 的 consume 则按量扣减并保留记录；不要把这两种状态系统当作同一种计数器。

CAF 提供 21 个自定义 trigger。原版 onSelfKilledOther、onSelfPrimaryActionRayHit 等名称仍属于游戏事件；不要因为 CAF 会使用它们就把它们列为 CAF 新增触发器。

6.1 暴击、命中与移动

这一组可从当前武器、配件、成长配置及激活的 Buff 调用。通常 Self 为攻击者或移动玩家，Other 为命中目标；移动事件不提供可任意套用的受击目标。

移动阈值写 value：MoveDistance 默认 0、不触发；Still 默认 1 秒。tick_interval 可用 repeat_interval 或 distance_interval 别名；非正间隔回退阈值。tolerance 默认 0.05，只影响静止判断。

MoveDistance 的 repeat 默认等于 reset；Still 默认等于 !reset_on_move。reset_on_move、reset_on_stance_mismatch 默认 true。movement_tags 与 stance_tags 各按任一标签匹配，required_tags 要求全部匹配。max_stacks 不是有效的移动叠层开关。

6.2 武器战斗与机器人

这十四项应配置在事件武器及其配件上，不应放到普通 Buff 或 progression 后就期待执行。Self 是武器所有者；机器人事件的 Self 也不是机器人实体。ActionStart、ActionResolved 和主人附近攻击等事件不保证 Other 非空。Pulse 的 Other 是机器人当前目标，Others 则是本条脉冲筛出的盟友。

6.3 武器持有者受击

onCAFWeaponOwnerAttacked 表示持有者遭到有效攻击，最终没有掉血也可能触发；onCAFWeaponOwnerDamaged 还要求实际生命值下降。这两项只接受武器和配件配置。Self 是防守方，Other 与 Instigator 是攻击者，ItemValue 是防守方当前武器。

6.4 机器人 Pulse 与 Aura

Pulse 的 interval 默认 1 秒，限制 0.05..3600；range_mode 默认 weapon，fixed 或 value 模式需显式填写 range。ally_count 默认 -1，表示不设最低盟友数。ally_types 默认 allied_robot，可选 owner、allied_robot/robot、drone、companion；exclude_self 默认 true，排除发起脉冲的机器人。

Pulse 的 range 用于盟友筛选和数量门槛；ApplyCAFRobotAura 的实际作用范围独立使用机器人真实最大射程。它们并非同一个半径。显式 Aura ttl/duration 同时控制 Buff 时长和属性层寿命，未显式设置时 Buff 使用自身默认时长。

Combat 触发器会占用 interval、pulse_interval、range_mode、range、ally_count、ally_types、exclude_self 这些属性名，动作不能在同一个节点再独立使用同名参数。Pulse 配合 Aura 时，exclude_self 通过脉冲上下文传递。其他组合若需要动作自己的 range，应拆成不冲突的触发流程。

三者的比较 value 使用数字字面量，不支持继承形式的 value=”@CVar”。operation 可用 EQ、NEQ、LT、LTE、GT、GTE；invert 可反转结果，但状态条件中 consume=true 与 invert=true 组合失败。条件既可放在 effect_group，也可放在 triggered_effect 子节点。

value_field 和 ContextCompare 可读取实际生命伤害、weakpoint/fatal、动作或射线序号、机器人状态、距离、速度、角度与位置分量。字段必须由当前事件提供；并不是每个事件都有每个空间值。完整名称见参数字典。

HUB 的 CAF_CriticalDamage 默认 1.5，是基础倍率；模块和分支的 CriticalDamage 默认 0，是额外增量。概率通常用 0..1，0.25 表示 25%；倍率 1.2 表示 120%。不要把 MinEvent 的 critical_damage 默认 1.5 当作 HUB 分支的默认增量。

VPCriticalChance、VPCriticalDamage 是 CAF 提供的被动效果名，可用于原版效果组；它们与具体开火模块的字段不是同一种 XML 入口。普通伤害、元素和爆炸飘字由实际伤害反馈产生，不需要为每个伤害颜色编造额外字段。

联机伤害、弹射选敌和表现同步由各自执行侧负责。收到表现的一端不应再手动配置一份重复伤害。安装一致版本后，应分别检查命中结果、远程光束或飞行物、飘字和击杀归属；看到粒子不能证明伤害配置正确。

旧参数字典不能只替换封面版本号。以下旧字段不再作为当前模板参数使用：

旧版默认值另有修正：LASER_BounceDelay 为 0.1 秒；CR/DR 的 ChainVelocity 为 15、ChainGravity 为 9.8、ChainScale 为 1。LASER_Rayhit 与 LASER_RayhitCooldown 仅用于瞬时 Laser，ContinuousLaser 使用自己的固定射线事件路径。

资源放在自己的 MOD Resources 目录。路径示例为 #@modfolder:Resources/effects.unity3d?bolt.prefab；在 CAF 模板中，短路径按声明模板的 MOD 解析。跨 MOD 引用时显式写 #@modfolder(MOD名称):，名称使用真实 MOD 标识。示例资源名须替换为自己的资源，不要复制本机绝对路径。

排错顺序：确认游戏与 CAF 版本 → 确认 XML 入口和字段拼写 → 确认模板被找到且模块已选择 → 检查 CVar 持有者及默认值 → 检查目标过滤和事件上下文 → 检查资源 → 分别验证单机、房主、远程客户端和专服行为。

建议先做无特效的固定伤害或即时射线，再加入单发投射物、资源、第二种弹药、分裂与持续区域。每个示例片段都需要放进相应完整的物品或 Buff 定义；引用的 Buff、模板及资源必须由你的 MOD 定义或实际存在。

《CAF V2.3.7 参数字典》统一收录 HUB 的 389 个基础键、四个开火模块、智能武器与兼容界面属性、15 个 MinEventAction 名称、21 个自定义触发器及相关 Requirement。按完整英文标识检索，数值默认与作用条件分别列出。

V2.3.0 的四册 PDF 仅适合历史版本对照；为 V2.3.7 制作新配置时，请使用与本指南同版的字典。

本章提供四种 HUB 模块和十五个 MinEventAction 名称的示例。数字用于演示配置关系，并非平衡推荐；每例可单独采用，不要把所有开火和扣弹效果一次性堆到同一武器上。

HUB 模板写在 Config/CAF_Templates.xml。物品补丁写在 Config/items.xml，用 configs 与 append/set 包装；下方只给 effect_group 的段落，需要放入对应物品的 append 中。两个完整补丁分别示范普通步枪和部署机器人接入方式。

资源说明：example_fx.unity3d、rifle_bolt.prefab、beam.prefab 是本章约定的示例资源名，不是 CAF 自带资源。使用涉及它们的视觉配置时，换成自己 MOD 中真实存在的资源包和预制体；普通即时射线示例不需要这些资源。

12.1 共用接入：把 AK-47 的主射击交给 HUB

保存为自己 MOD 的 Config/items.xml。该补丁针对原版 gunMGT1AK47，保留枪械模型、动画和原版弹药列表，只改主动作类型并增加模板选择。

工作过程：扣动扳机后，HUB 用当前弹药寻找专属映射；本例没有专属映射，因此所有弹种使用 Example_Rifle。下一节创建该模板。切换为后续模块时，把这里的模板名改为对应名称，不要重复追加多个 CAF_Default_Template。

如果需要按弹种切换，可在同一 Action0 中另加下面两项：普通弹使用步枪，穿甲弹使用激光，其余弹种仍走默认模板。两个目标模板必须同时存在。

12.2 CustomRanged：即时射线步枪及飞行物变体

下面是无需额外特效资源的步枪模板，保存到 CAF_Templates.xml。文件中已有 caf_templates 根节点时，只合并 template 子节点。

解释：CR_NativeHitscan 把本次伤害交给原版即时射线路径；间隔 0.15 秒，消费倍率为 1。原版武器与弹药决定射线伤害、射程和穿透，CR_HitDamage 不会替换此模式的射线伤害。若再配置智能锁定属性，合格的当前目标可用于修正射线方向。

要改成有飞行时间的步枪弹，删除上例 CR_NativeHitscan=true 的属性，改为下面这组内容；其他模板项保留。该变体需要自己的 rifle_bolt 预制体。

这时每次生成一个初速 90、无重力、最长存活 3 秒的弹体，使用 25 点固定基础命中伤害；最终伤害仍受目标防御等结算影响。HitRadius 为 0，不附带命中范围伤害。不要保留 true 开关后期待这些投射物字段生效。

12.3 DynamicRanged：越射越快的步枪

将共用补丁的默认模板改为 Example_SpinRifle。此例仍用原版即时射线，因此无需准备自定义弹体。

参数关系：MinDelay 是最高射速对应的短间隔，MaxDelay 是低速时的长间隔，不能把大小关系写反。每次射击推进 0.1 蓄转进度；WindDownTime 控制停火后的降速过程。SpreadMultiplierMax 给满蓄转阶段的散布倍率，1.5 并非额外增加 150%。伤害仍来自原版步枪与所选弹药。

12.4 Laser：脉冲光束与敌人间弹射

选择 Example_PulseLaser，并将 BeamPrefab 换成真实光束资源。这个例子只配置主束伤害和弹射，不附加 AOE 或持续区域。

主束射程 50 米、固定基础伤害 30，方块会参与阻挡。命中后每跳搜索六米内的合格敌人，每个节点至多两路，整条初始射线总共最多追加三次弹射命中；不是每一条分叉再得到三次额度。目标不足或被阻挡时，实际弹射可少于上限。

12.5 ContinuousLaser：按住输出的持续光束

将模板选择改为 Example_Beam。沿用已有枪械的原版弹匣和弹药，先验证持续射击，再按需要接入智能能量系统。

正常连续开火时按 0.2 秒间隔结算，8 是每次基础伤害而非每秒伤害。光束起点跟随枪口，方向按视线更新；停火或弹药不足后结束相应持续表现。不要再加入 CONTLASER_Enable，它不是当前启用入口。

12.6 AOEDamage：每次主动作结束追加范围打击

下面给出完整 items.xml 外壳。它在原版 AK-47 的主动作结束事件上添加一次范围打击；并不要求先把该武器接到 HUB。

on_aim 使本次范围打击按瞄准落点定位，aim_distance 限制瞄准查询距离，radius 是实体范围而非特效大小。示例没有 particle，所以只演示伤害判定；20 点是基础值。触发次数取决于原版主动作结束事件，不应把它等同于每个命中目标一次。

12.7 SpawnZone：在瞄准点留下五秒伤害区

把此 effect_group 放入自己的武器 item，或放进上一例 append 的内部；先单独采用本例。

持续时间、每跳基础伤害、跳间隔分别为 5 秒、8 点、1 秒。zone_id 给同组区域一个明确标识；false 让同冷却组共享目标 Tick 冷却，不表示所有同名区域都只能生成一个。需要可见法阵时加入自己的 particle 资源；不要因为没填粒子就误以为伤害区不会执行。

12.8 CustomProjectile：追加一枚直线技能弹

普通 MinEvent 投射物使用小写属性；它不是 CR_ 前缀模板。下面同样放在武器 effect_group 所在位置。

弹体从可解析的枪口出发，沿瞄准方向飞行；命中使用固定基础伤害 18。未启用 hit event，避免示例额外触发原版 RayHit 链。它是武器主攻击之外的附加弹，不会自动替代原本那发子弹，也不会自动为该技能另扣一次弹药。

12.9 AddWeaponAmmo：爆头后从后备弹药补一发

适用于仍使用原版实体弹匣的远程武器，将效果组追加到该武器 item。

一次符合头部条件的主攻击射线命中，尝试从背包或工具栏的当前弹种中取一发装入弹匣。没有后备弹药或弹匣已满时不增加；这不是无限弹药。多弹丸或穿透武器可能产生多个命中事件，因此不能把一次事件必然当作一整次扣扳机。

12.10 VPCAddWeaponAmmo：兼容名称的补弹写法

保留旧 XML 名称时可使用下面这例；新配置通常直接选择 AddWeaponAmmo。

兼容名执行同一套后备弹药转入弹匣逻辑。本例取消头部条件，在主动作结束时尝试补一发。它与上一例是两种独立示范，不要同时安装后又把两次补弹理解为重复计算错误。

12.11 ConsumeWeaponAmmo：射击前尝试额外扣两发

用于当前手持、事件物品也指向同一实例的远程武器。结果 CVar 留给后续效果判断。

弹匣至少有三发时，额外消耗两发并保留一发给原版射击，成功结果为 1；不足时结果为 0，不执行这次额外扣弹。这个动作本身不取消原版开火，因此不能仅靠它保证“没交齐三发就绝对不开枪”。它修改实体弹匣，不是智能能量池的扣费接口。

12.12 VPCLoseEnemyTargets：清除附近敌人的追踪

采用原版触发器，避免 Combat 事件占用 range 属性。

主机执行时，清理十五米内正在以使用者为目标的敌人相关追踪状态；玩家随后获得三秒的侦测缩放 0.25。它不是无敌或永久隐身，后续攻击和其他感知仍可能重新建立仇恨。写到普通远程客户端单独执行的事件上，不会绕过此动作的主机权限条件。

12.13 ModifyCAFRobotState：炮塔每五次有效命中尝试修复

这是机器人完整接入外壳。effect_group 必须放在用于部署炮塔的原始物品 gunBotT2JunkTurret 上，而不是主人当时手持的步枪上。

先累加当前部署实例的命中计数，再检查是否达到五次。条件满足时扣除五点状态并尝试修复十点生命；状态超过十秒未刷新会过期。此处按有效目标命中计数，不能把多目标的一次机器人动作固定视为一次。满血时仍可消费计数，实际回复受生命上限限制。

12.14 ModifyCAFRobotStat：部署期间维持伤害倍率

此组同样追加到炮塔原始物品；使用 Pulse 提前维持属性，影响之后的伤害读取。

每秒给当前机器人刷新一个 1.2 倍伤害层，层数上限为一、有效期为 1.5 秒，因此不会每秒无上限相乘。key 标识该属性层，不与另一个增益共用名字；停止刷新后会过期。这里不是永久改写原始物品属性。

12.15 ModifyCAFRobotHealth：机器人击杀后修复

如果只想做简单击杀回复，可以独立使用这组，不必安装前面的计数示例。

归属机器人确认击杀后，修复的是本次事件里的机器人，结果 CVar 写到主人身上。最终生命不超过原始物品允许上限，也不能用此动作复活死亡机器人；result_cvar 是操作后生命值，不是成功布尔值。

12.16 ConsumeOwnerWeaponAmmo：用主人弹药加强机器人动作

放入部署物品的效果组。使用同一次动作开始事件，先扣主人当前手持远程武器的实体弹药，成功后才允许增伤请求执行。

机器人开始动作时，尝试从主人手持武器扣一发并留下至少一发；成功后，为本次动作的第一个有效命中请求 1.5 倍实体伤害。扣的是主人武器，不是炮塔自身弹药；手持非远程物品或余额不足会失败。它是提前付费，动作最终没有命中也不会返弹。结果键仅用于这段相邻动作，不要让其他效果写入同名 CVar，也不要改成两个各自节流的 Pulse 来假定扣费与收益必然同步。

12.17 ModifyCAFRobotAction：加强机器人当前这一击

此例可放在机器人锤 gunBotT1JunkSledge 的原始物品上，使用动作开始事件。

在当前机器人动作的第一个有效命中上使用 1.3 倍实体伤害和 1.5 倍推力请求。它需要动作开始时仍开放的修改上下文；改写成 ActionResolved 属于结算结束以后，不能据此倒改已完成的伤害。first_valid_hit_only 防止同动作多个有效命中全部套用。

12.18 ApplyCAFRobotAura：给附近友方机器人提供增伤

以炮塔 Pulse 驱动，目标只选 allied_robot，不需要另外定义 Buff 就能演示属性光环。

每秒为发起者真实最大射程内的合格友方机器人刷新 1.1 倍伤害层，持续 1.5 秒，排除发起炮塔自身。target 是 Aura 的目标词汇，不是普通 target=”other”。本例没有填写 range，避免误把 Pulse 的盟友筛选半径当成光环半径；没有合格盟友时不会凭空产生收益。

12.19 ModifyCAFCombatState：五次直接命中尝试补三发

追加到普通实体弹匣武器的 item。它使用武器战斗状态，不与前面的机器人实例计数共用存储。

造成正生命伤害的直接命中增加计数，四秒未刷新就过期；达到五次后消费整条记录，尝试从后备弹药装入三发。缺少后备弹药或弹匣已满时，不保证得到三发，状态条件仍已经消费。scope=weapon 按武器隔离，改为 target 或 weapon_target 则需要同一目标的状态。

12.20 ConsumeCAFWeaponShockScope：消费本武器刚结算的电击

下面的效果组用于原版电击棒 meleeWpnBatonT2StunBaton。必须先按电击棒正常玩法蓄满电，并让一次有效电击被 CAF 归因；它不是给任意武器直接清除任意电击 Buff 的通用动作。

该事件里 Other 是已归因的受电击目标。当前武器与动作拥有可消费的独占电击作用域、且目标仍有 buffShocked 时，动作消费该记录并移除 Buff。因此安装本例会主动结束相应电击状态；它演示消费语义，不是增加电击持续时间。若电击来源无法独占归因，动作拒绝消费。

12.21 组合前的核对

先选一个 HUB 主模板，再按需要添加少量独立 MinEvent。HUB 的命中载荷与 MinEvent 如果都配置了相同伤害，两边会分别执行。机器人系列必须从对应部署事件进入；普通原版射击事件不能凭空提供机器人上下文。

凡是例子通过 result_cvar 或状态条件串联动作，都按给出的顺序放在同一效果组。结果变量不是跨机器人持久钱包，也不应拿延迟事件复用旧值。资源、武器名、后备弹药和事件条件应逐项对照自己的 MOD，最后分别确认单机、房主与远程客户端的实际表现。