Spiele entwickeln
Baue ein spielbares, korrektes Browserspiel – keinen statischen Screenshot. Ein Spiel ist einfach eine React-Route mit einem <canvas> (oder <Canvas> für R3F) plus DOM-Overlay-UI. Gestalte das Overlay (Startbildschirm, HUD, Menüs) mit dem Skill design-ui; dieser Skill besitzt die Spielschleife und die Welt.
Steuerung / invertiertes A/D: Öffne .grok/skills/controls/SKILL.md, bevor du WASD-, Lenk- oder Flugeingaben programmierst. Fahrzeug-/Flugdemos liefern oft ein vertauschtes A/D, wenn du nur diese Datei oder ein einzelnes Genre-Playbook liest.
Hinweis zum Umfang – Einzelspieler, Bots oder kleine P2P-Koop:
- Liefere standardmäßig Einzelspieler oder Einzelspieler + KI/Bots aus.
- Koop mit 2–8 Spielern / lockeres Echtzeit-Spiel (gemeinsame Cursor, Partyspiele, lockere Action unter Freunden) wird unterstützt – verwende den Skill
multiplayer-p2p(WebRTC-Mesh, signalisiert unter/api/rtc). Lies zuerst dessen Vertrauensmodell. - P2P ist derzeit der einzige unterstützte Mehrspielermodus. Baue keine halbfertigen Sockets, die keine Verbindung herstellen können.
Referenzen (bei Bedarf laden):
- Skill
controls(../controls/) – erforderlich für Bewegung/Lenkung/Flug: spielersichtbares A/D, Anti-Pattern für invertierte Lenkung, Flug-Querruder, obligatorischer Selbsttest +window.__controlsTest. Nicht optional für Fahrzeuge/Flugzeuge. references/threejs-foundational.md– die tiefgehende 3D-/Loop-/Performance-Referenz. Für 3D lesen.references/3d-libs.md– Verwendung von three.js + @react-three/fiber + drei + rapier.- Skill
threejs(../threejs/) – offizielles vollständiges Three.js + TSL API-Dump (llms-full.txt). Für fortgeschrittene Materialien/Shader/WebGPU/Ladeprogramme laden; nicht für einfache 2D-Canvas-Spiele. references/babylon.md– Babylon.js, die alternative 3D-Engine mit vielen Funktionen.references/phaser.md– Phaser 3, die Standard-Engine für 2D-Spiele.references/ecs-architecture.md– Entity-Component-System-Struktur für größere Spiele.references/genres/*.md– Genre-Playbooks (FPS, 2D-Plattformer, Renn-Kart, Puzzle-Match3-Tetris, Voxel-Minecraft, Endless Runner, Topdown-Twin-Stick, Tower Defense, Brettspiel-Karte-Schach). Genredateien ersetzen nichtcontrols.references/game-feel-juice.md,input.md,audio.md,collision-physics.md,save-persistence.md,procedural-generation.md,ai-pathfinding.md.game-asset-core(+game-animation-frames/game-tilesets/game-character-consistency/game-ui-icons) – enginebereite 2D-Kunststandards und Verifikation beim Generieren von Sprites, Sheets, Tiles oder UI (siehe §6).
Wähle die spezifische Genre-/Themenreferenz für den Bau aus; diese Datei ist der universelle Kern für Loop/Welt. Eingabezeichen → controls. 2D-Spielgrafik → game-asset-core.
1. Spielschleife & Timing (das #1-Korrektheitsproblem)
- Treibe die Schleife mit der RAF-Schleife der Engine an (
renderer.setAnimationLoop, R3FuseFrameoderrequestAnimationFramefür 2D-Canvas). NiemalssetInterval/setTimeout/Date.now()für Spielzeitmessung verwenden. - Skaliere ALLE Bewegungen/Animationen mit der Delta-Zeit (Sekunden), damit die Geschwindigkeit frame-ratenunabhängig ist (60 Hz vs. 144 Hz). Berechne Delta einmal pro Frame und verwende es wieder.
- three.js: Verwende
THREE.Timer(nichtClock–Clock.getDelta()gibt bei einem zweiten Aufruf im selben Frame ~0 zurück, ein klassischer Freeze-Bug).
- three.js: Verwende
- Begrenze Delta (
min(delta, 0.1)), damit ein im Hintergrund gelegener Tab nichts wegteleportiert. - Fester Zeitschritt für Physik/Gameplay: Akkumuliere Delta und führe die Simulation in festen Schritten aus (z. B. 1/60), während mit Bildwiederholrate gerendert wird – verhindert Tunneling und Nichtdeterminismus.
2. Steuerung (an den Skill controls delegieren)
Öffne .grok/skills/controls/SKILL.md, bevor du WASD-/Lenk-/Flugcode implementierst. Dieser Skill ist die Quelle der Wahrheit für:
- Spielersichtbares A = links / D = rechts (Chase-Cam, während der Vorwärtsbewegung)
- Warum
KeyA → steer−+yaw += steer * +rateinvertiert (häufigster Bug) - Fahrzeug vs. FPS (Strafe ≠ Lenkung), Querruder bei Starrflüglern, Heli-/Drohnennotizen
- Obligatorischer Selbsttest +
window.__controlsTest-Sonde
Behandle genres/racing-kart.md nicht als den einzigen Ort, an dem Lenkzeichen definiert sind – Flugzeuge, Jetskis und Mechs öffnen es nie.
Kurze Erinnerung (vollständige Details in controls):
// Fahrzeug-Gierkörper (Chase-Cam): A muss die Gier mit dieser Basis erhöhen
forward = (-sin(yaw), 0, -cos(yaw))
// KeyA → steer = +1; yaw += steer * turnRate * speedFactor * dt
// FALSCH (liefert invertiert): KeyA → steer = -1; yaw += steer * turnRate * dt
- Pointer Lock: Mausblick nur – implementiere WASD selbst; Klick-zum-Spielen-Overlay; beim Lock ausblenden.
- Verfolge Tasten mit gehaltenem Zustand + dt; vereinheitliche Geräte über
references/input.md. - Abschluss: Führe die Checkliste des
controls-Skills aus. Nur ein Screenshot reicht für Fahrzeuge/Flugzeuge nicht aus.
3. 3D-Orientierung & Weltobjekte (die „seitwärts/rückwärts“-Bugs)
- three.js ist rechtshändig, +Y nach oben: +X rechts, +Y oben, +Z zum Betrachter. Meshes zeigen in +Z; Kameras schauen in −Z (der klassische „Kamera rückwärts“-Stolperstein).
- Primitive wie
Cone/Cylinderzeigen standardmäßig in +Y → drehen, um eine Spitze mit der Vorwärtsrichtung auszurichten (geo.rotateX(Math.PI/2)). - Ein Mesh so ausrichten, dass es in
forwardzeigt (Meshes zeigen in +Z): Der einfachste korrekte Weg istmesh.lookAt(mesh.position.clone().add(forward)). Um die Basis von Hand zu erstellen, setze die +Z-Spalte aufforwardund wähle die x-Achse so, dass sie eine korrekte rechtshändige Rotation ergibt (det = +1):xAxis = normalize(cross(up, forward)), dannmakeBasis(xAxis, up, forward). Beachte, dass diescross(up, forward)ist – nicht das Bewegungs-right = cross(forward, up)aus §2. Die Ausrichtung auf +Z (anstelle der −Z einer Kamera) kehrt das Vorzeichen der x-Achse um, sodassxAxis × up = forwardgilt; der Frame bleibt rechtshändig (keine Spiegelung). Verwende nichtmakeBasis(xAxis, up, -forward)für ein Mesh – das zielt auf −Forward (die Kamera-Konvention) ab, sodass das Mesh rückwärts zeigt. - Eine Kamera so ausrichten, dass sie entlang
forwardschaut (Kameras schauen in −Z): Setze die +Z-Spalte auf-forward–xAxis = normalize(cross(forward, up)), dannmakeBasis(xAxis, up, -forward)(oder einfachcamera.lookAt(target)). - Behalte eine konsistente Welthochachse (
up) bei, damit Objekte aufrecht bleiben; rotiere nur flache Primitive, um sie aufzustellen. - Überprüfe die Ausrichtung von glTF-Importen; debugge mit
AxesHelper/ArrowHelper. Aufrechter Selbsttest: Charaktere stehen auf der Bodenebene, liegen nicht und sinken nicht ein.
4. Kamera muss mit Bewegung übereinstimmen
- Behalte ein dediziertes
moveForward/moveRightfür die Bewegung bei, einmal berechnet und niemals durch Kameracode verändert (Aliasing eines gemeinsam genutzten temporären Vektors führt zu Abweichungen zwischen Kamera und Bewegung – ein echter reproduzierbarer Bug). - Third-Person-Folgekamera:
desired = playerPos + up*height + moveForward*(-followDist); interpoliere die Kamera dorthin (verwende exp-basierte Glättung, delta-skaliert),lookAt(player). - Isoliere die Debug-Reihenfolge: (1) Tasten registrieren → (2) Bewegungszeichen korrekt → (3) Kamera stimmt überein. In dieser Reihenfolge beheben.
5. Performance
- Minimiere Draw Calls (
renderer.info.render.calls, Ziel <100): teile Materialien,InstancedMesh/BatchedMeshfür wiederholte Objekte, Atlanten. - Gib GPU-Ressourcen selbst frei (
geometry/material/texture.dispose()) bei Levelwechsel – three.js räumt sie nicht auf. Pools für Kugeln/Gegner/Partikel. - Keine Allokationen pro Frame (temporäre Vektoren wiederverwenden). Texturen komprimieren; LOD für Entfernungen.
6. Assets (vermeide die generierte-Foto-Falle)
- Interaktive 3D-Elemente (Waffen-Viewmodels, Charaktere, Requisiten, Projektile) → aus 3D-Geometrie / glTF bauen, nicht aus einem generierten Bild. Ein flaches fotorealistisches JPG einer Waffe in den Händen, das als FPS-Viewmodel verwendet wird, sieht falsch aus, kann nicht animiert werden und (JPG hat keinen Alphakanal) rendert als schwarzer Kasten. Eltere ein echtes 3D-Viewmodel an die Kamera als Overlay-Render-Layer.
- Reserviere die Bildgenerierung für flache 2D-Assets (Texturen, Himmels-/Menühintergründe, 2D-Sprites, UI-Grafiken). Verwende niemals ein generiertes Foto als 3D-Mesh, Viewmodel oder Charakterersatz – baue diese in 3D-Geometrie / glTF. Setze
crossOrigin="anonymous"auf Bildern, die auf Canvas/Texturen gezeichnet werden. Siehe den Skillimagine-grok-build(nur 2D – Bildwerkzeuge können kein echtes 3D erzeugen). - Engine-bereite Spielgrafik-Doktrin → öffne
game-asset-core(../game-asset-core/) für Standards + Blind-Verifikation + Wiederholungsdisziplin, dann den passenden Spezialisten:game-animation-frames(Schleifen-/Bewegungsgesetze),game-tilesets,game-character-consistency,game-ui-icons. Dies sind QC/Doktrin, nicht die Export-Pipeline. Liefere keine Strichmännchen-Platzhalter, wenn echte Grafik erwartet wird. - 2D-Spiel-Sprites / Animationssheets → führe
generate2dspriteaus (.grok/skills/generate2dsprite/SKILL.md): solide#FF00FFmagentaimagine_text_to_image-Sheets + Chroma-Key-Nachbearbeitungsskripte (Magenta ist für den Prozessor erforderlich). Erzeuge transparente PNGs/GIFs für Canvas/Phaser. Wende weiterhingame-asset-corean (+ Animations-/Charakter-Spezialisten, wenn relevant). - 2D-Karten / Level / Requisitenpakete → öffne
generate2dmap(.grok/skills/generate2dmap/SKILL.md). Bevorzuge fundamentale Basis + separate Requisiten/Kollision für spielbare Karten. Browser-Standard:raw_canvas/ Phaser. Kachelbare Böden/Wände → auchgame-tilesetsfür 2×2-Nahtprüfungen. - Optional dichtere Fortbewegung → führe
video2dspriteaus (Grokimagine_image_to_video+ Sandbox-Skripte; Magenta-Basis). Bevorzugegenerate2dspritefür knackige Produktionshelden. Verwendegame-animation-framesfür Schleifen-/Flip-Test-Gesetze; bevorzugevideo2dspritegegenüber Ad-hoc-ffmpeg-only-Ernte in dieser Sandbox.
7. Audio, Speichern, Game Feel
- Audio: Entsperre
AudioContextbei der ersten Benutzergeste (Tippen zum Starten), sonst ist iOS stumm; setze beivisibilitychangefort. (references/audio.md) - Speichern:
localStorage/IndexedDB mit einemversion-Feld + Migrationen. - Juice: Bildschirm wackeln, Hit-Stop, abgemilderte Tweens, Partikel – billig, enorme Steigerung der wahrgenommenen Qualität. Halte Präsentation von Simulation getrennt.
8. Mobilgeräte
- Unterscheide Canvas-Puffergröße von CSS-Größe; respektiere
devicePixelRatio. touch-action: none, Letterbox-Fit auf eine Basisauflösung, Handhabe der Ausrichtung.- Touch-Steuerung (virtueller Joystick + Aktionsknöpfe), ≥44px Ziele.
Stack / Engine-Wahl
- 3D → three.js, idealerweise über @react-three/fiber + drei (passt in die React-App; drei bietet Pointer-Lock/Steuerung/Lader) + @react-three/rapier für Physik/Charakter-Controller. Siehe
references/3d-libs.md. - 2D → natives Canvas 2D reicht für Snake/Tetris/Flappy/Plattformer; greife nur zu Phaser, wenn das Genre es benötigt.
- Diese Spiel-Abhängigkeiten sind nicht vorinstalliert – installiere sie mit
npm install(und stelle sicher, dass sie inpackage.jsonlanden, damit der Vercel-Build sie hat).
Fertigstellungskriterien (vor „erledigt“)
- Lädt ohne Konsolenfehler; sichtbares Gameplay (kein leeres Canvas).
- Selbsttest des
controls-Skills bestanden (A = links / D = rechts aus Chase-Cam während der Vorwärtsbewegung; ein Zeichen umdrehen, wenn invertiert). Nicht nur Screenshot. - Selbsttests für 3D-Aufrecht- & Kameraübereinstimmung bestanden (§3, §4).
- Läuft auf mobilen Viewports mit Touch-Steuerung.
- Produktions-Build (
npm run build) rendert die erstellte Ausgabe, nicht nur dev. - Share / X-Karte: öffne den Skill
og– benutzerdefiniertespublic/og.jpgund"type": "x:game"insrc/lib/og/site.json. X verwendetog:type="x:game", um die Unfurl als Spielkarte darzustellen; verwende nichttwitter:cardoder erfindex:typedafür.browser-smoke/brand-checkwarnen, wenn Canvas-Apps dassite.json-Feld weglassen.