@oyna360/lobby-sdk 0.1.0

package/dist/humanoid-animator.js

@@ -0,0 +1,191 @@
+import { pickAvatarClip } from './avatar-clips';
+import { HumanoidPose, RUN_GAIT, WALK_GAIT, approach, cloneGait, footContacts, gaitFrequency, lerpGait, writeAirPose, writeGaitPose, writeIdlePose, writeSlidePose, } from './humanoid-locomotion';
+import { applyHumanoidPose } from './humanoid-rig';
+/** Nominal speeds used to normalise cadence when a caller reports no velocity. */
+const DEFAULT_WALK_SPEED = 10.5;
+const DEFAULT_RUN_SPEED = 13.65;
+/** Blend times, seconds. Start-up is a touch faster than wind-down. */
+const BLEND_IN = 0.11;
+const BLEND_OUT = 0.16;
+const RUN_BLEND = 0.2;
+const AIR_BLEND = 0.07;
+const SLIDE_BLEND = 0.12;
+/**
+ * Legacy 6-pivot fallback (box avatars and GLBs whose skeleton could not be
+ * mapped). Character-space angles → local Euler on plain pivot nodes.
+ */
+function applySimplePose(rig, pose) {
+    setPivot(rig, 'torso', pose.pitch('chest') + pose.pitch('spine'), pose.yaw('chest'), pose.roll('chest'));
+    setPivot(rig, 'head', pose.pitch('head'), pose.yaw('head'), pose.roll('head'));
+    setPivot(rig, 'armL', pose.pitch('upperArmL'), pose.yaw('upperArmL'), pose.roll('upperArmL'));
+    setPivot(rig, 'armR', pose.pitch('upperArmR'), pose.yaw('upperArmR'), pose.roll('upperArmR'));
+    setPivot(rig, 'legL', pose.pitch('thighL'), pose.yaw('thighL'), pose.roll('thighL'));
+    setPivot(rig, 'legR', pose.pitch('thighR'), pose.yaw('thighR'), pose.roll('thighR'));
+}
+function setPivot(rig, limb, pitch, yaw, roll) {
+    const node = rig[limb];
+    // Pivots hang down the -Y axis, so a forward swing is a negative X rotation.
+    const x = -pitch;
+    const y = -yaw;
+    const rest = rig.restRotation?.[limb];
+    if (rig.boneDriven && rest) {
+        node.rotationQuaternion = null;
+        node.rotation.set(rest.x + x, rest.y + y, rest.z + roll);
+        return;
+    }
+    node.rotation.set(x, y, roll);
+}
+export class HumanoidAnimator {
+    avatar;
+    time = 0;
+    phase = 0;
+    walkWeight = 0;
+    runWeight = 0;
+    airWeight = 0;
+    slideWeight = 0;
+    speed = 0;
+    pendingContacts = 0;
+    clipStepAcc = 0;
+    slideMode = false;
+    walkSpeedRef = DEFAULT_WALK_SPEED;
+    runSpeedRef = DEFAULT_RUN_SPEED;
+    pose = new HumanoidPose();
+    gait = cloneGait(WALK_GAIT);
+    groups;
+    activeClip = null;
+    constructor(avatar, animationGroups) {
+        this.avatar = avatar;
+        const groups = animationGroups?.length ? animationGroups : avatar.animationGroups;
+        this.groups = groups.length ? groups : null;
+    }
+    setSlideMode(on) {
+        this.slideMode = on;
+    }
+    /** Lets cadence be normalised against the lobby's configured move speeds. */
+    setSpeedReference(walkSpeed, runSpeed) {
+        if (walkSpeed > 0.1)
+            this.walkSpeedRef = walkSpeed;
+        if (runSpeed > 0.1)
+            this.runSpeedRef = runSpeed;
+    }
+    /**
+     * @param speed horizontal speed in units/s; drives stride cadence so the feet
+     *              cannot scrub the floor. Omit to fall back to nominal speeds.
+     */
+    update(dt, state, grounded, speed) {
+        if (this.groups) {
+            this.playClip(state);
+            return;
+        }
+        const rig = this.avatar.rig;
+        if (!rig)
+            return;
+        const humanoid = rig.humanoid ?? null;
+        // Unskinned rigid GLB: no limb bones — keep the visual stable.
+        if (this.avatar.rigidGlb && !rig.boneDriven) {
+            rig.visual.position.y = 0;
+            return;
+        }
+        const step = dt > 0.1 ? 0.1 : dt;
+        this.time += step;
+        const moving = state === 'walk' || state === 'run';
+        const airborne = state === 'jump' || (state === 'fall' && !grounded);
+        const running = state === 'run';
+        this.walkWeight = approach(this.walkWeight, moving ? 1 : 0, moving ? BLEND_IN : BLEND_OUT, step);
+        this.runWeight = approach(this.runWeight, running ? 1 : 0, RUN_BLEND, step);
+        this.airWeight = approach(this.airWeight, airborne ? 1 : 0, AIR_BLEND, step);
+        this.slideWeight = approach(this.slideWeight, this.slideMode ? 1 : 0, SLIDE_BLEND, step);
+        const reference = this.walkSpeedRef + (this.runSpeedRef - this.walkSpeedRef) * this.runWeight;
+        const measured = speed !== undefined
+            ? speed
+            : moving
+                ? running
+                    ? this.runSpeedRef
+                    : this.walkSpeedRef
+                : 0;
+        // Smooth the reported speed so accel/decel does not jitter the cadence.
+        this.speed = approach(this.speed, measured, 0.12, step);
+        lerpGait(this.gait, WALK_GAIT, RUN_GAIT, this.runWeight);
+        const ratio = reference > 0.01 ? this.speed / reference : 0;
+        const advance = gaitFrequency(this.speed, reference, this.gait) * step;
+        if (this.walkWeight > 0.02) {
+            this.pendingContacts += footContacts(this.phase, advance);
+            this.phase += advance;
+            if (this.phase >= 1 || this.phase < 0)
+                this.phase -= Math.floor(this.phase);
+        }
+        const groundWeight = (1 - this.airWeight) * (1 - this.slideWeight);
+        // Shorter steps at low speed, full stride at cruising speed.
+        const strideScale = 0.55 + 0.45 * (ratio < 0.4 ? 0.4 : ratio > 1 ? 1 : ratio);
+        const gaitWeight = this.walkWeight * groundWeight * strideScale;
+        this.pose.reset();
+        writeIdlePose(this.pose, this.time, groundWeight * (1 - this.walkWeight));
+        writeGaitPose(this.pose, this.phase, this.gait, gaitWeight);
+        if (this.airWeight > 0.002) {
+            writeAirPose(this.pose, state === 'jump', this.airWeight * (1 - this.slideWeight));
+        }
+        if (this.slideWeight > 0.002)
+            writeSlidePose(this.pose, this.slideWeight);
+        if (humanoid) {
+            applyHumanoidPose(humanoid, this.pose);
+        }
+        else {
+            applySimplePose(rig, this.pose);
+            if (!rig.boneDriven)
+                rig.torso.position.y = 1.18;
+        }
+        rig.visual.position.y = this.pose.bob;
+    }
+    /** True on each visual foot plant (walk / run), for footstep audio. */
+    takeFootPlant(state, dt = 1 / 60) {
+        if (state !== 'walk' && state !== 'run') {
+            this.pendingContacts = 0;
+            this.clipStepAcc = 0;
+            return false;
+        }
+        const rig = this.avatar.rig;
+        const posed = !this.groups && !(this.avatar.rigidGlb && !rig?.boneDriven);
+        if (!posed) {
+            this.clipStepAcc += dt;
+            const interval = state === 'run' ? 0.28 : 0.42;
+            if (this.clipStepAcc >= interval) {
+                this.clipStepAcc = 0;
+                return true;
+            }
+            return false;
+        }
+        if (this.pendingContacts <= 0)
+            return false;
+        this.pendingContacts--;
+        return this.walkWeight > 0.35;
+    }
+    playClip(state) {
+        if (!this.groups)
+            return;
+        const match = pickAvatarClip(this.groups, state);
+        // No Idle/Jump clip (common for Meshy walk-only packs) → freeze bind pose.
+        if (!match) {
+            if (!this.activeClip && !this.groups.some((g) => g.isPlaying))
+                return;
+            for (const g of this.groups) {
+                if (g.isPlaying)
+                    g.stop();
+                g.reset();
+            }
+            this.activeClip = null;
+            return;
+        }
+        if (this.activeClip === match && match.isPlaying)
+            return;
+        for (const g of this.groups) {
+            if (g === match)
+                continue;
+            if (g.isPlaying)
+                g.stop();
+        }
+        if (!match.isPlaying)
+            match.start(true);
+        this.activeClip = match;
+    }
+}
+//# sourceMappingURL=humanoid-animator.js.map

package/dist/humanoid-animator.js.map

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

package/dist/humanoid-bone-names.d.ts

@@ -0,0 +1,35 @@
+import type { HumanoidJoint } from './humanoid-locomotion';
+/**
+ * Skeleton name → humanoid joint resolution (pure, no Babylon import).
+ *
+ * Rig naming is wildly inconsistent (Mixamo `LeftUpLeg`, Meshy `LeftLeg` for the
+ * shin, Tripo `L_Thigh`, Blender `thigh.L`), and spine chains are sometimes
+ * numbered downwards (`Hips → Spine02 → Spine01 → Spine`). So roles come from
+ * name patterns while ordering comes from the real hierarchy depth.
+ */
+export type BoneRole = 'hips' | 'spineish' | 'neck' | 'head' | 'shoulder' | 'upperArm' | 'foreArm' | 'hand' | 'thigh' | 'shin' | 'foot';
+export type BoneSide = 'L' | 'R';
+export interface BoneRef {
+    name: string;
+    /** Distance from the hierarchy root; used to order chains and skip helpers. */
+    depth: number;
+}
+export declare function normalizeBoneName(name: string): string;
+export declare function detectBoneSide(raw: string): BoneSide | null;
+/** Strips side markers without eating letters ("LeftLeg" → "leg", "L_Thigh" → "thigh"). */
+export declare function boneCoreName(raw: string): string;
+export declare function detectBoneRole(core: string): BoneRole | null;
+export interface ClassifiedBone<T extends BoneRef> {
+    ref: T;
+    role: BoneRole;
+    side: BoneSide | null;
+}
+export declare function classifyBone<T extends BoneRef>(ref: T): ClassifiedBone<T> | null;
+/** Joints without which no believable walk cycle is possible. */
+export declare const REQUIRED_JOINTS: HumanoidJoint[];
+export declare function resolveHumanoidJoints<T extends BoneRef>(refs: readonly T[]): {
+    joints: Partial<Record<"head" | "hips" | "spine" | "chest" | "neck" | "shoulderL" | "shoulderR" | "upperArmL" | "upperArmR" | "foreArmL" | "foreArmR" | "handL" | "handR" | "thighL" | "thighR" | "shinL" | "shinR" | "footL" | "footR", T>>;
+    missing: ("head" | "hips" | "spine" | "chest" | "neck" | "shoulderL" | "shoulderR" | "upperArmL" | "upperArmR" | "foreArmL" | "foreArmR" | "handL" | "handR" | "thighL" | "thighR" | "shinL" | "shinR" | "footL" | "footR")[];
+    classified: ClassifiedBone<T>[];
+};
+//# sourceMappingURL=humanoid-bone-names.d.ts.map

package/dist/humanoid-bone-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"humanoid-bone-names.d.ts","sourceRoot":"","sources":["../src/humanoid-bone-names.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;GAOG;AAEH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,CAAC;AAEjC,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,UAE7C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAM3D;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,UAMvC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAK5D;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO;IAC/C,GAAG,EAAE,CAAC,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAQhF;AAuCD,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,aAAa,EAK1C,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE;;;;EA8B1E"}

package/dist/humanoid-bone-names.js

@@ -0,0 +1,126 @@
+/** Nodes that are containers or leaf markers, never animated joints. */
+const IGNORED = /^(__root__|root|armature|scene|world|skeleton|humanoidrootnode|mesh_?\d*)(__a\d+)?$/;
+const TIP = /(end|tip|nub|front|top)$/;
+const ROLE_PATTERNS = [
+    [/^hips?\d*$|pelvis/, 'hips'],
+    [/spine|chest|torso|waist|abdomen|upperbody|ribcage/, 'spineish'],
+    [/neck/, 'neck'],
+    [/^head\d*$/, 'head'],
+    [/shoulder|clavicle|collar/, 'shoulder'],
+    [/forearm|lowerarm|elbow/, 'foreArm'],
+    [/upperarm|^arm\d*$|humerus/, 'upperArm'],
+    [/^hand\d*$|wrist/, 'hand'],
+    [/upleg|thigh|upperleg|femur/, 'thigh'],
+    [/lowerleg|^leg\d*$|calf|shin|knee|tibia/, 'shin'],
+    [/^foot\d*$|ankle/, 'foot'],
+];
+export function normalizeBoneName(name) {
+    return name.toLowerCase().replace(/^mixamorig[:_]?/, '');
+}
+export function detectBoneSide(raw) {
+    if (raw.includes('left'))
+        return 'L';
+    if (raw.includes('right'))
+        return 'R';
+    if (/(^|[_.\- ])l([_.\- ]|\d|$)/.test(raw))
+        return 'L';
+    if (/(^|[_.\- ])r([_.\- ]|\d|$)/.test(raw))
+        return 'R';
+    return null;
+}
+/** Strips side markers without eating letters ("LeftLeg" → "leg", "L_Thigh" → "thigh"). */
+export function boneCoreName(raw) {
+    return raw
+        .replace(/left|right/g, '')
+        .replace(/(^|[_.\- ])[lr]([_.\- ])/g, '$1')
+        .replace(/(^|[_.\- ])[lr]$/, '')
+        .replace(/[^a-z0-9]/g, '');
+}
+export function detectBoneRole(core) {
+    for (const [pattern, role] of ROLE_PATTERNS) {
+        if (pattern.test(core))
+            return role;
+    }
+    return null;
+}
+export function classifyBone(ref) {
+    const raw = normalizeBoneName(ref.name);
+    if (IGNORED.test(raw))
+        return null;
+    const core = boneCoreName(raw);
+    if (!core || TIP.test(core) || core.startsWith('toe'))
+        return null;
+    const role = detectBoneRole(core);
+    if (!role)
+        return null;
+    return { ref, role, side: detectBoneSide(raw) };
+}
+/** Shallowest wins: primary bones sit above twist/helper bones in the hierarchy. */
+function pickPrimary(bones, role, side) {
+    let best = null;
+    for (const bone of bones) {
+        if (bone.role !== role || bone.side !== side)
+            continue;
+        if (!best ||
+            bone.ref.depth < best.ref.depth ||
+            (bone.ref.depth === best.ref.depth && bone.ref.name.length < best.ref.name.length)) {
+            best = bone;
+        }
+    }
+    return best?.ref ?? null;
+}
+const SIDED = [
+    ['shoulderL', 'shoulder', 'L'],
+    ['shoulderR', 'shoulder', 'R'],
+    ['upperArmL', 'upperArm', 'L'],
+    ['upperArmR', 'upperArm', 'R'],
+    ['foreArmL', 'foreArm', 'L'],
+    ['foreArmR', 'foreArm', 'R'],
+    ['handL', 'hand', 'L'],
+    ['handR', 'hand', 'R'],
+    ['thighL', 'thigh', 'L'],
+    ['thighR', 'thigh', 'R'],
+    ['shinL', 'shin', 'L'],
+    ['shinR', 'shin', 'R'],
+    ['footL', 'foot', 'L'],
+    ['footR', 'foot', 'R'],
+];
+/** Joints without which no believable walk cycle is possible. */
+export const REQUIRED_JOINTS = [
+    'thighL',
+    'thighR',
+    'upperArmL',
+    'upperArmR',
+];
+export function resolveHumanoidJoints(refs) {
+    const bones = [];
+    for (const ref of refs) {
+        const classified = classifyBone(ref);
+        if (classified)
+            bones.push(classified);
+    }
+    const joints = {};
+    const assign = (joint, role, side) => {
+        const found = pickPrimary(bones, role, side);
+        if (found)
+            joints[joint] = found;
+    };
+    assign('hips', 'hips', null);
+    assign('neck', 'neck', null);
+    assign('head', 'head', null);
+    for (const [joint, role, side] of SIDED)
+        assign(joint, role, side);
+    // Depth, not the number in the name, decides which vertebra is the chest:
+    // Meshy exports `Hips → Spine02 → Spine01 → Spine`, Mixamo does the reverse.
+    const spineChain = bones
+        .filter((b) => b.role === 'spineish')
+        .sort((a, b) => a.ref.depth - b.ref.depth || a.ref.name.length - b.ref.name.length);
+    if (spineChain.length) {
+        joints.spine = spineChain[0].ref;
+        if (spineChain.length > 1)
+            joints.chest = spineChain[spineChain.length - 1].ref;
+    }
+    const missing = REQUIRED_JOINTS.filter((joint) => !joints[joint]);
+    return { joints, missing, classified: bones };
+}
+//# sourceMappingURL=humanoid-bone-names.js.map

package/dist/humanoid-bone-names.js.map

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

package/dist/humanoid-locomotion.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Procedural humanoid locomotion (pure math, no Babylon import).
+ *
+ * Angle convention — every value below is expressed in *character space*, so it
+ * stays correct no matter how the GLB skeleton is oriented:
+ *   pitch > 0 → distal end of the bone swings forward (character +Z)
+ *   yaw   > 0 → distal end swings toward the character's left
+ *   roll  > 0 → distal end tilts toward the character's right
+ *
+ * `humanoid-rig.ts` converts these into per-bone parent-space rotations.
+ */
+export declare const HUMANOID_JOINT_INDEX: {
+    readonly hips: 0;
+    readonly spine: 1;
+    readonly chest: 2;
+    readonly neck: 3;
+    readonly head: 4;
+    readonly shoulderL: 5;
+    readonly shoulderR: 6;
+    readonly upperArmL: 7;
+    readonly upperArmR: 8;
+    readonly foreArmL: 9;
+    readonly foreArmR: 10;
+    readonly handL: 11;
+    readonly handR: 12;
+    readonly thighL: 13;
+    readonly thighR: 14;
+    readonly shinL: 15;
+    readonly shinR: 16;
+    readonly footL: 17;
+    readonly footR: 18;
+};
+export type HumanoidJoint = keyof typeof HUMANOID_JOINT_INDEX;
+export declare const HUMANOID_JOINTS: HumanoidJoint[];
+export declare const HUMANOID_JOINT_COUNT: number;
+/** Additive pose buffer — zero allocation per frame. */
+export declare class HumanoidPose {
+    /** [pitch, yaw, roll] per joint, radians. */
+    readonly angles: Float32Array<ArrayBuffer>;
+    /** Vertical body bob in metres (applied to the avatar root, never to bones). */
+    bob: number;
+    reset(): void;
+    add(joint: HumanoidJoint, pitch: number, yaw: number, roll: number, weight?: number): void;
+    pitch(joint: HumanoidJoint): number;
+    yaw(joint: HumanoidJoint): number;
+    roll(joint: HumanoidJoint): number;
+}
+export interface GaitParams {
+    /** Cycles per second at the reference speed (one cycle = two steps). */
+    frequency: number;
+    /** Thigh forward/back amplitude. */
+    thighSwing: number;
+    /** Peak knee flexion at mid-swing. */
+    kneeSwing: number;
+    /** Small knee flexion while the foot carries the body. */
+    kneeStance: number;
+    /** How much the ankle counter-rotates to keep the sole level (0..1). */
+    footLevel: number;
+    /** Extra plantar flexion (toes down) at toe-off. */
+    toeOff: number;
+    armSwing: number;
+    elbowBase: number;
+    elbowSwing: number;
+    /** Constant inward roll so arms stay close to the body. */
+    armTuck: number;
+    shoulderFollow: number;
+    hipsPitch: number;
+    hipsYaw: number;
+    hipsRoll: number;
+    /** Torso counter-rotation against the pelvis. */
+    chestYaw: number;
+    chestRoll: number;
+    /** Forward lean, split between spine and chest. */
+    lean: number;
+    headYaw: number;
+    bob: number;
+}
+export declare const WALK_GAIT: GaitParams;
+export declare const RUN_GAIT: GaitParams;
+/** Cross-fade walk → run in place (same phase, so the blend never snaps). */
+export declare function lerpGait(out: GaitParams, a: GaitParams, b: GaitParams, t: number): GaitParams;
+export declare function cloneGait(source: GaitParams): GaitParams;
+/**
+ * Full walk/run cycle at normalized `phase` (0..1, wraps seamlessly).
+ * Left leg leads at phase 0.25, right leg at 0.75.
+ */
+export declare function writeGaitPose(pose: HumanoidPose, phase: number, g: GaitParams, weight: number): void;
+/** Calm standing pose: planted feet, slow breathing, a touch of sway. */
+export declare function writeIdlePose(pose: HumanoidPose, time: number, weight: number): void;
+export declare function writeAirPose(pose: HumanoidPose, rising: boolean, weight: number): void;
+export declare function writeSlidePose(pose: HumanoidPose, weight: number): void;
+/** Exponential smoothing that is stable for any dt. */
+export declare function approach(current: number, target: number, tau: number, dt: number): number;
+/**
+ * Cadence locked to real speed so the feet never scrub the floor:
+ * frequency scales linearly with velocity, clamped to a believable range.
+ */
+export declare function gaitFrequency(speed: number, referenceSpeed: number, gait: GaitParams): number;
+/** How many foot contacts happen when the cycle advances by `advance` from `prevPhase`. */
+export declare function footContacts(prevPhase: number, advance: number): number;
+//# sourceMappingURL=humanoid-locomotion.d.ts.map

package/dist/humanoid-locomotion.d.ts.map

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