@bendyline/molen-kernel/kinematics

Molen headless deterministic simulation kernel (no DOM, no three.js).

import { /* … */ } from '@bendyline/molen-kernel/kinematics';

Interfaces

ColliderData

Extends

• JsonObject

Indexable

[key: string]: JsonValue | undefined

Properties

halfExtents?

optional halfExtents?: [number, number];

isStatic?

optional isStatic?: boolean;

layer

layer: number;

mask

mask: number;

radius?

optional radius?: number;

shape

shape: "circle" | "aabb";

---

KinematicBodyData

Extends

• JsonObject

Indexable

[key: string]: JsonValue | undefined

Properties

slide

slide: boolean;

vel

vel: Vec3;

---

KinematicsOptions

Properties

broadphase?

optional broadphase?: "grid" | "brute";

grid (default) or brute (the O(n²) reference, kept as the test oracle).

ground?

optional ground?: "flat" | "terrain";

Vertical constraint for kinematic bodies: none (default; vel[1] integrates freely), flat (clamped to y = 0), or terrain (clamped to the world's ground field — see installTerrain on the /terrain subpath).

---

RayHit

Properties

distance

distance: number;

id

id: string;

point

point: Vec3;

Variables

Collider

const Collider: ComponentType<ColliderData>;

---

KinematicBody

const KinematicBody: ComponentType<KinematicBodyData>;

Functions

installKinematics()

function installKinematics(world, opts?): void;

Install the kinematic collision system (physics phase).

Parameters

world

World

opts?

KinematicsOptions

Returns

void

---

overlapCircle()

function overlapCircle(
   world, 
   center, 
   radius, 
   mask?
): string[];

Return entity ids whose collider overlaps a circle at (center, radius).

Parameters

world

World

center

Vec3

radius

number

mask?

number

Returns

string[]

---

raycast()

function raycast(
   world, 
   origin, 
   dir, 
   maxDist, 
   mask?
): RayHit | null;

Raycast in the XZ plane against colliders; returns the nearest hit. O(n).

Parameters

world

World

origin

Vec3

dir

Vec3

maxDist

number

mask?

number

Returns

RayHit | null