CommunityProgramación y desarrollogithub.com

3d-physics-simulations

Ejecuta física real y simulaciones dentro de sitios web con three.js: cuerpos rígidos, gravedad, colisiones, ragdolls, telas, cadenas y simulaciones de partículas GPU con Rapier o cannon-es.

¿Qué es 3d-physics-simulations?

Este skill te permite añadir física realista a tus escenas three.js, incluyendo cuerpos rígidos, gravedad, colisiones, ragdolls, telas y simulaciones de partículas con GPU. Utiliza Rapier como motor principal (WASM, determinista y de alto rendimiento) y cannon-es como alternativa cuando no se puede cargar WASM. El patrón central de implementación sincroniza el estado de la física con three.js: la física posee el estado y three.js solo lo renderiza, leyendo la posición del cuerpo cada fotograma. También incluye un patrón de impulso al hacer clic típico de secciones 'hero', optimizaciones para muchos cuerpos (instanciación, presupuestos, sueño), y una sección sobre física falsa para efectos que solo necesitan movimiento creíble sin colisiones. Cubre además simulaciones de partículas GPU para nubes, enjambres y efectos de humo con miles de partículas. Está diseñado para desarrolladores que quieran que objetos 3D reaccionen con movimiento creíble en páginas de marketing, landing pages o cualquier escena web, no solo en juegos.

Compatible con~Claude Code~Codex CLI✓Cursor
Part ofReact
npx skills add https://github.com/BLACKNIGHT-cloud12/3d-physics-simulations/tree/HEAD

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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. Usa rapier3d-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.InstancedMesh por geometría; escribe las transformaciones de los cuerpos en las matrices de instancia después de world.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.position y 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)

Skills relacionados