A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
/**
* @file velocity.ts
* @brief Velocity concept — integrates the builtin Velocity component into Transform.
*/
import type { Plugin } from './app/app';
import { defineSystem, Schedule, GetWorld } from './ecs/system';
import { Query, Mut } from './ecs/query';
import { Res, Time, type TimeData } from './ecs/resource';
import { playModeOnly } from './ecs/env';
import { Transform, Velocity, getComponentRegistry } from './ecs/component';
import type { TransformData, VelocityData } from './ecs/component';
import type { Entity } from './types';
import type { World } from './ecs/world';
export const velocitySystem = defineSystem(
[Query(Mut(Transform), Velocity), Res(Time), GetWorld()],
(
query: Iterable<[Entity, TransformData, VelocityData]>,
time: TimeData,
world: World,
) => {
const dt = time.delta;
if (dt <= 0) return;
// Physics-owned bodies get their transform from the solver; integrating
// Velocity on top would double-move them. RigidBody2D lives in the physics
// subpath, so it is resolved by name — absent registry entry means the
// physics module was never loaded and no entity can carry it.
const rigidBody = getComponentRegistry().get('RigidBody2D');
for (const [entity, transform, velocity] of query) {
if (rigidBody && world.has(entity, rigidBody)) continue;
const lin = velocity.linear;
if (lin.x !== 0 || lin.y !== 0 || lin.z !== 0) {
const p = transform.position;
transform.position = {
x: p.x + lin.x * dt,
y: p.y + lin.y * dt,
z: p.z + lin.z * dt,
};
}
const ang = velocity.angular;
if (ang.x !== 0 || ang.y !== 0 || ang.z !== 0) {
// Exponential map: rotate by |ω|·dt around ω̂ in the world frame —
// exact for constant angular velocity at any step size (no drift
// to renormalize away).
const q = transform.rotation;
const mag = Math.hypot(ang.x, ang.y, ang.z);
const half = mag * dt * 0.5;
const s = Math.sin(half) / mag;
const dw = Math.cos(half), dx = ang.x * s, dy = ang.y * s, dz = ang.z * s;
transform.rotation = {
w: dw * q.w - dx * q.x - dy * q.y - dz * q.z,
x: dw * q.x + dx * q.w + dy * q.z - dz * q.y,
y: dw * q.y - dx * q.z + dy * q.w + dz * q.x,
z: dw * q.z + dx * q.y - dy * q.x + dz * q.w,
};
}
}
},
{
name: 'VelocitySystem',
// The World is here for one question — does this entity have a physics
// body — and RigidBody2D cannot be named as a query filter because the
// physics module may never have registered it.
touches: { reads: ['RigidBody2D'] },
}
);
export const velocityPlugin: Plugin = {
name: 'Velocity',
// One query over Velocity: with none in the scene, skipped rather than walked.
activeWhen: [Velocity],
profileDomain: 'velocity',
build(app) {
app.addSystemToSchedule(Schedule.Update, velocitySystem, { runIf: playModeOnly });
},
};