three-procedural-locomotionProcedural human locomotion for Three.js

Walks, runs, turns, crouches, jumps and goes to a point over any ground, without baked animations. Everything is computed every frame from a speed and a heading.

Get started

Try the lab

GitHub

Loading…

Measured against real people

Cadence, stride, foot roll, the path of the foot in the air, knees and arms are tuned with CMU motion capture, and a test checks it.

Walking and running, one gait

It walks up to ~1.7 m/s and then gradually breaks into a run, with a flight phase, hip bounce and torso lean, like a person.

Feet on the terrain

Heel → sole → toe, tilting over bumps and slopes, low steps and toe clearance during the swing, with Two-Bone IK on each leg.

Point and click, turns and touch

moveTo reaches the destination, turns around like a person when it is behind, and the hand can rest on walls, columns and railings when passing by.

Any size, any rig

Mixamo and Rigify included, any other skeleton with a bone mapping. Lengths, speeds and rhythm scale with the size of the character.

Tunable and fast

Four styles, eleven basic controls and 116 validated parameters, adjustable at runtime. About 0.1–0.2 ms per character and frame.

Quick example

import { createProceduralHuman, mixamoMapping } from 'three-procedural-locomotion';

const human = createProceduralHuman({
  model: gltf.scene,      // humanoid model with a skeleton
  mapping: mixamoMapping, // which bone is each part of the body
  ground: [floorMesh],    // what counts as ground
  preset: 'athletic',     // optional: walking style
});

human.moveTo(point, { run: true });                 // go to a point…
human.targetSpeed = 1.2; human.targetHeading = 0.5; // …or continuous control (m/s, rad)
human.jump();

// every frame
human.update(dt);

Read the introduction and the user guide, or open the lab to see it move and tune every parameter live.