Simulações de Física 3D

Execute simulações físicas reais dentro de sites three.js: corpos rígidos, gravidade, colisões, ragdolls, tecidos, correntes e simulações de partículas GPU com Rapier ou cannon-es. Use sempre que o usuário mencionar física, simulação, gravidade, colisões, objetos quicando, destruição, tecido, efeitos de partículas semelhantes a fluidos ou quiser objetos 3D que reajam com movimento crível — mesmo em páginas de marketing/landing, não apenas em jogos. Combine com as habilidades threejs-fundamentals, threejs-interaction e threejs-performance.

O que é Simulações de Física 3D?

Esta habilidade permite adicionar física realista a cenas three.js, utilizando engines como Rapier (padrão) ou cannon-es. Ela cobre desde a escolha do motor de física, passando pela integração com three.js — sincronizando corpos rígidos a malhas 3D — até técnicas de otimização como corpos dormentes e instanciamento. Suporta interações com clique-impulso (usada em hero sections), simulações de partículas GPU para efeitos de milhares de partículas (fumaça, nuvens neurais), e física falsa para efeitos visuais simples que não exigem colisões reais. É ideal para sites de marketing, landing pages, portfólios e protótipos interativos, não apenas jogos. Inclui padrões de código testados, armadilhas comuns (como esquecer await RAPIER.init() ou usar passo de tempo variável) e dicas de desempenho para manter 60fps. Funciona com os ecossistemas three.js puro ou React Three Fiber.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Física e Simulações 3D

Faça cenas 3D se comportarem: corpos caem, empilham, se despedaçam e reagem a cliques com massa crível. Esta habilidade cobre como escolher um motor de física, conectá-lo ao three.js, manter 60fps e o padrão de clique-impulso usado em seções de herói.

Escolha o motor

  • Rapier (@dimforge/rapier3d-compat) — padrão. WASM, determinístico, ativamente mantido, melhor desempenho. Use rapier3d-compat (inicialização WASM assíncrona) para bundlers; rapier3d (síncrono) apenas para tags script simples.
  • cannon-es — apenas se o carregamento WASM deve ser evitado (demos file://, CSP restrito). Mais lento e menos mantido.
  • Partículas GPGPU/FBO — para fumaça, enxames, nuvens de partículas "IA neural" (milhares+). Não é um motor de física; veja a seção GPU abaixo.

Carregue o Rapier antes de criar qualquer corpo:

import RAPIER from '@dimforge/rapier3d-compat';
await RAPIER.init(); // necessário uma vez, antes da criação do mundo
const world = new RAPIER.World({ x: 0, y: -9.81, z: 0 });

Padrão de conexão central (three.js + Rapier)

A física possui o estado; three.js apenas renderiza. Nunca mova uma malha que tem um corpo — leia o corpo de volta para a malha a cada quadro.

// 1. Corpo primeiro
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. Loop de renderização — sincronize, não defina
function tick(dt) {
  world.timestep = dt;
  world.step();
  mesh.position.copy(body.translation());
  mesh.quaternion.copy(body.rotation());
}
  • Use um passo de tempo fixo para estabilidade: acumule dt, execute em chunks de 1/60, limite a 3 passos/quadro (proteção contra espiral da morte).
  • Corpos cinemáticos para plataformas/movedores; use setNextKinematicTranslation() a cada quadro.
  • Colisores não herdam a escala da malha — dimensione-os em unidades do mundo explicitamente.

Padrão de clique-impulso (seções de herói)

Dispare um raio a partir do ponteiro, encontre o corpo sob o cursor, chute-o. Esta é a interação "cutuque o objeto herói" em sites de IA de ponta. Veja a habilidade threejs-interaction para detalhes sobre o 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); // força do impulso
  body.applyImpulse({ x: dir3.x, y: dir3.y, z: dir3.z }, true);
}

Dê aos corpos clicáveis um leve amortecimento angular (setAngularDamping(0.5)) para que girem de forma crível em vez de girarem infinitamente.

Muitos corpos: instanciamento, orçamento, sono

  • Um THREE.InstancedMesh por geometria; escreva as transformações dos corpos nas matrizes de instância após world.step(). Nunca use uma malha por corpo após ~50 objetos.
  • Orçamentos: ~200 caixas/colisores dinâmicos ok no desktop; ~80 no celular. Abaixo disso, simule (veja "física falsa" abaixo).
  • Deixe os corpos dormirem (padrão) e acorde-os apenas na interação. Uma cena cheia de corpos que nunca dormem queima CPU à toa.
  • Geometria simples para colisores (caixas/esferas/cápsulas); malhas convexas/compostas apenas onde a silhueta importa.

Física falsa (decida isso primeiro)

A maioria dos sites de marketing não precisa de um motor. Pergunte: o efeito precisa de colisões, ou apenas de movimento crível?

  • Orbes flutuantes reagindo ao cursor → matemática de molas/amortecimento, sem motor.
  • Confetes de formas 3D espalhados ao clicar → velocidades pré-calculadas + integração de gravidade em um shader ou loop, sem motor.
  • Modelo herói arrastável com retorno → mola em direção à pose de descanso (veja a habilidade 3d-hero-interactions). Recorra ao Rapier apenas quando objetos precisam colidir, descansar uns sobre os outros ou empilhar.

Simulação de partículas GPU

Para nuvens de rede neural, campos de estrelas, fumaça — milhares de partículas atualizadas na GPU via render targets ping-pong (texturas de estado). Detalhes e um template funcional: leia references/gpgpu-particles.md.

Erros comuns

  • Esquecer await RAPIER.init() → erros WASM misteriosos.
  • Definir mesh.position e deixar o corpo controlá-la — o corpo vence, a malha teletransporta. Mova corpos, leia de volta as malhas.
  • Passos de tempo variáveis quadro a quadro → pilhas instáveis e tunelamento. Passo de tempo fixo + acumulador.
  • Adicionar trabalho do loop de renderização dentro de eventos de colisão — enfileire efeitos, aplique-os após step().
  • Disparar raios na cena three.js para seleção física em vez de world.castRay (ou vice-versa) — selecione no mundo que possui os objetos.
  • Não restaurar o mundo em transições de página (desmontagens do R3F vazam corpos WASM; descarte o mundo).

Habilidades relacionadas

  • threejs-fundamentals — cena, renderizador, loop
  • threejs-interaction — raycasting e seleção por ponteiro
  • threejs-performance — instanciamento e orçamentos
  • 3d-hero-interactions — a camada de UX por cima (estados de hover, explosões, cursores magnéticos)

Habilidades Relacionadas