游戏客户端架构 / 系统课时
先画清战斗 ECS 数据模型
先画清战斗 ECS 数据模型
本节把一次“角色施法、投射物命中、扣血并触发死亡”的战斗行为拆成可落地的 ECS 数据模型。你会明确哪些对象应是实体、哪些数据适合做组件或共享配置,以及谁有权修改生命值,最后用一段代码验证完整的命中结算链。
学习目标
- 为角色、技能、投射物与命中记录选择合适的数据归属。
- 划清施法、移动、碰撞、伤害和死亡系统的读写责任。
- 用最小可运行示例验证一次性命中与生命值结算。
用一次远程攻击确定数据归属
假设角色 E1 释放技能 bolt,生成投射物 P100,击中角色 E2,令其生命值从 100 降到 70。建模时先区分“持续存在且有身份的对象”与“供系统消费的数据”,不要把战斗中出现的每个名词都做成实体。
| 对象 | 建模方式 | 主要数据 |
|---|---|---|
| 角色 E1、E2 | 实体及组件 | Position、Health、Faction、CastIntent |
技能 bolt |
共享只读配置 | SkillDef:伤害、速度、冷却 |
| 投射物 P100 | 临时实体及组件 | Position、Velocity、ProjectileData(施法者 ID、技能 ID) |
| 命中记录 | 短生命周期事件 | HitEvent:投射物 ID、目标 ID |
CastIntent 是本次固定步待消费的施法请求,不应永久挂在角色身上。技能定义通常是一条可复用配置,而不是每施法一次就生成的实体;如果技能有独立的持续施法、引导或区域效果生命周期,再考虑建立技能实例实体。
实体 ID 只在所属 World 的有效生命周期内可用。投射物引用施法者的 ID,而不是持有场景对象的可变引用;读取目标前还要检查实体是否存活、是否属于可攻击阵营。
让数据沿受控的系统链路流动
CastSystem 检查请求、资源与冷却,读取 SkillDef 后提交创建投射物的结构命令。ProjectileMoveSystem 更新位置;CollisionSystem 只判断接触并写入 HitEvent,不能直接扣血。DamageSystem 统一核验命中、计算伤害并修改 Health;DeathSystem 根据生命值写死亡状态,最后由表现层读取稳定结果生成反馈。

这里最重要的约束是只有伤害结算系统写生命值。同一命中只允许消费一次;角色死亡也不要让碰撞回调立即销毁实体,否则仍在遍历的系统可能拿到失效引用。结构变化应放到安全的提交点执行。
用最小代码验证命中结算
下面使用 Python 3.10 标准库和以实体 ID 为键的组件存储模拟数据边界。它假定碰撞阶段已确认 P100 命中 E2,重点检验“施法请求生成投射物 → 命中事件 → 伤害结算”,不冒充真正的几何碰撞检测。
from dataclasses import dataclass
@dataclass
class Health:
value: int
@dataclass(frozen=True)
class SkillDef:
damage: int
@dataclass(frozen=True)
class CastIntent:
caster_id: int
skill_id: str
@dataclass(frozen=True)
class Projectile:
owner_id: int
skill_id: str
@dataclass(frozen=True)
class HitEvent:
projectile_id: int
target_id: int
def main():
# 技能是共享配置;组件存储使用 World 内的实体 ID
health = {1: Health(100), 2: Health(100)}
skills = {"bolt": SkillDef(damage=30)}
casts = [CastIntent(caster_id=1, skill_id="bolt")]
projectiles = {}
for projectile_id, cast in enumerate(casts, start=100):
projectiles[projectile_id] = Projectile(cast.caster_id, cast.skill_id)
# 此处用固定命中记录代替碰撞查询
hits = [HitEvent(projectile_id=100, target_id=2)]
for hit in hits:
projectile = projectiles.get(hit.projectile_id)
target_health = health.get(hit.target_id)
if projectile is None or target_health is None:
continue
# 同一投射物在结算后移除,重复命中不会再次扣血
target_health.value = max(
0, target_health.value - skills[projectile.skill_id].damage
)
del projectiles[hit.projectile_id]
print(f"角色2生命值: {health[2].value}")
print(f"剩余投射物: {len(projectiles)}")
if __name__ == "__main__":
main()预期输出:
角色2生命值: 70
剩余投射物: 0这个样例在事件列表消费期间删除的是独立字典里的投射物,安全且便于看清逻辑。真正的 ECS 查询若正在遍历投射物组件,删除实体应改成向 CommandBuffer 提交命令,并在查询完成后统一执行。
扩展模型时守住的边界
增加护盾、暴击或抗性时,让伤害结算读取新增组件,不必把计算挪进投射物。增加范围攻击时,碰撞阶段可以为多个目标生成记录,但要定义每个投射物能命中几次、怎样去重,以及阵营与无敌状态的核验顺序。
另一个需要提前确定的规则是伤害数值何时固定:若技能等级或增益会在飞行途中改变,可在生成投射物时保存伤害快照,也可在命中时按权威状态重算,但必须统一选择,否则回放和联网结算容易出现不同结果。