连击追踪与触发器

付费模块

连击追踪、死亡缓冲、按键触发器与状态/控制器触发器是 CombatEffect 模块的高级战斗特效子系统。它们在基础击杀/攻击特效之上，提供连击里程碑、死亡可视化缓冲、按键驱动特效和 Chronos 状态联动等能力。所有子系统可独立开关，互不依赖。

子系统概览

四个子系统均默认禁用，需在 config.yml 中显式启用。启用时需确保对应依赖已安装，否则自动降级或保持禁用。

连击追踪

追踪玩家连续攻击次数，达到条件时触发特效包，并可实时同步连击数到客户端变量。

连击来源

连击来源通过 combo-tracker.source 配置，支持三种模式：

Chronos 状态组过滤

Chronos 来源模式下，仅指定状态组的状态进入才计为连击一击：

超时重置

超时后连击数重置为 0，同时同步客户端变量为 0。

目标锁定模式

per-target 仅在 Bukkit 来源模式下有效（Chronos 来源无目标概念）。

客户端变量同步

开启后可在 UI 中引用实时连击数：

# UI 中引用连击数变量
连击数字:
  type: Text
  attribute:
    texts: "~&f{server.combo_count}"
    visible: "server.combo_count > 0 || var.combo_show"

推荐方式：开启 sync-variable 后用 {server.combo_count} 显示实时数字，特效包仅用于里程碑动画（如 5 连击闪光、10 连击特效）。

连击包触发条件

trigger: combo 的包定义按以下条件触发：

连击特效仅发给攻击者自己。

死亡缓冲

在玩家受到致死伤害时拦截，给玩家一个可视化缓冲期后再真正死亡。

行为流程

1. 检测伤害是否致死，是则取消伤害并进入缓冲状态
2. 冻结玩家（无敌、无法移动、血量保留微量）
3. 应用视觉效果（Shader、第三人称、预设相机、Chronos 状态）
4. 触发 trigger: death 的包定义
5. 缓冲时长结束后执行真正死亡

缓冲期间玩家受到的一切伤害都会被取消。玩家退出时自动清理缓冲状态。

视觉效果

ArcartX 未安装时视觉效果不应用，但不影响缓冲流程。

缓冲配置

死亡包接收者

环境死亡（摔落、岩浆等）无击杀者，仅 target 接收者会收到死亡缓冲包。

按键触发器

监听 ArcartX 客户端按键事件，匹配 trigger: keybind 的包定义并发送特效。需要 ArcartX 安装且 keybind-trigger.enabled=true。

按键类型

按键组仅有按下事件，key-action: release 对按键组类型无效。

匹配条件

按键触发示例

# 按下 attack_* 按键时触发技能爆发特效
skill-burst:
  enabled: true
  trigger: keybind
  ui-id: "AXS:combat_kill_effect"
  packet-handler: "attack"
  recipients:
    - attacker
  conditions:
    key-name: "attack_*"    # 匹配 attack_1, attack_2, attack_combo 等
    key-action: "press"     # 仅按下时触发
    key-type: "client"      # 仅客户端按键
  cooldown: 1000            # 1 秒冷却
  pack:
    player: "{player}"
    key_name: "{key_name}"

按键触发器的接收者始终为触发的玩家自身。变量替换支持 {player} 和 {key_name}。

状态/控制器触发器

监听 Chronos 状态进入/离开与控制器切换事件，匹配 trigger: state 和 trigger: controller 的包定义。需要 Chronos 安装且 state-trigger.enabled=true。

状态触发

控制器触发

状态/控制器触发示例

# 进入 "狂暴" 状态时触发特效
berserk-effect:
  enabled: true
  trigger: state
  ui-id: "AXS:combat_kill_effect"
  packet-handler: "attack"
  recipients:
    - attacker
  conditions:
    state-id: "狂暴"
    state-action: "enter"
  pack:
    player: "{player}"
    state_id: "{state_id}"
 
# 切换到 "弓箭手" 控制器时触发
archer-mode:
  enabled: true
  trigger: controller
  ui-id: "AXS:combat_kill_effect"
  packet-handler: "attack"
  recipients:
    - attacker
  conditions:
    controller-id: "弓箭手"
  pack:
    player: "{player}"
    controller_id: "{controller_id}"

状态触发器的接收者始终为触发的玩家自身。变量替换支持 {player}、{state_id} 和 {controller_id}。

冷却

连击追踪的包分发不使用冷却（由 combo-min / combo-max / combo-repeat 条件控制频率）。按键触发器和状态/控制器触发器均支持独立冷却，与包定义系统冷却行为一致。参考 包定义系统。

相关文档

• 概览 — 模块功能与战斗特效机制
• 配置 — 完整配置字段表与示例
• 命令与占位符 — 命令与权限
• 联动 — EventBus 事件与跨模块联动
• 包定义系统 — 包定义系统详解
• 伤害飘字系统 — 伤害/治疗飘字详解
• 条件系统 — 统一条件系统配置指南