ECS Framework

一个高性能的 TypeScript ECS (Entity-Component-System) 框架，专为现代游戏开发而设计。

特性

• 高性能 - 针对大规模实体优化，支持SoA存储和批量处理
• 多线程计算 - Worker系统支持真正的并行处理，充分利用多核CPU性能
• 类型安全 - 完整的TypeScript支持，编译时类型检查
• 现代架构 - 支持多World、多Scene的分层架构设计
• 开发友好 - 内置调试工具和性能监控
• 跨平台 - 支持Cocos Creator、Laya引擎和Web平台

安装

npm install @esengine/ecs-framework

快速开始

import { Core, Scene, Component, EntitySystem, ECSComponent, ECSSystem, Matcher, Time } from '@esengine/ecs-framework';

// 定义组件
@ECSComponent('Position')
class Position extends Component {
    constructor(public x = 0, public y = 0) {
        super();
    }
}

@ECSComponent('Velocity')
class Velocity extends Component {
    constructor(public dx = 0, public dy = 0) {
        super();
    }
}

// 创建系统
@ECSSystem('Movement')
class MovementSystem extends EntitySystem {
    constructor() {
        super(Matcher.all(Position, Velocity));
    }

    protected process(entities: readonly Entity[]): void {
        for (const entity of entities) {
            const position = entity.getComponent(Position)!;
            const velocity = entity.getComponent(Velocity)!;

            position.x += velocity.dx * Time.deltaTime;
            position.y += velocity.dy * Time.deltaTime;
        }
    }
}

// 创建场景并启动
class GameScene extends Scene {
    protected initialize(): void {
        this.addSystem(new MovementSystem());

        const player = this.createEntity("Player");
        player.addComponent(new Position(100, 100));
        player.addComponent(new Velocity(50, 0));
    }
}

// 启动游戏
Core.create();
Core.setScene(new GameScene());

// 游戏循环中更新
function gameLoop(deltaTime: number) {
    Core.update(deltaTime);
}

核心特性

• 实体查询 - 使用 Matcher API 进行高效的实体过滤
• 事件系统 - 类型安全的事件发布/订阅机制
• 性能优化 - SoA 存储优化，支持大规模实体处理
• 多线程支持 - Worker系统实现真正的并行计算，充分利用多核CPU
• 多场景 - 支持 World/Scene 分层架构
• 时间管理 - 内置定时器和时间控制系统

平台支持

支持主流游戏引擎和 Web 平台：

• Cocos Creator - 内置引擎集成支持，提供专用调试插件
• Laya 引擎 - 完整的生命周期管理
• 原生 Web - 浏览器环境直接运行
• 小游戏平台 - 微信、支付宝等小游戏

示例项目

• Worker系统演示 - 多线程物理系统演示，展示高性能并行计算
• 割草机演示 - 完整的游戏示例

文档

• 快速入门 - 详细教程和平台集成
• 完整指南 - ECS 概念和使用指南
• API 参考 - 完整 API 文档

生态系统

• 路径寻找 - A*、BFS、Dijkstra 算法
• AI 系统 - 行为树、效用 AI

社区与支持

• 问题反馈 - Bug 报告和功能建议
• QQ 交流群 - ecs游戏框架交流

许可证

MIT © 2025 ECS Framework