@rapierphysicsplugin/client 1.0.0

package/dist/interpolator.js

@@ -0,0 +1,198 @@
+import { INTERPOLATION_BUFFER_SIZE, BROADCAST_RATE } from '@rapierphysicsplugin/shared';
+export class Interpolator {
+    constructor(renderDelayMs) {
+        this.buffers = new Map();
+        this._stats = this._emptyStats();
+        // Default render delay: ~3x broadcast interval to absorb jitter
+        this.renderDelay = renderDelayMs ?? (3 * (1000 / BROADCAST_RATE));
+    }
+    _emptyStats() {
+        return {
+            interpolatedCount: 0,
+            extrapolatedCount: 0,
+            staleCount: 0,
+            emptyCount: 0,
+            renderDelay: this?.renderDelay ?? 0,
+            sampleBodyId: null,
+            sampleBufferLen: 0,
+            sampleRenderTime: 0,
+            sampleBufferOldest: 0,
+            sampleBufferNewest: 0,
+            sampleT: 0,
+        };
+    }
+    /** Reset stats at the start of each render frame, then call getInterpolatedState per body */
+    resetStats() {
+        this._stats = this._emptyStats();
+        this._stats.renderDelay = this.renderDelay;
+    }
+    getStats() {
+        return this._stats;
+    }
+    addSnapshot(bodyId, state, timestamp) {
+        if (!this.buffers.has(bodyId)) {
+            this.buffers.set(bodyId, []);
+        }
+        const buffer = this.buffers.get(bodyId);
+        // Guard against duplicate or out-of-order timestamps (TCP can burst after stalls)
+        if (buffer.length > 0 && timestamp <= buffer[buffer.length - 1].timestamp) {
+            return;
+        }
+        buffer.push({ timestamp, state });
+        // Keep buffer limited
+        while (buffer.length > INTERPOLATION_BUFFER_SIZE + 1) {
+            buffer.shift();
+        }
+    }
+    getInterpolatedState(bodyId, currentTime) {
+        const buffer = this.buffers.get(bodyId);
+        if (!buffer || buffer.length === 0) {
+            this._stats.emptyCount++;
+            return null;
+        }
+        // Render time is behind real time by renderDelay
+        const renderTime = currentTime - this.renderDelay;
+        // Capture sample diagnostics for the first body we see with data
+        if (!this._stats.sampleBodyId) {
+            this._stats.sampleBodyId = bodyId;
+            this._stats.sampleBufferLen = buffer.length;
+            this._stats.sampleRenderTime = renderTime;
+            this._stats.sampleBufferOldest = buffer[0].timestamp;
+            this._stats.sampleBufferNewest = buffer[buffer.length - 1].timestamp;
+        }
+        // Find the two snapshots to interpolate between
+        let older = null;
+        let newer = null;
+        for (let i = 0; i < buffer.length - 1; i++) {
+            if (buffer[i].timestamp <= renderTime && buffer[i + 1].timestamp >= renderTime) {
+                older = buffer[i];
+                newer = buffer[i + 1];
+                break;
+            }
+        }
+        // If we have two bracketing snapshots, interpolate
+        if (older && newer) {
+            const dtMs = newer.timestamp - older.timestamp;
+            const t = (renderTime - older.timestamp) / dtMs;
+            const dtSec = dtMs / 1000;
+            this._stats.interpolatedCount++;
+            if (this._stats.sampleBodyId === bodyId) {
+                this._stats.sampleT = t;
+            }
+            return interpolateBodyState(older.state, newer.state, t, dtSec);
+        }
+        // If render time is past all snapshots, extrapolate from last
+        const last = buffer[buffer.length - 1];
+        if (renderTime > last.timestamp) {
+            const dt = (renderTime - last.timestamp) / 1000;
+            this._stats.extrapolatedCount++;
+            return extrapolateBodyState(last.state, dt);
+        }
+        // If render time is before all snapshots, return earliest
+        this._stats.staleCount++;
+        return buffer[0].state;
+    }
+    removeBody(bodyId) {
+        this.buffers.delete(bodyId);
+    }
+    clear() {
+        this.buffers.clear();
+    }
+}
+function interpolateBodyState(a, b, t, dtSec) {
+    // Scale velocity tangents by dt so they match the Hermite parameter space (t: 0→1)
+    // Raw velocities are in units/second; tangents need to be in units/interval
+    const scaledVelA = { x: a.linVel.x * dtSec, y: a.linVel.y * dtSec, z: a.linVel.z * dtSec };
+    const scaledVelB = { x: b.linVel.x * dtSec, y: b.linVel.y * dtSec, z: b.linVel.z * dtSec };
+    return {
+        id: a.id,
+        position: hermiteInterpolateVec3(a.position, scaledVelA, b.position, scaledVelB, t),
+        rotation: slerpQuat(a.rotation, b.rotation, t),
+        linVel: lerpVec3(a.linVel, b.linVel, t),
+        angVel: lerpVec3(a.angVel, b.angVel, t),
+    };
+}
+function extrapolateBodyState(state, dt) {
+    // Simple linear extrapolation with velocity decay
+    const decay = Math.max(0, 1 - dt * 2); // Decay over 0.5 seconds
+    return {
+        id: state.id,
+        position: {
+            x: state.position.x + state.linVel.x * dt * decay,
+            y: state.position.y + state.linVel.y * dt * decay,
+            z: state.position.z + state.linVel.z * dt * decay,
+        },
+        rotation: state.rotation, // Don't extrapolate rotation
+        linVel: {
+            x: state.linVel.x * decay,
+            y: state.linVel.y * decay,
+            z: state.linVel.z * decay,
+        },
+        angVel: {
+            x: state.angVel.x * decay,
+            y: state.angVel.y * decay,
+            z: state.angVel.z * decay,
+        },
+    };
+}
+function hermiteInterpolateVec3(p0, v0, p1, v1, t) {
+    // Hermite basis functions
+    const t2 = t * t;
+    const t3 = t2 * t;
+    const h00 = 2 * t3 - 3 * t2 + 1;
+    const h10 = t3 - 2 * t2 + t;
+    const h01 = -2 * t3 + 3 * t2;
+    const h11 = t3 - t2;
+    return {
+        x: h00 * p0.x + h10 * v0.x + h01 * p1.x + h11 * v1.x,
+        y: h00 * p0.y + h10 * v0.y + h01 * p1.y + h11 * v1.y,
+        z: h00 * p0.z + h10 * v0.z + h01 * p1.z + h11 * v1.z,
+    };
+}
+function lerpVec3(a, b, t) {
+    return {
+        x: a.x + (b.x - a.x) * t,
+        y: a.y + (b.y - a.y) * t,
+        z: a.z + (b.z - a.z) * t,
+    };
+}
+function slerpQuat(a, b, t) {
+    let dot = a.x * b.x + a.y * b.y + a.z * b.z + a.w * b.w;
+    // If dot is negative, negate one quaternion to take the shorter path
+    let bx = b.x, by = b.y, bz = b.z, bw = b.w;
+    if (dot < 0) {
+        dot = -dot;
+        bx = -bx;
+        by = -by;
+        bz = -bz;
+        bw = -bw;
+    }
+    // If quaternions are very close, use linear interpolation
+    if (dot > 0.9995) {
+        return normalizeQuat({
+            x: a.x + (bx - a.x) * t,
+            y: a.y + (by - a.y) * t,
+            z: a.z + (bz - a.z) * t,
+            w: a.w + (bw - a.w) * t,
+        });
+    }
+    const theta0 = Math.acos(dot);
+    const theta = theta0 * t;
+    const sinTheta = Math.sin(theta);
+    const sinTheta0 = Math.sin(theta0);
+    const s0 = Math.cos(theta) - dot * sinTheta / sinTheta0;
+    const s1 = sinTheta / sinTheta0;
+    return {
+        x: s0 * a.x + s1 * bx,
+        y: s0 * a.y + s1 * by,
+        z: s0 * a.z + s1 * bz,
+        w: s0 * a.w + s1 * bw,
+    };
+}
+function normalizeQuat(q) {
+    const len = Math.sqrt(q.x * q.x + q.y * q.y + q.z * q.z + q.w * q.w);
+    if (len === 0)
+        return { x: 0, y: 0, z: 0, w: 1 };
+    return { x: q.x / len, y: q.y / len, z: q.z / len, w: q.w / len };
+}
+//# sourceMappingURL=interpolator.js.map

package/dist/interpolator.js.map

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

package/dist/networked-rapier-plugin.d.ts

@@ -0,0 +1,82 @@
+import type RAPIER from '@dimforge/rapier3d-compat';
+import { Vector3, Quaternion, PhysicsMotionType, PhysicsShapeType, PhysicsBody, PhysicsShape } from '@babylonjs/core';
+import type { PhysicsShapeParameters, PhysicsMaterial } from '@babylonjs/core';
+import type { Scene, Nullable } from '@babylonjs/core';
+import type { InputAction, CollisionEventData, RoomSnapshot, ComputeConfig } from '@rapierphysicsplugin/shared';
+import { RapierPlugin } from './rapier-plugin.js';
+import { PhysicsSyncClient } from './sync-client.js';
+export interface NetworkedRapierPluginConfig {
+    serverUrl: string;
+    roomId: string;
+    compute?: ComputeConfig;
+}
+export declare class NetworkedRapierPlugin extends RapierPlugin {
+    private syncClient;
+    private scene;
+    private bodyToId;
+    private idToBody;
+    private pendingBodies;
+    private shapeParamsCache;
+    private pendingDescriptors;
+    private remoteBodyCreationIds;
+    private remoteBodies;
+    private geometryCache;
+    private sentGeometryHashes;
+    private materialCache;
+    private textureCache;
+    private sentMaterialHashes;
+    private sentTextureHashes;
+    private textureObjectUrls;
+    private collisionCount;
+    private config;
+    private simulationResetCallbacks;
+    private stateUpdateCallbacks;
+    constructor(rapier: typeof RAPIER, gravity: Vector3, config: NetworkedRapierPluginConfig);
+    /**
+     * Connect to the physics server and join the configured room.
+     * Optionally pass the scene for remote body mesh creation.
+     */
+    connect(scene?: Scene): Promise<RoomSnapshot>;
+    initBody(body: PhysicsBody, motionType: PhysicsMotionType, position: Vector3, orientation: Quaternion): void;
+    initShape(shape: PhysicsShape, type: PhysicsShapeType, options: PhysicsShapeParameters): void;
+    setShape(body: PhysicsBody, shape: Nullable<PhysicsShape>): void;
+    setMaterial(shape: PhysicsShape, material: PhysicsMaterial): void;
+    executeStep(delta: number, bodies: Array<PhysicsBody>): void;
+    sync(body: PhysicsBody): void;
+    removeBody(body: PhysicsBody): void;
+    private handleBodyAdded;
+    private createRemoteBody;
+    private handleBodyRemoved;
+    private handleSimulationStarted;
+    private buildDescriptor;
+    private shapeInfoToDescriptor;
+    private sendMeshBinaryForBody;
+    private handleMeshBinaryReceived;
+    private handleGeometryDefReceived;
+    private handleMeshRefReceived;
+    private handleMaterialDefReceived;
+    private handleTextureDefReceived;
+    private extractAndSendTexture;
+    private createTextureFromCache;
+    private createMeshFromDescriptor;
+    private createShapeFromDescriptor;
+    private motionTypeToWire;
+    private motionTypeFromWire;
+    startSimulation(): void;
+    sendInput(actions: InputAction[]): void;
+    onCollisionEvents(callback: (events: CollisionEventData[]) => void): void;
+    onSimulationReset(callback: () => void): void;
+    onStateUpdate(callback: (state: RoomSnapshot) => void): void;
+    getSyncClient(): PhysicsSyncClient;
+    getClientId(): string | null;
+    get simulationRunning(): boolean;
+    get totalBodyCount(): number;
+    get bytesSent(): number;
+    get bytesReceived(): number;
+    get collisionEventCount(): number;
+    /** Access the underlying reconciler for debug stats */
+    getReconciler(): import("./state-reconciler.js").StateReconciler;
+    /** Access the clock sync for debug stats */
+    getClockSync(): import("./clock-sync.js").ClockSyncClient;
+}
+//# sourceMappingURL=networked-rapier-plugin.d.ts.map

package/dist/networked-rapier-plugin.d.ts.map

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