Novolis Docs
novolis-governance / completed-plans/standardized_humanoid_model_a1b2c3d4.plan.md

Standardized human model (C4D-style)

Policies that keep the org coherent

dotnetgovernancenovolis

name: Standardized humanoid model overview: Cinema 4D–style shared human standard for Novolis—canonical Mixamo/Unity-compatible skeleton in Simulation.Humanoid, with later mocap import, skinning, ragdoll bridge, and thin game clip banks. Not in novolis-gaming core; games compose the Simulation package. todos:

  • id: humanoid-core

content: Novolis.Simulation.Humanoid — bone enum, hierarchy, T-pose bind, FK pose, two-bone IK, animation clips status: completed

  • id: ragdoll-bridge

content: Map HumanoidBone → Physics.Joints RagdollHumanoidPreset (adapter package or Humanoid.Physics) status: completed

  • id: mocap-import

content: BVH/glTF skin import + retarget into HumanoidPose clips (Assets/Raylib.Loaders extension) status: completed

  • id: skinning

content: Skinned mesh weights + GPU/CPU skin apply (Rendering or app-composed) status: completed

  • id: game-banks

content: Optional Novolis.Game.Humanoid clip masks / locomotion banks PackageReferencing Simulation.Humanoid status: completed

  • id: dogfood-lift

content: Retarget RandoriFight skeleton to consume Simulation.Humanoid status: completed isProject: false

Problem

Cinema 4D / Unity / Mixamo expect one shared biped: named bones, T-pose bind, retargetable animation, mocap in, games out. Today Novolis has:

  • Physics.Joints.RagdollHumanoidPreset — 11 spheres (not Mixamo)
  • RandoriFight dogfood — Mixamo-named IK (app-only)
  • Simulation.View cameras — no bones
  • C4D-lite / SceneLab — hard-surface; animation deferred

Placement (locked)

LayerPackageRole
**Standard**`Novolis.Simulation.Humanoid`Bone ids, hierarchy, bind pose, FK/IK, pose frames, animation clips
**Physics**adapter laterHumanoid → ragdoll spheres
**Import**Assets / loaders laterBVH, Mixamo FBX, glTF skins → clips + optional skin
**Render**apps / RenderingDraw skinned mesh or debug sticks
**Gaming**optional `Novolis.Game.Humanoid`Clip banks / masks only — **not** the skeleton schema

Do not put the canonical skeleton in novolis-gaming, Avalonia.3D, or CAD.

flowchart TB
  subgraph sim [novolis-simulation]
    H[Simulation.Humanoid]
  end
  subgraph phys [novolis-physics]
    R[Joints RagdollHumanoid]
  end
  subgraph assets [import later]
    BVH[BVH / Mixamo / glTF]
  end
  subgraph games [apps + optional Game.Humanoid]
    Banks[clip banks]
    Apps[RandoriFight etc]
  end
  BVH --> H
  H --> R
  H --> Banks
  H --> Apps

Bone standard (v1)

Align with Unity Humanoid / Mixamo naming (retarget + mocap friendly):

Hips → Spine → Spine1 → Spine2 → Neck → Head Hips → LeftUpLeg → LeftLeg → LeftFoot → LeftToeBase (and Right) `Spine2 → LeftShoulder → LeftArm → LeftForeArm → LeftHand` (and Right)

  • Units: meters, ~1.8 m T-pose facing +Z, up +Y (BCL Vector3 / Quaternion)
  • Minimum required bones for a valid avatar ≈ Unity’s 15+ core set; toes/clavicles included
  • Fingers / face / props: later optional bones (not in v1 bind)

v1 API surface

  • HumanoidBone enum + HumanoidHierarchy.Parent
  • HumanoidBindPose.CreateDefaultTPose(heightMeters)
  • HumanoidPose — root translation + local rotations
  • HumanoidPoseSolver.SolveWorld — FK
  • TwoBoneIk.Solve — limb IK
  • HumanoidAnimationClip + sample at time
  • HumanoidBoneNames — Mixamo/Unity alias lookup

Explicit non-goals (v1)

  • Mesh skinning / GPU draw
  • BVH/FBX parsers
  • Finger / facial rigs
  • Cinema 4D file import
  • Putting cameras or voxels in this package

Follow-ons

  1. Ragdoll bridge (11-sphere map)
  2. Mocap/retarget importers
  3. Skinned mesh
  4. Lift RandoriFight onto the package
  5. Optional Novolis.Game.Humanoid banks