@worldmesh/runtime 0.1.0

package/dist/movement/controller.js

@@ -0,0 +1,200 @@
+import { Vector3 } from 'three';
+export const DEFAULT_TUNING = {
+    walkSpeed: 5.2,
+    sprintSpeed: 9,
+    crouchSpeed: 2.4,
+    flySpeed: 12,
+    jumpSpeed: 7.6,
+    gravity: 24,
+    groundAccel: 14,
+    airAccel: 4,
+    dashSpeed: 18,
+    dashCooldown: 1.2,
+    maxFallSpeed: 55,
+    fallLimit: -60,
+};
+/**
+ * The one movement implementation every WorldMesh world shares.
+ * Optional capabilities are branches on `abilities` flags, never subclasses:
+ * that is what keeps "declare it in config" honest.
+ */
+export class MovementController {
+    /** Player feet position in world space. */
+    position = new Vector3();
+    velocity = new Vector3();
+    onGround = false;
+    crouching = false;
+    flying = false;
+    /** Current standing height, shrinks while crouching. */
+    currentHeight;
+    tuning;
+    input;
+    collision;
+    abilities;
+    baseHeight;
+    radius;
+    jumpsUsed = 0;
+    dashCooldown = 0;
+    dashTime = 0;
+    dashDirection = new Vector3();
+    scratch = new Vector3();
+    groundProbe = new Vector3();
+    constructor(options) {
+        this.input = options.input;
+        this.collision = options.collision;
+        this.abilities = options.abilities;
+        this.tuning = { ...DEFAULT_TUNING, ...options.tuning };
+        this.baseHeight = options.height;
+        this.currentHeight = options.height;
+        this.radius = options.radius;
+        this.position.copy(options.spawn);
+    }
+    get height() {
+        return this.currentHeight;
+    }
+    reset(position) {
+        this.position.copy(position);
+        this.velocity.set(0, 0, 0);
+        this.onGround = false;
+        this.flying = false;
+        this.crouching = false;
+        this.jumpsUsed = 0;
+        this.dashTime = 0;
+    }
+    /** Advance one simulation step. `yaw` is the camera heading in radians. */
+    step(dt, yaw, controlsEnabled) {
+        const axis = controlsEnabled ? this.input.getMoveAxis() : { x: 0, z: 0 };
+        this.updateModes(controlsEnabled);
+        // Rotate local input into world space using the camera heading.
+        const sin = Math.sin(yaw);
+        const cos = Math.cos(yaw);
+        const wishX = axis.x * cos + axis.z * sin;
+        const wishZ = -axis.x * sin + axis.z * cos;
+        const speed = this.currentSpeed();
+        const targetX = wishX * speed;
+        const targetZ = wishZ * speed;
+        if (this.flying) {
+            this.stepFlying(dt, targetX, targetZ, controlsEnabled);
+        }
+        else {
+            this.stepGrounded(dt, targetX, targetZ, controlsEnabled);
+        }
+        this.stepDash(dt, controlsEnabled, wishX, wishZ, yaw);
+        this.applyMotion(dt);
+    }
+    updateModes(controlsEnabled) {
+        if (this.abilities.flying && controlsEnabled && this.input.consume('fly')) {
+            this.flying = !this.flying;
+            if (this.flying) {
+                this.velocity.y = 0;
+                this.onGround = false;
+            }
+        }
+        const wantsCrouch = this.abilities.crouching && controlsEnabled && this.input.isDown('crouch');
+        this.crouching = wantsCrouch && !this.flying;
+        const targetHeight = this.crouching ? this.baseHeight * 0.55 : this.baseHeight;
+        // Smooth so the camera does not snap between eye heights.
+        this.currentHeight += (targetHeight - this.currentHeight) * 0.35;
+    }
+    currentSpeed() {
+        const tuning = this.tuning;
+        if (this.flying)
+            return tuning.flySpeed;
+        if (this.crouching)
+            return tuning.crouchSpeed;
+        return this.input.isDown('sprint') ? tuning.sprintSpeed : tuning.walkSpeed;
+    }
+    stepGrounded(dt, targetX, targetZ, controlsEnabled) {
+        const tuning = this.tuning;
+        const accel = this.onGround ? tuning.groundAccel : tuning.airAccel;
+        const blend = 1 - Math.exp(-accel * dt);
+        this.velocity.x += (targetX - this.velocity.x) * blend;
+        this.velocity.z += (targetZ - this.velocity.z) * blend;
+        this.velocity.y -= tuning.gravity * dt;
+        if (this.velocity.y < -tuning.maxFallSpeed)
+            this.velocity.y = -tuning.maxFallSpeed;
+        if (controlsEnabled && this.input.consume('jump')) {
+            const maxJumps = this.abilities.doubleJump ? 2 : 1;
+            if (this.onGround) {
+                this.velocity.y = tuning.jumpSpeed;
+                this.jumpsUsed = 1;
+                this.onGround = false;
+            }
+            else if (this.jumpsUsed < maxJumps) {
+                this.velocity.y = tuning.jumpSpeed * 0.9;
+                this.jumpsUsed++;
+            }
+        }
+    }
+    stepFlying(dt, targetX, targetZ, controlsEnabled) {
+        const blend = 1 - Math.exp(-this.tuning.groundAccel * dt);
+        this.velocity.x += (targetX - this.velocity.x) * blend;
+        this.velocity.z += (targetZ - this.velocity.z) * blend;
+        const up = controlsEnabled && this.input.isDown('jump') ? 1 : 0;
+        const down = controlsEnabled && this.abilities.crouching && this.input.isDown('crouch') ? 1 : 0;
+        const targetY = (up - down) * this.tuning.flySpeed;
+        this.velocity.y += (targetY - this.velocity.y) * blend;
+        this.onGround = false;
+    }
+    stepDash(dt, controlsEnabled, wishX, wishZ, yaw) {
+        if (!this.abilities.dash)
+            return;
+        this.dashCooldown = Math.max(0, this.dashCooldown - dt);
+        if (controlsEnabled && this.input.consume('dash') && this.dashCooldown === 0) {
+            // Dash along the input direction, or straight ahead when standing still.
+            if (wishX === 0 && wishZ === 0) {
+                this.dashDirection.set(-Math.sin(yaw), 0, -Math.cos(yaw));
+            }
+            else {
+                this.dashDirection.set(wishX, 0, wishZ).normalize();
+            }
+            this.dashTime = 0.18;
+            this.dashCooldown = this.tuning.dashCooldown;
+        }
+        if (this.dashTime > 0) {
+            this.dashTime = Math.max(0, this.dashTime - dt);
+            this.velocity.x = this.dashDirection.x * this.tuning.dashSpeed;
+            this.velocity.z = this.dashDirection.z * this.tuning.dashSpeed;
+            if (!this.flying && this.velocity.y < 0)
+                this.velocity.y = 0;
+        }
+    }
+    applyMotion(dt) {
+        const horizontal = this.scratch.set(this.velocity.x * dt, 0, this.velocity.z * dt);
+        const resolved = this.collision.resolveHorizontal(this.position, horizontal, this.radius, this.currentHeight);
+        // Feed the resolved slide back into velocity so we do not keep pushing
+        // into a wall and accelerating along it.
+        if (dt > 0) {
+            this.velocity.x = resolved.x / dt;
+            this.velocity.z = resolved.z / dt;
+        }
+        this.position.x += resolved.x;
+        this.position.z += resolved.z;
+        const previousY = this.position.y;
+        this.position.y += this.velocity.y * dt;
+        // Sample from where the feet *were*, and look down far enough to cover the
+        // distance just fallen. Sampling from the new position would miss the floor
+        // on the frame the player crosses it and drop them through the world.
+        const fallDistance = Math.max(0, previousY - this.position.y);
+        const stepHeight = this.onGround ? 0.6 : 0.05;
+        this.groundProbe.set(this.position.x, previousY, this.position.z);
+        const ground = this.collision.sampleGround(this.groundProbe, stepHeight, fallDistance + 4);
+        if (this.flying) {
+            if (this.position.y < ground.y) {
+                this.position.y = ground.y;
+                this.velocity.y = Math.max(0, this.velocity.y);
+            }
+            return;
+        }
+        if (this.position.y <= ground.y + 1e-3 && this.velocity.y <= 0) {
+            this.position.y = ground.y;
+            this.velocity.y = 0;
+            this.onGround = true;
+            this.jumpsUsed = 0;
+        }
+        else {
+            this.onGround = false;
+        }
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/movement/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/movement/controller.ts"],"names":[],"mappings":"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"}

package/dist/net/adapter.d.ts

@@ -0,0 +1,22 @@
+import type { NetworkAdapter, PlayerState } from '../types.js';
+/**
+ * Multiplayer is intentionally NOT implemented. This file exists to pin down
+ * the seam so the runtime stays easy to network later:
+ *
+ *  - the local player is simulated from serializable `PlayerState`, so a peer's
+ *    state can drive an identical avatar with no movement-code changes;
+ *  - the runtime exposes `update(dt)` separately from rendering, so a fixed
+ *    network tick can drive it;
+ *  - nothing in movement/camera/portals reaches for a global connection.
+ *
+ * Expected eventual topologies, in order of how much WorldMesh has to host:
+ *  1. peer-to-peer WebRTC, worlds exchange state directly;
+ *  2. a multiplayer server run by the world's own creator;
+ *  3. optional WorldMesh signaling/discovery only (no game traffic);
+ *  4. an optional hosted fallback, last resort.
+ */
+export type { NetworkAdapter, PlayerState };
+/** Round trip a player state over the wire. Kept tiny on purpose. */
+export declare function serializePlayerState(state: PlayerState): string;
+export declare function deserializePlayerState(payload: string): PlayerState;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/net/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/net/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AAE5C,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAEnE"}

package/dist/net/adapter.js

@@ -0,0 +1,8 @@
+/** Round trip a player state over the wire. Kept tiny on purpose. */
+export function serializePlayerState(state) {
+    return JSON.stringify(state);
+}
+export function deserializePlayerState(payload) {
+    return JSON.parse(payload);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/net/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/net/adapter.ts"],"names":[],"mappings":"AAoBA,qEAAqE;AACrE,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;AAC5C,CAAC"}

package/dist/player/avatar.d.ts

@@ -0,0 +1,29 @@
+import { Group, type Object3D } from 'three';
+/** Faces the default figure can pull, in number-key order (1–9, then 0). */
+export declare const AVATAR_EXPRESSIONS: readonly ["smile", "grin", "laugh", "wink", "love", "surprised", "sad", "angry", "sleepy", "neutral"];
+export type AvatarExpression = (typeof AVATAR_EXPRESSIONS)[number];
+/** The expression bound to a number key: 1 is the first, 0 the tenth. */
+export declare function expressionForDigit(digit: number): AvatarExpression | null;
+export declare function isAvatarExpression(value: unknown): value is AvatarExpression;
+export interface AvatarMotion {
+    dt: number;
+    /** Horizontal speed in metres per second. */
+    speed: number;
+    grounded: boolean;
+    /** Direction of travel as a yaw, used to turn the body in third person. */
+    heading?: number;
+}
+export declare function createDefaultAvatar(height?: number): Group;
+/**
+ * Change the face of an avatar made by `createDefaultAvatar`. Unknown names
+ * and custom avatars are ignored.
+ */
+export declare function setAvatarExpression(avatar: Object3D, expression: string): void;
+export declare function getAvatarExpression(avatar: Object3D): AvatarExpression | null;
+/**
+ * Swing the limbs of an avatar made by `createDefaultAvatar`. Call once per
+ * frame with how fast it is moving; anything else is ignored, so it is safe
+ * to call on custom avatars too.
+ */
+export declare function animateDefaultAvatar(avatar: Object3D, motion: AvatarMotion): void;
+//# sourceMappingURL=avatar.d.ts.map

package/dist/player/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/player/avatar.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,EAYL,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAaf,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,uGAWrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAGzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAmBD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,wBAAgB,mBAAmB,CAAC,MAAM,SAAM,GAAG,KAAK,CA0FvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAK9E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,IAAI,CAG7E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA6BjF"}