three-procedural-locomotionLocomoción humana procedural para Three.js

Camina, corre, gira, se agacha, salta y va hasta un punto sobre cualquier suelo, sin animaciones grabadas. Todo se calcula cada frame a partir de una velocidad y un rumbo.

Empezar

Probar el laboratorio

GitHub

Cargando…

Medida contra personas reales

Cadencia, zancada, rodado del pie, trayectoria del pie en el aire, rodillas y brazos están ajustados con capturas de movimiento de CMU, y un test lo comprueba.

Caminar y correr, una sola marcha

Camina hasta ~1,7 m/s y después pasa gradualmente a correr, con fase de vuelo, rebote de caderas e inclinación del torso, como una persona.

Pies sobre el terreno

Talón → planta → punta, inclinación sobre baches y pendientes, escalones bajos y margen de la punta en el aire, con Two-Bone IK en cada pierna.

Point and click, giros y tocar

moveTo llega al destino, da la vuelta como una persona si queda detrás, y la mano puede apoyarse en paredes, columnas y barandas al pasar.

Cualquier tamaño, cualquier rig

Mixamo y Rigify incluidos, cualquier otro esqueleto con un mapping de huesos. Longitudes, velocidades y ritmo se adaptan al tamaño del personaje.

Ajustable y rápida

Cuatro estilos, once controles básicos y 116 parámetros validados, ajustables en ejecución. Unos 0,1–0,2 ms por personaje y frame.

Ejemplo rápido

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

const human = createProceduralHuman({
  model: gltf.scene,      // modelo humanoide con esqueleto
  mapping: mixamoMapping, // qué bone es cada parte del cuerpo
  ground: [floorMesh],    // qué cuenta como suelo
  preset: 'athletic',     // opcional: estilo de marcha
});

human.moveTo(point, { run: true });                 // ir a un punto…
human.targetSpeed = 1.2; human.targetHeading = 0.5; // …o control continuo (m/s, rad)
human.jump();

// cada frame
human.update(dt);

Lee la introducción y la guía de uso, o abre el laboratorio para verla moverse y ajustar cada parámetro en vivo.