3d-physics-simulations

Exécutez des simulations physiques réalistes dans des sites web three.js : corps rigides, gravité, collisions, ragdolls, tissus, chaînes et simulations de particules GPU avec Rapier ou cannon-es.

Qu'est-ce que 3d-physics-simulations ?

Cette compétence permet d'ajouter des simulations physiques crédibles à des scènes three.js : chute de corps, empilements, destructions, réactions aux clics avec une inertie réaliste. Elle couvre le choix du moteur (Rapier par défaut, cannon-es pour les environnements sans WASM), le couplage avec three.js via un modèle où la physique possède l'état et Three.js se contente de le rendre, l'optimisation des performances (instancing, budgets, sommeil des corps), et les motifs d'interaction comme l'impulsion au clic. Des sections dédiées aux solutions alternatives (fausse physique pour les effets visuels sans collisions) et aux simulations GPU de particules (nuages, essaims, fumée) complètent l'ensemble. Les plateformes supportées incluent les bundlers modernes et les scripts simples, avec des conseils pour éviter les erreurs fréquentes (oubli de RAPIER.init(), pas à pas variable, raycasting inapproprié).

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Simulations & Physique 3D

Faites en sorte que les scènes 3D se comportent : les corps tombent, s'empilent, se brisent et réagissent aux clics avec une masse crédible. Cette compétence couvre le choix du moteur, son couplage avec three.js, le maintien des 60fps et le motif d'impulsion au clic utilisé dans les sections héroïques.

Choisir le moteur

  • Rapier (@dimforge/rapier3d-compat) — par défaut. WASM, déterministe, activement maintenu, meilleures performances. Utilisez rapier3d-compat (initialisation WASM asynchrone) pour les bundlers ; rapier3d (synchrone) uniquement pour les balises script simples.
  • cannon-es — uniquement si le chargement WASM doit être évité (démos file://, CSP strict). Plus lent et moins maintenu.
  • Particules GPGPU/FBO — pour la fumée, les essaims, les nuages de particules "IA neuronales" (des milliers et plus). Ce n'est pas un moteur physique ; voir la section GPU ci-dessous.

Chargez Rapier avant de créer des corps :

import RAPIER from '@dimforge/rapier3d-compat';
await RAPIER.init(); // requis une seule fois, avant la création du monde
const world = new RAPIER.World({ x: 0, y: -9.81, z: 0 });

Motif de couplage principal (three.js + Rapier)

La physique possède l'état ; three.js ne fait que le rendre. Ne déplacez jamais un maillage qui a un corps — lisez plutôt le corps dans le maillage à chaque image.

// 1. Corps d'abord
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. Boucle de rendu — synchroniser, ne pas définir
function tick(dt) {
  world.timestep = dt;
  world.step();
  mesh.position.copy(body.translation());
  mesh.quaternion.copy(body.rotation());
}
  • Utilisez un pas de temps fixe pour la stabilité : accumulez dt, avancez par incréments de 1/60, limitez à 3 pas/image (protection contre la spirale de la mort).
  • Corps cinématiques pour les plateformes/mobiles ; setNextKinematicTranslation() à chaque image.
  • Les colliders n'héritent pas de l'échelle du maillage — dimensionnez-les explicitement en unités monde.

Motif d'impulsion au clic (sections héroïques)

Lancez un rayon depuis le pointeur, trouvez le corps sous le curseur, frappez-le. C'est l'interaction "pousser l'objet héroïque" des meilleurs sites IA. Voir la compétence threejs-interaction pour les détails du 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); // force de l'impulsion
  body.applyImpulse({ x: dir3.x, y: dir3.y, z: dir3.z }, true);
}

Donnez aux corps cliquables un léger amortissement angulaire (setAngularDamping(0.5)) pour qu'ils tournent de manière crédible au lieu de tournoyer indéfiniment.

Corps nombreux : instancing, budget, sommeil

  • Un THREE.InstancedMesh par géométrie ; écrivez les transformations des corps dans les matrices d'instance après world.step(). Jamais un maillage par corps au-delà de ~50 objets.
  • Budgets : ~200 boîtes/colliders dynamiques OK sur desktop ; ~80 sur mobile. En dessous, simulez (voir "fausse physique" ci-dessous).
  • Laissez les corps dormir (par défaut) et réveillez-les uniquement lors d'interactions. Une scène remplie de corps qui ne dorment jamais brûle du CPU inutilement.
  • Géométries simples pour les colliders (boîtes/sphères/capsules) ; maillages convexes/composés uniquement si la silhouette compte.

Fausse physique (décidez d'abord)

La plupart des sites marketing n'ont pas besoin de moteur. Demandez : l'effet nécessite-t-il des collisions ou simplement un mouvement crédible ?

  • Orbites flottantes réagissant au curseur → calculs de ressorts/amortissement, pas de moteur.
  • Confettis de formes 3D dispersés au clic → vitesses précalculées + intégration de la gravité dans un shader ou une boucle, pas de moteur.
  • Modèle héroïque déplaçable avec retour → ressort vers la pose de repos (voir la compétence 3d-hero-interactions). N'utilisez Rapier que lorsque les objets doivent entrer en collision, reposer les uns sur les autres ou s'empiler.

Simulation de particules GPU

Pour les nuages de réseaux de neurones, champs d'étoiles, fumée — des milliers de particules mises à jour sur le GPU via des cibles de rendu ping-pong (textures d'état). Détails et modèle fonctionnel : lisez references/gpgpu-particles.md.

Erreurs courantes

  • Oublier await RAPIER.init() → erreurs WASM cryptiques.
  • Définir mesh.position et laisser le corps le piloter — le corps gagne, le maillage se téléporte. Déplacez les corps, lisez les maillages en retour.
  • Pas de temps variables d'une image à l'autre → piles saccadées et tunnellisation. Pas de temps fixe + accumulateur.
  • Ajouter du travail dans la boucle de rendu à l'intérieur des événements de collision — mettez en file d'attente les effets, appliquez-les après step().
  • Lancer un rayon sur la scène three.js pour la détection physique au lieu de world.castRay (ou vice versa) — détectez dans le monde qui possède les objets.
  • Ne pas restaurer le monde lors des transitions de page (les démontages R3F fuient les corps WASM ; supprimez le monde).

Compétences associées

  • threejs-fundamentals — scène, renderer, boucle
  • threejs-interaction — lancer de rayons et détection de pointeur
  • threejs-performance — instancing et budgets
  • 3d-hero-interactions — la couche UX par-dessus (états de survol, explosions, curseurs magnétiques)

Skills associés