跳转到内容

快速上手

下面走一遍「让一个实体动起来」:在编辑器里把它加进场景,再用一段 TypeScript 系统驱动它。

  1. 创建项目。 在编辑器中点击 New project,选 Blank 起始模板,命名后点击 Create project。你会得到一个带相机实体的默认场景。(想直接看成品的话, Examples 模板是完整的示例项目。)

  2. 添加实体。 在场景层级里新建一个实体,在检视面板中给它加上 SpriteTransform 组件。

  3. 编写系统。 在项目的脚本里新建一个 TypeScript 文件,注册一个系统,让所有带 Speed 组件的实体移动:

    import {
    defineComponent, defineSystem, addSystem,
    Query, Mut, Res, Time, Transform
    } from 'esengine';
    const Speed = defineComponent('Speed', { value: 200 });
    addSystem(defineSystem(
    [Res(Time), Query(Mut(Transform), Speed)],
    (time, query) => {
    for (const [entity, transform, speed] of query) {
    transform.position.x += speed.value * time.delta;
    }
    }
    ));
  4. 预览。 保存脚本——编辑器会监视项目脚本,片刻后提取你的组件定义,于是 Speed 会自动出现在检视器的添加组件列表里。给实体加上 Speed 组件,然后按 F5 运行 场景,精灵就会移动。