Física y Simulaciones 3D
Haz que las escenas 3D se comporten: los cuerpos caen, se apilan, se rompen y reaccionan a clics con masa creíble. Este skill cubre la elección del motor, su conexión con three.js, mantener 60fps y el patrón de impulso al hacer clic usado en secciones hero.
Elegir el motor
- Rapier (
@dimforge/rapier3d-compat) — por defecto. WASM, determinista, mantenido activamente, mejor rendimiento. Usarapier3d-compat(inicialización WASM asíncrona) para bundlers;rapier3d(síncrona) solo para etiquetas script simples. - cannon-es — solo si se debe evitar la carga de WASM (demostraciones con archivos locales, CSP estricto). Más lento y menos mantenido.
- Partículas GPGPU/FBO — para humo, enjambres, nubes de partículas "neuronales IA" (miles o más). No es un motor de física; consulta la sección de GPU más abajo.
Carga Rapier antes de crear cualquier cuerpo:
import RAPIER from '@dimforge/rapier3d-compat';
await RAPIER.init(); // obligatorio una vez, antes de crear el mundo
const world = new RAPIER.World({ x: 0, y: -9.81, z: 0 });
Patrón de conexión principal (three.js + Rapier)
La física posee el estado; three.js solo lo renderiza. Nunca muevas un mesh que tenga un cuerpo — lee la posición del cuerpo de vuelta al mesh en cada fotograma.
// 1. Primero el cuerpo
const bodyDesc = RAPIER.RigidBodyDesc.dynamic().setTranslation(0, 5, 0);
const body = world.createRigidBody(bodyDesc);
const colliderDesc = RAPIER.ColliderDesc.cuboid(0.5, 0.5, 0.5).setRestitution(0.4);
world.createCollider(colliderDesc, body);
// 2. Bucle de renderizado — sincroniza, no asignes
function tick(dt) {
world.timestep = dt;
world.step();
mesh.position.copy(body.translation());
mesh.quaternion.copy(body.rotation());
}
- Usa un paso de tiempo fijo para estabilidad: acumula
dt, avanza en fragmentos de 1/60, limita a 3 pasos/fotograma (protección contra espiral de muerte). - Cuerpos cinemáticos para plataformas/movedores; usa
setNextKinematicTranslation()cada fotograma. - Los colliders no heredan la escala del mesh — defínelos explícitamente en unidades del mundo.
Patrón de impulso al hacer clic (secciones hero)
Lanza un rayo desde el puntero, encuentra el cuerpo bajo el cursor, y golpéalo. Esta es la interacción "toca el objeto hero" que se ve en sitios AI de primer nivel. Consulta el skill threejs-interaction para más detalles sobre el raycaster.
raycaster.setFromCamera(pointerNDC, camera);
const hit = world.castRay(new RAPIER.Ray(origin, dir), 100, true, undefined, undefined, undefined, filterPredicate);
if (hit) {
const body = world.getCollider(hit.colliderHandle).parent();
const dir3 = rayDir.clone().multiplyScalar(6); // fuerza del impulso
body.applyImpulse({ x: dir3.x, y: dir3.y, z: dir3.z }, true);
}
Aplica a los cuerpos cliqueables un ligero amortiguamiento angular (setAngularDamping(0.5)) para que giren de forma creíble en lugar de dar vueltas sin fin.
Muchos cuerpos: instanciación, presupuesto, sueño
- Un
THREE.InstancedMeshpor geometría; escribe las transformaciones de los cuerpos en las matrices de instancia después deworld.step(). Nunca un Mesh por cuerpo más allá de ~50 objetos. - Presupuestos: ~200 cajas/colliders dinámicos bien en escritorio; ~80 en móvil. Por debajo de eso, simúlalo (consulta "física falsa" más abajo).
- Deja que los cuerpos duerman (por defecto) y despiértalos solo con interacción. Una escena llena de cuerpos que nunca duermen quema CPU sin necesidad.
- Usa geometrías simples para colliders (cajas/esferas/cápsulas); mallas convexas/compuestas solo donde la silueta importe.
Física falsa (decide esto primero)
La mayoría de los sitios de marketing no necesitan un motor. Pregunta: ¿el efecto necesita colisiones o solo movimiento creíble?
- Orbes flotantes que reaccionan al cursor → matemáticas de resortes/amortiguamiento, sin motor.
- Confeti de formas 3D que se dispersan al hacer clic → velocidades precalculadas + integración de gravedad en un solo shader o bucle, sin motor.
- Modelo hero arrastrable que vuelve a su lugar → resorte hacia la pose de reposo (consulta el skill 3d-hero-interactions). Recurre a Rapier solo cuando los objetos deban colisionar, reposar unos sobre otros o apilarse.
Simulación de partículas GPU
Para nubes de redes neuronales, campos de estrellas, humo — miles de partículas actualizadas en la GPU mediante render targets ping-pong (texturas de estado). Detalles y una plantilla funcional: lee references/gpgpu-particles.md.
Errores comunes
- Olvidar
await RAPIER.init()→ errores crípticos de WASM. - Establecer
mesh.positiony dejar que el cuerpo lo controle — el cuerpo gana, el mesh se teletransporta. Mueve los cuerpos, lee los meshes. - Pasos de tiempo variables entre fotogramas → pilas inestables y túneles. Paso de tiempo fijo + acumulador.
- Añadir trabajo del bucle de renderizado dentro de eventos de colisión — pon en cola los efectos, aplícalos después de
step(). - Lanzar rayos en la escena de three.js para selección física en lugar de
world.castRay(o viceversa) — selecciona en el mundo que posee los objetos. - No restaurar el mundo en transiciones de página (desmontajes de R3F filtran cuerpos WASM; desecha el mundo).
Skills relacionados
- threejs-fundamentals — escena, renderizador, bucle
- threejs-interaction — lanzamiento de rayos y selección con puntero
- threejs-performance — instanciación y presupuestos
- 3d-hero-interactions — la capa de UX sobre esto (estados hover, ráfagas, cursores magnéticos)