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. Userapier3d-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.InstancedMeshpor geometria; escreva as transformações dos corpos nas matrizes de instância apósworld.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.positione 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)