ecs 是一份关于 EliCS 的实用说明。EliCS 是面向 TypeScript 的轻量、高性能实体组件系统框架,采用数据导向设计,优先组合而非继承,并使用高效位掩码和类型化数组存储。本技能文档用于帮助开发者用 EliCS 组织游戏状态,涵盖组件、系统、查询、谓词、生命周期以及 Input/State/View 架构。
核心概念包括:实体(唯一对象)、组件(数据容器)、系统(逻辑处理器)、查询(实体选择器)和 World(管理一切的容器)。当游戏包含许多相互交互、共享行为的对象(敌人、投射物、拾取物、单位),且使用状态驱动的更新循环时,适合采用 ECS,把逻辑放在系统、状态放在组件中,避免类之间的混乱耦合。如果只是对象很少的小型场景,使用普通对象加渲染循环即可,ECS 反而是额外开销。
推荐架构分为三层。Input 层:输入系统接收用户输入、归一化并应用到 State;复杂输入可拆分为多个系统,例如原始事件→归一化动作→状态更新;每个输入系统还应提供方法,以便以命令式方式触发全部输入,实现程序化模拟与测试。State 层:状态系统每帧推进游戏状态,例如敌人追逐玩家。View 层:视图系统把 State 反映到 View;初始化时可订阅实体的创建/移除,以创建/销毁 3D 对象或 UI,并每帧更新频繁变化的数据。
推荐文件结构为:src/components/.ts 每个组件一个文件,组件只保存状态,行为属于系统;src/systems/.ts 每个系统一个文件,导出初始化与每帧更新函数;src/seed.ts 构建启动实体并挂载组件,让游戏可立即游玩;src/main.ts 组合游戏,加载种子、注册系统、执行初始化,然后每帧推进所有状态并同步到 View。
创建 World 时从 elics 导入 World 并实例化。组件通过 createComponent 定义,支持标量(Int8、Int16、Float32、Float64、Boolean、String)、向量(Vec2、Vec3、Vec4、Color)、实体引用(Entity)、枚举(Enum)和 Object(任意 JS 值,非 ECS 引用)。组件创建后需调用 world.registerComponent 注册。文档给出了 Position、Velocity、Health、Unit、Target 等示例以及枚举定义方式。
创建实体时调用 world.createEntity(),再用 addComponent 挂载组件并可传入初始值;通过 getValue/setValue 读写标量,通过 getVectorView 读写向量;hasComponent 检查组件,removeComponent 移除组件,destroy 销毁实体(active 变为 false)。文档特别提示:向量类型必须通过 getVectorView() 访问,不能用 getValue()/setValue(),否则 EliCS 会在运行时抛错。
系统通过继承 createSystem(queryConfig) 创建,在 update(delta, time) 中遍历查询实体并处理逻辑。示例包括 MovementSystem 按速度更新位置、UnitViewSystem 在实体符合/不符合查询时创建/销毁 3D 模型并每帧同步位置。系统通过 world.registerSystem 注册并可指定 priority(数值小者先运行);通过 world.getSystem 获取系统实例并调用其方法。
系统生命周期方面,框架在 registerSystem 时调用 init(),在每次 world.update 时调用 update(),没有内置 load() 钩子。若需异步加载资源,可自行定义 load() 方法,在注册之后、动画循环之前自行 await 调用;它只是普通方法,不会自动执行。系统还可用 stop() 暂停、play() 恢复,并通过 isPaused 检查暂停状态,适用于过场动画或菜单期间暂停物理等场景。
查询谓词可通过 where 子句按组件值过滤实体,例如筛选生命值低于 30 的单位,支持 eq、ne、lt、le、gt、ge、in、nin 等操作符,并可用 excluded 排除带有某组件的实体。最后,每帧调用 world.update(delta, elapsedTime) 更新世界。文档提醒,具体函数签名与完整类型定义应以安装的 elics 类型为准,本页可能滞后于包版本。