游戏 AI / 系统课时
战斗重置时哪些状态必须清空
战斗重置时哪些状态必须清空
重开战斗、读取存档或重新生成 Boss 时,最容易遗漏的是运行时状态。合理区分持久数据、阶段状态与动作状态,并按顺序复位,才能避免上一场战斗的目标、计时器或冷却污染下一场。
学习目标
- 区分应该保留的数据与必须清空的战斗运行时数据
- 设计可重复执行的 Boss 战斗重置流程
- 验证重置后阶段、目标、动作和计时器都回到确定状态
先划分哪些状态属于战斗运行时
战斗重置的关键不是“把所有字段设成默认值”,而是先定义生命周期。角色等级、配置表、掉落规则等通常属于静态或持久数据,不应随战斗重置;当前阶段、目标、技能冷却、蓄力进度、临时旗标和待执行动作则属于本场战斗状态。
| 状态类型 | 典型字段 | 重置处理 |
|---|---|---|
| 持久数据 | difficulty、bossConfigId | 保留 |
| 阶段状态 | currentPhase、phaseTimer | 复位 |
| 目标状态 | currentTarget、targetLostAt | 清空 |
| 动作状态 | currentAction、chargeProgress | 清空或取消 |
| 冷却资源 | skillCooldowns、reservedResource | 清空并释放 |
| 临时事件 | triggeredFlags、consumedEvents | 按战斗规则清空 |

重开战斗时要按什么顺序复位
建议把 reset 做成显式生命周期,而不是散落在多个系统里的字段赋值。先停止决策和取消未完成动作,再清目标与战斗临时状态,然后重置阶段计时、冷却和资源占用,最后初始化第一阶段并允许 AI 恢复决策。
一个最小实现可以把“清理旧状态”和“建立新状态”分成两个动作,避免初始化代码意外读取旧值。
from dataclasses import dataclass, field
@dataclass
class BossRuntime:
current_phase: str = "phase_1"
current_target: str | None = None
current_action: str | None = None
phase_timer: float = 0.0
charge_progress: float = 0.0
skill_cooldowns: dict[str, float] = field(default_factory=dict)
reserved_resource: int = 0
temporary_flags: set[str] = field(default_factory=set)
def reset_for_new_battle(self) -> None:
# 先取消正在执行的动作,再清理与上一场战斗绑定的运行时状态。
self.current_target = None
self.current_action = None
self.phase_timer = 0.0
self.charge_progress = 0.0
self.skill_cooldowns.clear()
self.reserved_resource = 0
self.temporary_flags.clear()
self.current_phase = "phase_1"
state = BossRuntime(
current_phase="enraged",
current_target="player-7",
current_action="charge",
phase_timer=28.5,
charge_progress=0.72,
skill_cooldowns={"slam": 4.0},
reserved_resource=20,
temporary_flags={"shield_broken"},
)
state.reset_for_new_battle()
print(state.current_phase, state.current_target, state.current_action)
print(state.phase_timer, state.charge_progress, state.skill_cooldowns)
print(state.reserved_resource, state.temporary_flags)预期结果
phase_1 None None
0.0 0.0 {}
0 set()这里有一个重要边界:如果资源归还、动画取消或事件注销需要调用外部系统,就不能只改内存字段。应先执行对应的 cleanup,再清除引用,否则视觉层、资源管理器或事件总线仍可能持有上一场战斗的对象。
读取存档时不要把“存档值”当成“运行时值”
加载存档时,持久数据与运行时状态的处理方式不同。存档可以保存 Boss 已到达的阶段、战斗进度或剧情条件,但 AI 当前目标、正在播放的攻击、未完成的蓄力等瞬时状态通常应该重新构建,而不是原样恢复。
因此更稳妥的顺序是:读取持久事实 → 创建新的运行时实例 → 根据事实确定初始阶段 → 初始化该阶段允许的技能与计时器 → 再开始决策。这样可以避免旧版本存档带入已经不存在的运行时字段。
重新生成 Boss 时重点检查哪些残留
验证重置是否完整,可以针对最容易污染下一场战斗的状态做断言:当前目标必须为空,当前动作必须为空,阶段计时器必须为零,冷却表为空,蓄力进度归零,临时事件标记清空,同时新 Boss 的初始阶段应符合配置。
真正容易漏掉的还有异步任务和订阅关系。例如旧 Boss 仍订阅 damage event,即使它的字段已经重置,下一次受击仍可能触发旧实例的阶段迁移。因此重置验收不仅检查字段,还要检查 pending task、timer callback 和 event subscription 是否已经解除。
战斗重置做得可靠的标志,是同一场 Boss 战连续创建多次都得到相同的初始运行时状态;重置逻辑应具备幂等性,重复调用不会产生额外副作用。