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

跑通一个最小 ECS 世界

跑通一个最小 ECS 世界

本课用 Python 标准库搭建一个能更新的 ECS 世界:玩家拥有位置和速度,石块只有位置。运行一次 MovementSystem 后,你将看到玩家移动、石块保持不动,并理解系统如何根据组件组合选择实体。

学习目标

  • 用实体 ID、组件存储和 System 组成最小 ECS。
  • 理解系统怎样筛选实体并按时间步长更新状态。
  • 运行代码,验证拥有不同组件的实体行为不同。

把身份、状态和行为拆开

Entity 只负责标识,例如 101 是玩家、102 是石块;它不必有继承层次或 update() 方法。Position(x, y) 与 Velocity(vx, vy) 是组件,只存数值,不负责计算。

World 用两张以实体 ID 为键的表保存组件。MovementSystem 从速度表读取候选 ID,再查找对应位置:同时拥有两种组件的实体才进入移动计算。石块没有速度组件,因此不会因为被遍历到就移动。

最小 ECS 世界的组件匹配与位置更新

编写并执行更新循环

使用 Python 3.9 或更高版本,将以下代码保存为 minimal_ecs.py,执行 python minimal_ecs.py。示例故意使用字典呈现组件匹配机制,不把它伪装成已优化的连续内存 ECS。

python
from dataclasses import dataclass

@dataclass
class Position:
    x: float
    y: float

@dataclass
class Velocity:
    vx: float
    vy: float

class World:
    def __init__(self) -> None:
        self.positions: dict[int, Position] = {}
        self.velocities: dict[int, Velocity] = {}

def movement_system(world: World, dt: float) -> None:
    # 只更新同时拥有位置和速度组件的实体
    for entity_id, velocity in world.velocities.items():
        position = world.positions.get(entity_id)
        if position is None:
            continue
        position.x += velocity.vx * dt
        position.y += velocity.vy * dt

def show_positions(world: World) -> None:
    for entity_id in sorted(world.positions):
        p = world.positions[entity_id]
        print(f'Entity {entity_id}: ({p.x:.1f}, {p.y:.1f})')

world = World()
# 实体只是 ID,数据按组件类型分别登记
world.positions[101] = Position(1.0, 2.0)
world.velocities[101] = Velocity(4.0, 0.0)
world.positions[102] = Position(10.0, 3.0)

print('更新前')
show_positions(world)
movement_system(world, 0.5)
print('更新后')
show_positions(world)

预期输出:

text
更新前
Entity 101: (1.0, 2.0)
Entity 102: (10.0, 3.0)
更新后
Entity 101: (3.0, 2.0)
Entity 102: (10.0, 3.0)

逐步核对筛选和写回

系统遍历速度表,因此拿到实体 101;再根据同一 ID 找到其 Position。在半秒内,横向位移为 4.0 × 0.5 = 2.0,于是 x 从 1.0 变为 3.0,纵向速度为 0,因此 y 不变。

实体 102 虽然有 Position,却不在速度表中,因此不进入系统循环。反过来,如果速度表存在某个 ID 但位置表没有,代码也会通过 continue 跳过,避免访问不存在的组件。这是组件匹配,而不是在对象类型上判断“玩家还是石块”。

这里的 dt 表示本次更新经过的时间,单位为秒。位置变化量等于速度乘以时间,因此系统不需要知道实体是玩家、敌人还是道具,只需要拿到对应组件数据。

改动一次验证组合能力

将 world.velocities[102] = Velocity(0.0, -2.0) 加到调用 movement_system 之前并重新运行,石块的位置应从 (10.0, 3.0) 变为 (10.0, 2.0),无需修改 System。再尝试连续调用两次、每次 dt=0.5:玩家的 x 应从 1.0 依次变为 3.0、5.0。

还可以删除玩家的速度组件并重新执行程序。此时两个实体都不会移动,但位置数据依然存在。这说明实体的能力由组件组合决定,组件可以独立增加或移除,而 System 不必维护一套实体类型分支。

这个例子解决的是 ECS 的职责分离和更新闭环。真实游戏还要处理实体销毁、组件增删、系统执行顺序以及连续内存布局,但它们不改变“按组件筛选数据,再由 System 执行行为”的基本规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

跑通一个最小 ECS 世界

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

登录哪都通