游戏客户端架构 / 系统课时

先画清战斗 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,重点检验“施法请求生成投射物 → 命中事件 → 伤害结算”,不冒充真正的几何碰撞检测。

python
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()

预期输出:

text
角色2生命值: 70
剩余投射物: 0

这个样例在事件列表消费期间删除的是独立字典里的投射物,安全且便于看清逻辑。真正的 ECS 查询若正在遍历投射物组件,删除实体应改成向 CommandBuffer 提交命令,并在查询完成后统一执行。

扩展模型时守住的边界

增加护盾、暴击或抗性时,让伤害结算读取新增组件,不必把计算挪进投射物。增加范围攻击时,碰撞阶段可以为多个目标生成记录,但要定义每个投射物能命中几次、怎样去重,以及阵营与无敌状态的核验顺序。

另一个需要提前确定的规则是伤害数值何时固定:若技能等级或增益会在飞行途中改变,可在生成投射物时保存伤害快照,也可在命中时按权威状态重算,但必须统一选择,否则回放和联网结算容易出现不同结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

先画清战斗 ECS 数据模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通