SCL NEXUS // 3D ANIMATION PIPELINE & SSH CLI GUIDE

๐Ÿ”€ Mixamo & M_ Animation Retargeting Tutorial CLI + Runtime Bridge

Citizen Docs Triggers & Saves Guide Admin Planets VR Inner City
UNIVERSAL MIXAMO & M_ DANCE / IDLE COMPATIBILITY

Make Any 3D Model Accept Mixamo & M_ Dance & Idle Animations

Whether you are running a batch upgrade over live server SSH CLI or crossing animations on the fly inside Admin Planets and VR Inner City, the SODAS Retargeting Pipeline maps Mixamo skeletons (mixamorig:*), custom humanoid bones, and even static props so every model responds to M_Dance, M_Dance1..3, M_Idle, M_Perform, M_Walk, M_Run, M_Punch, and M_Down.

โšก Quickest SSH Command
npm run mixamo-m
๐Ÿงช Run Verification Test
npm run mixamo-m:test
Step 1 // Server SSH Terminal

Running the Retargeter on Your Live Server SSH CLI

The CLI script scripts/retarget-mixamo-m-anims.js is built with pure Node.js (fs, path, zlib) with zero native binary dependencies, so it runs out-of-the-box on any Linux or Windows server over SSH and automatically updates both .glb and Brotli-compressed .glb.br files.

A. Upgrade All 17 Core NPC & Giant Models
npm run mixamo-m

Bakes M_Idle, M_Walk, M_Run, M_Punch, M_Down, M_Dance, M_Dance1..3, and M_Perform into all core models in public/_npc/ and regenerates .glb.br files.

B. Run Full Diagnostic & Verification Test
npm run mixamo-m:test

Runs the retargeter and verifies that every model contains valid M_Idle, M_Dance, M_Dance1, M_Perform, M_Walk, M_Run, M_Punch, and M_Down clips.

C. Upgrade All 36 Tripo Ready 3D Models
npm run mixamo-m:tripo

Batch-processes all 36 character/monster models in public/uploads/tripo_ready/models/ and updates their .glb.br files.

D. Target a Single Custom GLB or Directory
node scripts/retarget-mixamo-m-anims.js --target public/_npc/monster/model3.glb --brotli

Use --target <file.glb> for a single model, --dir <folder> for a directory, or --overwrite to refresh existing M_ clips.

Step 2 // Skeleton Architecture

How Cross-Rig Bone Mapping & Proportional Hips Scaling Work

1. Family A: Tripo-Mixamo (67 Joints)

Used by monster/model3.glb, anchor/model.glb, ninja/model3.glb, and all 36 tripo_ready models. Uses meter-scale Y-up mixamorig:* bones. Receives M_Idle..M_Down from anchor/model.glb and M_Dance..M_Perform from kan1.glb + ticketman.glb.

2. Family B: Classic FBX Mixamo

Used by monster/model.glb, monster-x/model.glb, ninja/model2.glb, cyber-shogun/model.glb, and lady/model.glb. Uses centimeter-scale Z-up mixamorig:* bones. Receives M_Idle..M_Down from monster/model.glb and M_Dance / M_Perform from lady/model2.glb (Dance1) & lady/model.glb (Rap).

3. Custom Rigs & Static Meshes

Normalizes bone synonyms (pelvis → hips, thigh_l → leftupleg, upperarm_l → leftarm). Only rotation tracks are applied to limb bones while Hips translation is scaled to the target's rest height so limbs never stretch! Static props receive procedural root-node M_Idle & M_Dance keyframes.

Step 3 // Admin Planets (`admin-planets.html`)

Crossing Stage Crew, Boss & Skybox Giants with M_Dance & M_Idle

  1. Open /admin-planets and navigate to Page 5 (Stage Crew & Big Boss) or Page 6 (Skybox Giants).
  2. In the ๐ŸŽฎ Tripo 3D Monster & Move Simulator Bridge box, locate the purple ๐Ÿ”€ MIXAMO & M_ CROSS-ANIMATION RETARGETER (`M_Dance` / `M_Idle`) bar.
  3. Select your target role (e.g., Oogaloo Crew, Big Oogaloo Boss, Skybox Giants, or All Roles).
  4. Click ๐Ÿ’ƒ Cross Role with M_Dance + M_Idle (or ๐Ÿง Cross Role with M_Idle + M_Perform) to immediately bind the M_ animation suite.
  5. Click โšก Bake `M_` into Selected `.glb` if you want the server to permanently embed the M_ clips into that model's .glb and .glb.br files on disk, then click Save Planet.
Step 4 // VR Inner City (`vr-inner-city.html`)

Crossing Dynamic Scene NPCs with Mixamo / M_ Animations in Real Time

  1. Open /vr (VR Inner City), unlock with your Admin or Creator Key, and open the ๐Ÿ› ๏ธ 3D Level & NPC Studio drawer.
  2. Select any NPC (or click โž• Add Item to spawn a new NPC) and scroll to ๐ŸŽฌ Dynamic NPC Animations, Paths & Cinema Dialogues.
  3. Inside ๐Ÿ”€ Cross Model with Mixamo & M_ Animations (M_Dance / M_Idle):
    • Click ๐Ÿ’ƒ Cross M_Dance + M_Idle to retarget M_Dance, M_Idle, M_Walk, and M_Perform onto the live 3D mesh via window.SODAS_MIXAMO_M_BRIDGE and start dancing immediately.
    • Click ๐ŸŽฌ M_Dance Showreel to set a multi-clip cinema timeline (M_Idle:3000, M_Dance:4500, M_Perform:4000, M_Dance2:4000).
    • Click โšก Bake .GLB to permanently write the retargeted clips into the .glb / .glb.br file on the server.
Step 5 // Live Diagnostic Tool

Inspect or Bake M_ Clips on Any Model Right Now

Ready
Click "๐Ÿ” Scan Embedded Clips" to inspect the model's animations.