CommunityCodierung & Entwicklunggithub.com

3D-Physik-Simulationen

Führen Sie echte Physik und Simulationen in three.js-Websites aus: Starre Körper, Schwerkraft, Kollisionen, Ragdolls, Stoffe, Ketten und GPU-Partikelsimulationen mit Rapier oder cannon-es.

Was ist 3D-Physik-Simulationen?

Dieses Skill ermöglicht es, physikalisch realistische 3D-Szenen mit three.js zu erstellen. Es behandelt die Auswahl einer Physik-Engine (Rapier oder cannon-es), ihre Integration in three.js, das Erreichen von 60fps und das Click-Impulse-Muster für Hero-Sections. Es wird erklärt, wie man starre Körper, Kollisionen, Schwerkraft und interaktive Objekte erstellt, sowie wann echte Physik nötig ist und wann man sie durch einfachere Animationen ersetzen kann. Der Skill ist für AI-Agenten gedacht, die 3D-Webseiten mit realistischen Objektbewegungen erstellen, sei es für Marketingseiten, Produktpräsentationen oder Spiele. Er unterstützt die Integration mit anderen Skills wie threejs-fundamentals, threejs-interaction und threejs-performance.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 Sie rapier3d-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.InstancedMesh pro Geometrie; schreiben Sie Körper-Transformationen nach world.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.position und 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)

Verwandte Skills