游戏 AI / 系统课时
冷却条件怎样阻止重复攻击
冷却条件怎样阻止重复攻击
攻击动作结束并不代表下一帧就应该再次攻击。若行为树每次 Tick 都重新尝试高优先级攻击分支,就可能连续触发技能。本节用 Cooldown Decorator 把“动作完成”和“再次允许进入”拆开,形成清晰的时间窗。
学习目标
- 理解冷却为什么应控制攻击分支入口,而不是塞进攻击动作内部
- 能区分“正在攻击”“攻击已完成”“冷却已结束”三个时刻
- 能实现并验证一次攻击结束后的重复触发保护
冷却检查放在攻击分支入口
典型攻击分支可以由目标有效、距离满足、冷却通过和攻击动作组成。冷却是“是否允许再次进入攻击分支”的条件,因此适合由 Decorator 或条件节点承担,而不是让 AttackAction 自己等待若干秒后才返回。

如果把冷却写成攻击动作内部的“等待”,攻击节点会长时间保持 RUNNING,高优先级分支可能一直占住 Selector,导致 NPC 在冷却期间无法追击正在远离的目标。把冷却移到分支入口后,攻击结束即可释放分支,冷却期间由 Selector 继续尝试追击或其他行为。
用时间戳表达下一次可攻击时刻
冷却逻辑最稳定的表示方式,是记录 next_ready_time。当一次攻击真正消耗成功后,设置 next_ready_time = current_time + cooldown。之后只要当前时间小于 next_ready_time,攻击分支就不能重新进入。这样无需每帧递减计时器,也不会因 Tick 频率变化而改变冷却时长。
需要特别确定“从什么时候开始计冷却”。常见选择有两种:
- 从攻击开始时计时:适合攻击前摇和后摇本身就算在冷却内的技能。
- 从攻击完成时计时:适合明确要求动作结束后再等待一段时间的技能。
同一个项目应给同类技能保持一致语义,否则设计参数会很难调。
实现一个可重复验证的 Cooldown Decorator
下面的示例把时间作为参数传入,避免依赖真实系统时钟,因此输出完全可预测。只有 consume() 被调用时才真正开始冷却,单纯检查条件不会修改状态。
from dataclasses import dataclass
@dataclass
class CooldownDecorator:
cooldown_seconds: float
next_ready_time: float = 0.0
def is_ready(self, now: float) -> bool:
return now >= self.next_ready_time
def consume(self, now: float) -> None:
# 只有攻击确认执行后才推进下一次可用时间。
self.next_ready_time = now + self.cooldown_seconds
def main() -> None:
cooldown = CooldownDecorator(cooldown_seconds=2.0)
checkpoints = [0.0, 0.5, 2.0, 2.1]
cooldown.consume(0.0)
for now in checkpoints:
print(f'time={now:.1f}, attack_ready={cooldown.is_ready(now)}')
if __name__ == '__main__':
main()预期输出:
time=0.0, attack_ready=False
time=0.5, attack_ready=False
time=2.0, attack_ready=True
time=2.1, attack_ready=True如果攻击在 0.0 秒成功消耗,2 秒冷却会持续到 2.0 秒。边界上使用 >=,表示到达该时间点就重新可用。
防止重复触发要守住两个边界
第一,不要在条件检查时启动冷却。行为树可能多次评估某个分支,如果每次 is_ready() 都修改时间,冷却会被不断向后推,技能可能永远无法释放。冷却只能在攻击真正被接受或消耗资源后更新。
第二,要明确攻击动作是否可能跨多个 Tick 返回 RUNNING。在动作尚未结束时,应由当前运行节点保持控制,不能因为 Cooldown Decorator 下一帧变成“不满足”就把自己的攻击误打断。若框架支持动态观察 Decorator,需要把冷却条件配置为“阻止重新进入”,而不是“攻击开始后立即中止当前子树”。
当 Cooldown Decorator 只负责入口资格,AttackAction 只负责一次攻击生命周期,Selector 才能在冷却期间自然切回追击或巡逻,同时又保证冷却结束后攻击分支重新获得竞争资格。