3D-Physik & Simulationen
Lassen Sie 3D-Szenen sich verhalten: Körper fallen, stapeln sich, zerbrechen und reagieren auf Klicks mit glaubwürdiger Masse. Dieser Skill behandelt die Auswahl einer Engine, deren Verbindung mit three.js, das Halten von 60fps und das Click-Impulse-Muster, das in Hero-Sections verwendet wird.
Engine auswählen
- Rapier (
@dimforge/rapier3d-compat) — Standard. WASM, deterministisch, aktiv gewartet, beste Leistung. Verwenden Sierapier3d-compat(async WASM-Initialisierung) für Bundler;rapier3d(synchron) nur für einfache Script-Tags. - cannon-es — nur wenn WASM-Laden vermieden werden muss (file://-Demos, striktes CSP). Langsamer und weniger gewartet.
- GPGPU/FBO-Partikel — für Rauch, Schwärme, „AI-neuronale“ Partikelwolken (Tausende+). Keine Physik-Engine; siehe GPU-Abschnitt unten.
Laden Sie Rapier, bevor Sie Körper erstellen:
import RAPIER from '@dimforge/rapier3d-compat';
await RAPIER.init(); // einmal erforderlich, vor der Welterstellung
const world = new RAPIER.World({ x: 0, y: -9.81, z: 0 });
Kern-Verdrahtungsmuster (three.js + Rapier)
Die Physik besitzt den Zustand; three.js rendert ihn nur. Bewegen Sie niemals ein Mesh, das einen Körper hat — lesen Sie den Körper in jedem Frame zurück in das Mesh.
// 1. Körper zuerst
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. Render-Schleife — synchronisieren, nicht setzen
function tick(dt) {
world.timestep = dt;
world.step();
mesh.position.copy(body.translation());
mesh.quaternion.copy(body.rotation());
}
- Verwenden Sie einen festen Zeitschritt für Stabilität: Akkumulieren Sie
dt, schreiten Sie in 1/60-Schritten vor, begrenzen Sie auf 3 Schritte/Frame (Spiral-of-Death-Schutz). - Kinematische Körper für Plattformen/Beweger;
setNextKinematicTranslation()jedes Frame. - Kollider erben nicht die Mesh-Skalierung — dimensionieren Sie sie explizit in Welteinheiten.
Click-Impulse-Muster (Hero-Sections)
Raycasten Sie den Zeiger, finden Sie den Körper unter dem Cursor, stoßen Sie ihn an. Dies ist die „Hero-Objekt antippen“-Interaktion auf erstklassigen AI-Seiten. Siehe das threejs-interaction-Skill für Raycaster-Details.
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); // Impulsstärke
body.applyImpulse({ x: dir3.x, y: dir3.y, z: dir3.z }, true);
}
Geben Sie anklickbaren Körpern eine leichte Winkel-Dämpfung (setAngularDamping(0.5)), damit sie glaubwürdig rotieren und nicht ewig kreiseln.
Viele Körper: Instanzen, Budget, Schlaf
- Ein
THREE.InstancedMeshpro Geometrie; schreiben Sie Körper-Transformationen nachworld.step()in die Instanz-Matrizen. Nie ein Mesh pro Körper über ~50 Objekte hinaus. - Budgets: ~200 dynamische Boxen/Kollider OK auf dem Desktop; ~80 auf mobilen Geräten. Darunter: vortäuschen (siehe „Fake-Physik“ unten).
- Lassen Sie Körper schlafen (Standard) und wecken Sie sie nur bei Interaktion. Eine Szene voller nie schlafender Körper verbraucht CPU ohne Grund.
- Einfache Geometrie für Kollider (Boxen/Kugeln/Kapseln); konvexe/zusammengesetzte Meshes nur dort, wo die Silhouette wichtig ist.
Fake-Physik (zuerst entscheiden)
Die meisten Marketing-Seiten brauchen keine Engine. Frage: Braucht der Effekt Kollisionen oder nur glaubwürdige Bewegung?
- Schwebende Orbs, die auf den Cursor reagieren → Federn/Dämpfungs-Mathematik, keine Engine.
- Klick-zerstreute Konfetti aus 3D-Formen → vorberechnete Geschwindigkeiten + Schwerkraft-Integration in einem Shader oder Loop, keine Engine.
- Ziehbares Hero-Modell mit Rückkehr → Federung zur Ruhepose (siehe das 3d-hero-interactions-Skill). Greifen Sie zu Rapier nur, wenn Objekte kollidieren, aufeinander ruhen oder sich stapeln müssen.
GPU-Partikelsimulation
Für neuronale Netzwerke-Wolken, Sternfelder, Rauch — Tausende von Partikeln, die auf der GPU über Ping-Pong-Render-Targets (Zustands-Texturen) aktualisiert werden. Details und eine funktionierende Vorlage: lesen Sie references/gpgpu-particles.md.
Häufige Fehler
- Vergessen von
await RAPIER.init()→ kryptische WASM-Fehler. - Setzen von
mesh.positionund den Körper die Bewegung steuern lassen — der Körper gewinnt, das Mesh teleportiert. Bewegen Sie Körper, lesen Sie Meshes zurück. - Variable Zeitschritte von Frame zu Frame → ruckelige Stapel und Durchdringungen. Fester Zeitschritt + Akkumulator.
- Render-Schleifen-Arbeit innerhalb von Kollisions-Ereignissen — Effekte in die Warteschlange stellen, nach
step()anwenden. - Raycasting der three.js-Szene für Physik-Picking anstelle von
world.castRay(oder umgekehrt) — picken Sie in der Welt, die die Objekte besitzt. - Nicht-Wiederherstellen der Welt bei Seitenübergängen (R3F-Unmounts lassen WASM-Körper auslaufen; entsorgen Sie die Welt).
Verwandte Skills
- threejs-fundamentals — Szene, Renderer, Loop
- threejs-interaction — Raycasting und Zeiger-Picking
- threejs-performance — Instanziierung und Budgets
- 3d-hero-interactions — die UX-Ebene darüber (Hover-Zustände, Bursts, magnetische Cursors)