游戏 AI / 系统课时
召唤阶段怎样避免重复生成
召唤阶段怎样避免重复生成
召唤阶段常见的问题不是“怎么生成单位”,而是同一个阶段被重复进入、同一个事件被重复消费,或者生成失败后状态永久卡住。解决办法是把阶段事件、生成批次和当前生成状态分开记录,让每次召唤都有唯一依据和明确结束条件。
学习目标
- 用阶段事件标记保证一次召唤只触发一次
- 区分准备中、生成中和已完成状态,避免并发重复生成
- 在生成失败或战斗重置时正确恢复召唤状态
先区分阶段进入和阶段更新
召唤阶段通常会持续多个战斗 Tick,但“进入召唤阶段”只应该发生一次。不要在每个 Tick 里直接判断 phase == SUMMON 就创建单位,否则只要阶段持续五秒,就可能连续触发几十次生成。
更稳妥的设计是产生一个一次性的阶段事件,例如 summon_phase_entered,事件带有唯一的 eventId。阶段状态负责表示“当前在哪”,事件标记负责表示“这次进入是否已经执行过”。两者职责不同,不能只靠一个布尔值覆盖所有场景。

例如,一个阶段事件可以生成 spawnBatchId=42 的召唤批次。所有由该批次产生的单位都记录同一个批次标识,后续清场和恢复逻辑都可以按批次定位,而不是依赖“场上大概有几个召唤物”这种脆弱条件。
用状态与事件双重约束
推荐至少维护三个状态:NOT_STARTED、SPAWNING、COMPLETED。收到新的阶段进入事件时,只有 NOT_STARTED 能进入 SPAWNING。进入 SPAWNING 后即使重复收到相同事件,也必须拒绝再次创建;只有当前批次明确完成后才进入 COMPLETED。
下面的片段示例展示最小幂等保护。真实项目中事件标记通常会放在 Boss 状态、战斗事件存储或权威服务端,而不是依赖客户端本地变量。
from dataclasses import dataclass, field
@dataclass
class SummonController:
last_event_id: str | None = None
state: str = "NOT_STARTED"
spawn_batch_id: int = 0
spawned_count: int = 0
expected_count: int = 0
def enter_phase(self, event_id: str, expected_count: int) -> None:
# 相同事件不能重复创建新批次。
if self.last_event_id == event_id:
print("duplicate event ignored")
return
if self.state in ("SPAWNING", "COMPLETED"):
print("summon already handled")
return
self.last_event_id = event_id
self.expected_count = expected_count
self.spawn_batch_id += 1
self.spawned_count = 0
self.state = "SPAWNING"
for _ in range(expected_count):
self.spawned_count += 1
if self.spawned_count == self.expected_count:
self.state = "COMPLETED"
print(f"spawn batch {self.spawn_batch_id} completed")
controller = SummonController()
controller.enter_phase("evt-204", expected_count=3)
controller.enter_phase("evt-204", expected_count=3)
print(controller.state, controller.spawned_count)预期结果
spawn batch 1 completed
duplicate event ignored
COMPLETED 3这个例子同时解决了两个问题:同一个 eventId 不会重复消费,COMPLETED 状态也不会因为重复 Tick 再次创建批次。真实生成流程还应把每个生成单位与 spawn_batch_id 关联,方便后续清场和诊断。
不要把“清场”当成生成完成
生成阶段结束后,Boss 可能仍然需要知道这一批召唤物是否存在。COMPLETED 应表示“本批次生成动作已完成”,而不是“所有召唤物已经死亡”。这样可以继续使用 spawn_batch_id 跟踪战斗中的存活数量,并在需要清场时精准删除对应批次。
例如,Boss 转入下一阶段时,可以先记录当前批次,再执行按批次清理。不要直接执行“删除全部召唤物”,否则其他阶段创建的受控单位也可能被误删。清理成功后再写入新的阶段状态,形成明确的状态边界。
处理失败与重试
重复生成通常来自失败恢复逻辑:第一次生成已经成功了一部分,但状态没有落盘,重试又从头创建。解决办法是把生成批次写成可查询状态,并记录每次已经完成的子项。重试时先读取批次状态,只补齐缺失部分,而不是重新创建整批单位。
还要避免用“场上数量小于目标数量”作为唯一重试条件。战斗中召唤物可能被玩家击杀,这个数量变化与“生成是否完成”不是一回事。判断生成完成应依赖批次状态;判断战斗目标是否满足,则读取独立的存活状态。
让阶段推进具备幂等边界
一个可靠的召唤阶段至少要能回答四个问题:这次进入是谁触发的、是否已经处理、当前生成哪一批、这一批是否完整结束。当 eventId 控制事件幂等、spawnBatchId 控制批次归属、state 控制生命周期后,重复 Tick、重复消息和部分失败都能落到可预期的处理路径。
最终不要用“现在是不是召唤阶段”直接驱动创建动作,而应使用“新的阶段事件 + 尚未处理的生成状态”作为触发条件。这样即使战斗循环重复运行、事件重投或服务恢复,也只会补齐应有的召唤,而不会制造越来越多的重复单位。