游戏客户端架构 / 系统课时
把战斗循环拆成系统阶段
把战斗循环拆成系统阶段
当输入、选敌、移动、碰撞和扣血在同一帧里互相直接调用时,战斗结果会依赖偶然的调用顺序。本节把一次战斗固定步拆为可检查的系统阶段,约定各阶段读写的数据、事件封口位置与结构命令提交点,使结果能够稳定复现。
学习目标
- 为输入、目标选择、移动、碰撞、伤害、死亡和表现建立明确的执行顺序。
- 找出位置、命中事件、生命值与实体结构变化之间的依赖。
- 运行一个固定步样例,验证交换阶段会导致的行为差异。
为每个系统定义读写合同
以固定时间步 Tick 为模拟单位。设备可以在渲染帧中多次采样,但模拟入口只消费一份确定的 InputSnapshot;表现更新不反向驱动战斗状态。对一枚需要在本 Tick 移动的投射物,施法系统必须在移动前提交生成命令。
| 阶段 | 读取 | 写入或产出 |
|---|---|---|
| 输入映射 | InputSnapshot |
MoveIntent、CastIntent |
| 目标选择 | Position、Faction、存活状态 |
TargetId |
| 施法与生成 | CastIntent、TargetId、SkillDef |
CreateProjectileCommand |
| 移动 | MoveIntent、Velocity、Position |
新 Position |
| 碰撞 | 更新后的位置与碰撞体 | HitEvent |
| 伤害 | 已封口的 HitEvent、Health |
新 Health、受击结果 |
| 死亡 | 更新后的 Health |
Dead、销毁命令、死亡事件 |
| 表现 | 已提交的模拟快照与表现事件 | 动画、特效、音频指令 |
目标选择发生在本 Tick 的移动前,因此它读取的是本步开始时的位置;移动后碰撞才读取新位置。若设计要求“移动后再选目标”,必须显式调整依赖图,而不是让两个系统依线程调度碰运气。
把事件和结构提交点画在时间轴上

提交点 A 决定新投射物是否参与本步移动;如果延迟到下一 Tick 才提交,投射物首帧位置和碰撞时机也会改变。碰撞完成后封口 HitEvent 缓冲区,保证伤害系统看到的是完整的一批命中,不会边读边追加。
死亡阶段先写 Dead 或产生死亡事件,再将实体销毁排入 CommandBuffer。提交点 C 统一执行结构变化;死亡特效所需的位置应随死亡事件保存,避免实体删掉后表现层无处读取。阶段是数据依赖合同,不意味着每个系统之间都必须设置昂贵的全局线程屏障;没有读写冲突的任务可以并行。
运行一帧可验证的简化战斗
以下 Python 3.10 示例用一维位置和近战距离替代完整物理系统,逐段执行目标选择、移动、碰撞、伤害、死亡和表现。固定输入让角色 1 从位置 0 移动到 1,角色 2 位于位置 2,生命值为 25,命中伤害为 30。
from dataclasses import dataclass, field
@dataclass
class World:
x: dict[int, float]
hp: dict[int, int]
dead: set[int] = field(default_factory=set)
def combat_tick(world: World) -> None:
# Input 阶段:用固定意图代替外部设备采样
attacker, move = 1, 1.0
candidates = [
eid for eid, hp in world.hp.items()
if eid != attacker and hp > 0
]
# TargetSelect 读取移动前的位置
target = min(
candidates, key=lambda eid: abs(world.x[eid] - world.x[attacker]),
default=None
)
world.x[attacker] += move # Move
hits = []
if target is not None and abs(world.x[attacker] - world.x[target]) <= 1.0:
hits.append((target, 30)) # Collision 只写事件
# Damage 独占修改生命值,Death 随后设置死亡标记
for target_id, damage in hits:
world.hp[target_id] = max(0, world.hp[target_id] - damage)
for eid, hp in world.hp.items():
if hp == 0:
world.dead.add(eid)
print(f"角色1位置: {world.x[1]:.1f}")
print(f"角色2生命: {world.hp[2]}")
print(f"死亡实体: {sorted(world.dead)}")
print(f"命中条数: {len(hits)}")
if __name__ == "__main__":
combat_tick(World(x={1: 0.0, 2: 2.0}, hp={1: 100, 2: 25}))预期输出:
角色1位置: 1.0
角色2生命: 0
死亡实体: [2]
命中条数: 1如果误把碰撞安排在移动之前,初始距离为 2,不满足命中距离 1,本次就不会扣血。如果死亡先于伤害执行,角色 2 当步也得不到 Dead 标记。这些差异说明排序必须由系统依赖显式约束。
让阶段顺序支持扩展与排查
接入投射物时,在“施法与生成”之后增加结构提交,再让移动和碰撞读取新实体;接入并行 Job 时,把 Position 的写入与碰撞读取建立先后依赖,把 HitEvent 先汇总后统一交给伤害阶段。多个伤害生产者不得同时无序改写同一 Health。
建议为每个固定步记录 Tick 编号、输入快照、命中记录数量、死亡事件数量和最终状态摘要。重放相同输入后对比实体位置、生命值与死亡标记;一旦不一致,按阶段定位是目标选择、碰撞漏报、事件重复消费还是结构命令提交时机出了问题。