CommunityCodierung & Entwicklunggithub.com

Photoreal 3D Spiele aus Code

Erstelle aus Code spielbare, fotorealistische 3D-Spiele für WebGL, WebGPU, Three.js, Unity, Unreal oder jede andere Engine – für jedes Genre, nicht nur Shooter.

Was ist Photoreal 3D Spiele aus Code?

Diese Anleitung beschreibt ein werkzeugunabhängiges Verfahren, um aus einer codegenerierten 3D-Szene ein kurzes, spielbares und fotorealistisches Spiel zu machen. Das Ziel ist ein vollständiges Spiel mit einem Aktionsverb, einem reagierenden System, einem Gewinn- und einem Verlustzustand – kein Standbild, keine Tech-Demo und kein Rundgang. Das Verfahren ist für alle Genres geeignet; das Thema bestimmt das Verb. Es entstand aus der Produktionsdisziplin des 1,4 MB großen Einzeldatei-Shooters „Saltline“ (erstellt mit Claude Fable 5.2) und wurde so konzipiert, dass auch günstige Modelle wie DeepSeek V4.1 Flash die gleiche Qualität erreichen können. Die sechs Kernregeln (keine Architektur erfinden, Tabellen füllen, erst das Produkt dann das Aussehen, eine Änderung pro Durchlauf, nie sich selbst bewerten, beim Budget oder Plateau anhalten) stellen sicher, dass jedes Artefakt durch überprüfbare Tore abgesichert ist. Das gebündelte Test-Framework (Node.js, Python, Chrome) macht diese Tore ausführbar, sodass ein schwaches Modell konsistent ein fertiges Spiel mit Menüs, Einstellungen, Gegnern, Werkzeugen, Zielen und mobilen Touch-Steuerelementen ausliefern kann.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NorwinYu/photoreal-game/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

Fotorealistische 3D-Spiele aus Code

Ein Verfahren, um eine codegenerierte 3D-Szene in ein kurzes, spielbares Spiel zu verwandeln, das wie ein Foto wirkt. Ziel ist ein Spiel, kein Standbild, keine Technikdemo und kein Rundgang: ein Spieler mit einem Aktionsverb, ein System, das darauf reagiert, eine Möglichkeit zu gewinnen und eine Möglichkeit zu verlieren.

Hier wird kein bestimmtes Genre vorausgesetzt. Das Thema bestimmt das Verb – ein Containerterminal legt nahe, eine Ladung vor Schichtende zu transportieren; eine Werkstatt legt nahe, eine Maschine zu reparieren; ein Treppenhaus legt nahe, herauszukommen, ohne gesehen zu werden. Shooter sind eine von vielen Instanzen, und das gleiche Verfahren produziert sie nur, wenn das Thema danach verlangt.

Das Verfahren ist werkzeugunabhängig. Es setzt einen Agenten voraus, der Dateien bearbeiten, Befehle ausführen und Bilder inspizieren kann. Nichts unten hängt von einer bestimmten Engine, Bibliotheksversion oder einem bestimmten Anbieterprodukt ab.

Herkunft und Bedeutung. Diese Fähigkeit existiert, um eine Frage zu beantworten, die von Saltline aufgeworfen wurde – einem 1.423.668 Byte großen Einzeldatei-Browser-Shooter ohne externe Ressourcen, erstellt mit Claude Fable 5.2. Das Interessante war nicht die Größe, sondern dass das Modell den Generator geschrieben hat. Diese Fähigkeit verpackt diese Produktionsdisziplin in ausführbare Prüfungen, sodass auch ein kostengünstiges Modell (wie DeepSeek V4.1 Flash) an den gleichen Standard gehalten werden kann. Das Ergebnis ist nicht dasselbe Spiel; es ist dieselbe Disziplin – und der Nachweis wird in den Fallstudien des Repositorys festgehalten.

Das gebündelte Test-Framework ist optional, aber empfohlen: Es macht die Prüfungen ausführbar statt nur wünschenswert. Es benötigt Node.js 22+, Python 3.10+ mit Pillow und ein Chrome/Chromium-Binary (CHROME_PATH, falls es sich nicht an einem Standardort befindet). Der Fähigkeitstext selbst hat keine Abhängigkeiten.

So führen Sie dies mit einem kostengünstigen Modell aus

Die Fähigkeit ist so geschrieben, dass ein schwaches Modell sie ausführen kann: Jedes wichtige Urteil wird an eine Prüfung delegiert, und die Aufgabe des Modells besteht darin, Tabellen zu füllen und den am besten bewerteten Fix anzuwenden. Befolgen Sie diese Regeln wörtlich.

  1. Keine Architektur entwerfen. Beginnen Sie mit einem Grundgerüst, das bereits Folgendes enthält: das Render-Framework, den Seitenvertrag (__READY, __STATS, __SCENE, __AUDIT, __COLLIDERS, __BOUNDS, __TESTMOVE, __TEST, __PRODUCT), die Nachbearbeitungskette, eine fertige Spielhülle (Titel, Einstellungen, Pause, Speichern, Touch, HUD-Markierungen) und eine leere Kit-Tabelle. Kopieren Sie es und füllen Sie dann die Tabellen. Selbst erfundene Architektur pro Durchlauf ist der Punkt, an dem schwache Modelle scheitern.
  2. Füllen, nicht erfinden. Die Arbeitsergebnisse sind sechs Tabellen: Produkt (Hülle + Inhalt), Bildregie, Kit (Abmessungen + Teile + Aufkleber), Oberflächen (Albedo/Rauheit/Normalen), Lichter (Position + Leuchte) und der Spielablauf (Verb/System/Rückmeldung/Fehler/Test).
  3. Erst das Produkt, dann das Aussehen. produkt → zählung → lichter → kollision → spieltest → mobil → aussehen. Ein Bild, das schön ist, aber keine Einstellungen, keine zweite Gegnerrolle, keine Zielmarkierungen oder keinen Touch-Pfad hat, ist keine fertige Runde.
  4. Eine Änderung pro Runde, dann alle Prüfungen ausführen. Eine Runde ist nur gültig, wenn keine Prüfung eine Regression aufweist. Ein visueller Gewinn, der das Produkt oder den Spielablauf beeinträchtigt, wird rückgängig gemacht.
  5. Niemals selbst bewerten. Wenn eine Prüfung nicht mit Ihrer Meinung übereinstimmt, gewinnt die Prüfung. Wenn eine Prüfung falsch ist, korrigieren Sie die Prüfung mit einem Gegenbeispiel – umgehen Sie sie niemals.
  6. Halten Sie beim Budget oder beim Plateau an, je nachdem, was zuerst eintritt, und melden Sie die schlechteste Kamera und die Liste der fehlgeschlagenen Prüfungen.

Ein Modell, das diese sechs Regeln befolgt, produziert vergleichbare Ergebnisse zu einem Bruchteil der Kosten; ein Modell, das Regel 5 überspringt, produziert plausibel aussehende Regressionen.

Liefervertrag

Ein Durchlauf ist erst abgeschlossen, wenn diese vorhanden sind und alle Prüfungen grün sind:

ArtefaktPrüfung
eine in sich geschlossene HTML-Datei, keine NetzwerkanfragenLaden bei deaktiviertem Netzwerk
Seitenvertrag offengelegt (__READY, __STATS, __SCENE, __AUDIT, __COLLIDERS, __BOUNDS, __TESTMOVE, __TEST, __GAME, __PRODUCT)Framework liest sie aus
fertige SpielhülleMenü, Einstellungen, Pause, Speichern, Touch, HUD-Hierarchie, Ende/Neustart
Inhaltsbreite≥2 Feinde/interagierbare Rollen, ≥2 Werkzeuge, ≥1 Zielkette, ≥3 Beats
ZählungsberichtAbdeckung = 100 %, null Fehler
Lichtprüfungjedes Licht an einer Leuchte verankert
Kollisionsberichtnull Durchdringungen, null außerhalb der Grenzen, Kollider-Parität 100 %
SpieltestSpielablauf abschließbar, Fehlerpfad erreichbar, Neustart funktioniert
Mobiler Bericht390×844 Layout, kein horizontaler Überlauf, Touch-Steuerung vorhanden
Box-Bericht zu 3–6 Subjektobjektenjede Metrik >= 0,8 des Referenzwerts
Bildpunktzahlgemeldet, aber niemals verwendet, um eine Prüfung außer Kraft zu setzen

Vertrag für das fertige Produkt

Ein spielbarer Rahmen ist kein fertiges Spiel. Die Spielablauf-Prüfungen schützen das Verhalten; die Produktprüfungen schützen die Hülle, die Inhaltsbreite und den ersten Eindruck. Deklarieren Sie Folgendes auf der Seite, damit harness/product.mjs es überprüfen kann, ohne die Gedanken des Modells lesen zu müssen.

ArtefaktMinimum
BildschirmeMenü, Spielen, Pause, Einstellungen, Verloren, Gewonnen
Titelbildschirmsichtbar beim Laden; HUD versteckt; Titel, Prämisse, Start, Einstellungen/Steuerung
EinstellungenEmpfindlichkeit, Lautstärke, Sichtfeld, Y-Invertierung, Qualität (oder eine gleichwertige Zusammenstellung)
Persistenzein Schlüssel überlebt das Neuladen (beste Punktzahl/Fortschritt/Einstellungen)
EingabeTastatur + Maus + Touch; Zielhilfe bei fehlgeschlagener Zeigersperre
Ziele≥1 Kette mit ≥3 Beats und Weltmarkierungen/Kompass
Rollen≥2 Feinde/Hindernis-/Interaktionsrollen, nicht nur eine mit anderer Farbe
Werkzeuge≥2: ein primäres und ein sekundäres Verb (Waffe/Werkzeug/Fähigkeit)
HUDZiel+Fortschritt, Überleben, Waffe/Munition, Kontextaufforderung, Kompass/Markierungen, Untertitel
AudioStummschaltung + ≥6 Zustandsänderungsereignisse
KamerasHelden- + Nahaufnahmen-Standbildkameras in __PRODUCT.cameras
Leistungfestgelegte Budgets für Aufrufe/Dreiecke/Lichter, gemessen nach dem Start
Mobil390×844 ohne horizontalen Überlauf; Touch-Steuerung erreichbar

Inhaltsbudget für einen vertikalen Ausschnitt

Füllen Sie dies vor jedem künstlerischen Durchgang aus. Ein vertikaler Ausschnitt ist eine 3–8-minütige Sitzung mit einer vollständigen Zielkette, zwei Rollen, einem charakteristischen System und einer gestalteten Hülle. Er ist kleiner als eine Demo-Rolle und größer als eine Tech-Demo.

BereichVertikaler AusschnittFertiges kleines Spiel
Ziele1 Kette, 3 Beats1–3 Ketten, 5–8 Beats
Feinde/Interaktionsrollen23–5 + ein Höhepunkt
Waffen/Werkzeuge2 (primär + sekundär)3–5
Spielerverbenbewegen, zielen, feuern, nachladen+ hocken/springen/interagieren/fähigkeit
Weltein Ort, 3 Tiefenschichten2–3 verbundene Räume
HülleTitel, Pause, Einstellungen, Ende+ speichern, qualität, touch
Sitzung3–8 min10–30 min

Das Manifest ist eine Behauptung; die Prüfung überprüft das DOM-Verhalten und die deklarierten Anzahlen. Deklarieren Sie nicht, was die Seite nicht tut.

window.__PRODUCT = {
  title: { name: 'Spielname', start: '#start', hud: '#hud', hudHiddenOnTitle: true },
  screens: ['menu', 'playing', 'paused', 'settings', 'lost', 'won'],
  ui: { start: '#start', hud: '#hud', pause: '#pause', settings: '#settings', end: '#end', touch: '#touch' },
  settings: ['sensitivity', 'volume', 'fov', 'invertY', 'quality'],
  persistence: ['game.best'],
  input: { keyboard: true, mouse: true, touch: true },
  content: {
    objectives: [{ id: 'objective-1', title: 'Ziel', steps: 3 }],
    roles: ['role-a', 'role-b'],
    tools: ['tool-a', 'tool-b'],
    beats: ['intro', 'contact', 'mid', 'climax', 'win'],
  },
  hud: ['objective', 'compass', 'health', 'ammo', 'prompt', 'subtitles'],
  audio: { events: 10, mute: true },
  perf: { maxCalls: 700, maxTris: 400000, maxLights: 14 },
  cameras: [
    { name: 'held', cam: [0.5, 1.7, 10, -2.6, 1.3, -10] },
    { name: 'nah', cam: [-6.4, 1.4, 5.2, -9.9, 1.0, 2.2] },
  ],
  test: { start: 'start', pause: 'pause', resume: 'resume', settings: 'openSettings', save: 'save' },
};

Standard __TEST-Aktionen (zusätzliche Aktionen erlaubt): start, pause, resume, openSettings, closeSettings, save, state. Sie müssen ohne Zeigersperre funktionieren und einen JSON-sicheren Schnappschuss zurückgeben. Der Titelbildschirm muss das HUD verstecken; der Start muss es einblenden; Einstellungs-, Pause- und Endbildschirme müssen im DOM inspizierbar sein.

Wann verwenden

  • Eine Szene ist geometrisch korrekt, wirkt aber flach, plastisch oder „generiert".
  • Eine Darstellung muss einem Referenzfoto, -konzept oder einer Bildregie entsprechen.
  • Beleuchtung, Materialien oder Komposition müssen kontrolliert verbessert werden.
  • Eine lange Generierung muss über viele Iterationen hinweg kohärent bleiben.

Wann nicht verwenden

  • Absichtlich stilisierte Ausgabe (flache Schattierung, Cel-Shading, diagrammartig, UI-artig). Diese benötigen konsistente Abstraktion, keine physikalische Plausibilität. Das Verfahren ist übertragbar, aber ersetzen Sie das fotorealistische Profil und die Look-Prüfung durch eine stilistisch konsistente; eine stilisierte Szene, die an einem fotografischen Profil gemessen wird, verliert konstruktionsbedingt, nicht qualitätsbedingt.
  • Präzisionsaufgaben (CAD, technische Zeichnungen), bei denen Lesbarkeit vor Realismus geht.
  • Szenen ohne Kamera: Datenvisualisierung, Knotengraphen, UI.

Modell des Problems

Wahrgenommener Realismus kommt von fünf Hebeln. Wenden Sie sie in dieser Reihenfolge an; der Ertrag pro Aufwand nimmt mit absteigender Liste stark ab.

  1. Licht – eine einzelne dominante Quelle mit einer definierten Richtung, Farbe und Höhe, plus eine Umgebung für Reflexionen und Fülllicht.
  2. Materialien – Variation in Rauheit, Normalen und Schmutz, nicht nur Farbe.
  3. Komposition und Dichte – Objekte in mehreren Größenordnungen und Tiefen, mit einem klaren Blickfang und lesbaren Größenhinweisen.
  4. Bildentstehung – Anti-Aliasing, Tonemapping, Bloom, Körnung, Vignette.
  5. Geometriedetail – das letzte Mittel, und nur dort, wo es auf dem Bildschirm mehrere Pixel überlebt.

Zwei Konsequenzen, die es wert sind, explizit genannt zu werden:

  • Details, die kleiner als etwa zwei Pixel sind, werden durch Anti-Aliasing entfernt und tragen nicht zum Bild bei. Das Hinzufügen von Polygonen in dieser Größenordnung ist verschwendet.
  • Eine Szene kann eine korrekte Belichtung haben und dennoch leer wirken. Leere ist ein Dichteproblem, kein Grading-Problem.

Drei weitere Konsequenzen für ein fertiges Spiel:

  • Ein Bild ist notwendig, aber nicht ausreichend. Die Produktebene – Titel-Key-Art, Einstellungen, Pause, Speichern, Touch, Zielmarkierungen, Radio/Untertitel, Inhaltsbreite – wird beurteilt, bevor der Spieler die Beleuchtung bemerkt.
  • Die fünf Hebel sind themenunabhängig. Sie gelten für einen Hafen bei Tageslicht, einen hellen Innenraum, ein verschneites Feld oder eine stilisierte Arena. Nacht/Regen/Nebel sind ein Szenario, nicht der Standard.
  • Die Bildpunktzahl ist ein Kompass für einen Referenz-Look. Sie kann ein fertiges Spiel nicht von einer schönen Demo unterscheiden.

Arbeitsablauf

Jeder Schritt hat ein Ergebnis. Beginnen Sie nicht mit dem nächsten Schritt ohne dieses.

Schritt 1 – Die Darstellung beobachtbar machen (empfohlen vor jeder Szenenarbeit)

Erzeugen Sie eine wiederholbare Möglichkeit, ein Bild aufzunehmen und zu inspizieren.

Ergebnis: Ein Befehl, der ein Bild und idealerweise ein paar Zahlen zurückgibt.

Wenn Ihre Umgebung bereits ein Screenshot-Tool hat, verwenden Sie es. Andernfalls bauen Sie das kleinste, das funktioniert:

  • Starten Sie einen kopflosen Browser gegen einen lokalen statischen Server.
  • Warten Sie auf ein Bereitschaftssignal der Seite (siehe Vertrag unten), nehmen Sie dann auf.
  • Berechnen Sie optional Bildstatistiken: Belichtungshistogramm, Beschnitt, Farbanzahl, Kantendichte.

Seitenvertrag, der Aufnahmen deterministisch hält:

window.__READY = true;                      // nach einigen gerenderten Frames setzen
window.__STATS = { calls, triangles };      // optionale Renderer-Zähler
// optionale Abfrageparameter
// ?shot=1            UI ausblenden
// ?cam=x,y,z,tx,ty,tz feste Kamera
// ?seed=N            fester Zufallsseed

Regeln:

  • Feste Kamera, fester Seed, fester Viewport für jeden Vergleich.
  • Speichern Sie jede Aufnahme unter einem versionierten Namen; überschreiben Sie niemals die vorherige.
  • Wenn keine Metriken verfügbar sind, behalten Sie die Bilder und vergleichen Sie sie nebeneinander. Visueller Vergleich ist ausreichend; Metriken machen die Zuordnung nur schneller.

Schritt 2 – Ein Bildregie-Konzept schreiben

Ergebnis: Eine kurze Tabelle. Jede Zeile muss konkret genug zum Implementieren sein.

EntscheidungInhalt
MotivWorum geht es im Bild, in welchem Maßstab
Zeit und Wetterbestimmt Nebel, Reflexionsstärke, Kontrast
HauptlichtRichtung, Höhe, Farbtemperatur, Intensität
Himmel und UmgebungFarbe der Schattenfüllung
MaterialfamilieWelche Oberflächen gibt es, wie rau, wie nass
BlickfangWorauf das Auge zuerst fallen soll
EinschränkungenWas nicht vorkommen darf (z. B. reines Weiß, flacher Boden, klarer Himmel)

Leitfaden:

  • Wählen Sie eine dominante Lichtgeschichte. Zusätzliche Quellen sind Fülllicht, Aufhellung oder praktische Leuchten und müssen untergeordnet sein.
  • Beschränken Sie das Motiv, bevor Sie Details hinzufügen. Bedingungen, die die sichtbare Komplexität reduzieren – Nacht, Regen, Nebel, Staub, Gegenlicht, Industrielandschaften oder Innenräume – sind legitime und effektive Entscheidungen, keine Abkürzungen.
  • Wählen Sie eine Haupthöhe bewusst. Die Schattenlänge skaliert mit Höhe / tan(Höhe): Eine niedrige Hauptlichtquelle erzeugt lange Schatten, die den gesamten Vordergrund in den Schatten stellen können, was wie „keine Schatten" wirkt. Mittlere Höhen (etwa 20–30°) liefern normalerweise sowohl Form als auch einen beleuchteten Bereich, um Kontrast zu erzeugen.
  • Wählen Sie das Beleuchtungsszenario vor dem Kit. Verfallen Sie nicht standardmäßig in Nacht, Regen oder Industrieinnenräume, weil sie fehlende Details verbergen. Nacht ist eine Option; eine Gegenlichtdämmerung oder ein heller Innenraum ist schwieriger und oft überzeugender.
SzenarioHauptlichtFülllicht / IBLLuftSignaturmaterial
Industrie bei Nachtkühles, niedrig-mittleres Hauptlicht, praktische LeuchtenHimmelsumgebung, warme Lichthöfeexponentiell, himmelfarbennasser Boden, leuchtende Leuchten
Bedeckter Tageslichtbreites Himmels-Hauptlicht, 35–60°starkes IBLdünne Luftperspektivematter Beton, Pfützen
Goldene Stunde / Gegenlichtniedriges, warmes Hauptlicht hinter dem Motivkühle Himmelsfüllunglanger Dunst, Randlichtnasser Asphalt, Glas, Metall
Klarer Mittaghohes Hauptlicht, harte SchattenHimmelsfüllung + AufhellungminimalSand, Stein, Farbe
Innenraum mit praktischen LeuchtenFenster + einige warme QuellenFenster-/HimmelsumgebungLichtstrahlen, StaubHolz, Stoff, Metall
Unterirdisch / künstliches Lichtpraktische Leuchten + Leuchtmittelniedrige Umgebungvolumetrischnasser Beton, Schilder

Eine Gegenlichtszene ist nicht „einfacher": Sie deckt beschnittene Lichter, Farbstiche und schwache Silhouetten auf. Korrigieren Sie Belichtung und Highlight-Rolloff, bevor Sie die Szene für fertig erklären.

Schritt 3 – Baue den Kit

Ein Kit ist die Menge der drehbaren, beweglichen und kollidierenden Objekte in der Szene – nicht das Gelände, die Hintergrundkulisse oder die Himmelskugel. Für ein Spiel muss jedes Kit-Teil eine Kollisionshülle haben, die der Silhouette entspricht. Die Kit-Tabelle zwingt zu dieser Entscheidung, bevor ein Polygon platziert wird.

SpalteTypBeispiel
TeilKennungführerhaus, container20, rad_vr, hub
Abmessungen[x, y, z][2.4, 1.6, 6.0]
Massekg oder vernachlässigbar2500
KolliderKasten / Kugel / Zylinder / NetzKasten
UnterteileListe der enthaltenen Teile[tür_l, tür_r] (optional)
AufkleberKennung + UV-Transformationdreckig: (0,0)→(1,1) (optional)

Jedes Teil, das später animiert und kollidiert wird, muss hier aufgeführt werden. Füllen Sie die letzte Spalte, bevor Sie mit Schritt 5 fortfahren.

Schritt 4 – Weise Oberflächen zu

Jedes Material in der Szene muss eine Zeile in der Oberflächentabelle haben, bevor eine Beleuchtung eingerichtet wird. Das Modell muss eine Rauheits- und Normalenstruktur für jeden Materialeintrag angeben, nicht nur eine diffuse Farbe.

OberflächeAlbedoRauheitNormalenstärkeMaßstab
Boden_dreckig#5c4a3a0.850.48.0
Wand_beton#9a9a9a0.750.64.0
Rost_metall#6b4c3a0.450.82.0

Das Modell sollte die Werte aus der Referenz oder aus plausiblen physischen Grenzen beziehen. Jeder Eintrag, der auf einen Standardwert gesetzt ist, ohne dass eine Begründung gegeben wird, gilt als nicht deklariert.

Schritt 5 – Platziere Lichter

Jedes Licht benötigt eine Position, eine Farbe und eine zugehörige Leuchte in der Szene. Eine Leuchte ist ein sichtbares Objekt, das die Quelle physisch verankert – eine Glühbirne, ein Fenster, die Sonnenscheibe, eine Deckenleuchte. Ein Licht ohne eine Leuchte ist ein „schwebendes Licht" und wird von der Lichtprüfung abgelehnt.

LichtTypPositionFarbe / TemperaturIntensitätFalloffLeuchte
sonnegerichtet(0.3, 0.7, -0.5)#fff4e012—sonnenscheibe
deckenlicht_01punkt(4.0, 3.5, -2.0)3000 K806deckenleuchte_01

Die Leuchte muss ein sichtbares, positioniertes Objekt sein, das das Auge in der Szene als Quelle identifizieren kann. Unabhängig von der Lichtstärke: Wenn ein Spieler die Quelle nicht sehen kann, ist sie nicht verankert.

Schritt 6 – Kodiere den Spielablauf

Ein Spielablauf ist eine Tabelle mit einem Verb (was der Spieler tut), einem System (was darauf reagiert), einer Rückmeldung (was der Spieler sieht/hört), einem Fehler (wann der Spieler verliert) und einem Test (wie der Spieler gewinnt). Füllen Sie eine Zeile pro Spielablauf.

VerbSystemRückmeldungFehlerTest
hebenHebekran-Physik, Kabine neigt sichKabel strafft sich, Last schwanktÜberlast / Kippen / ZeitlimitLadezone erreicht, Ladung gesichert

Ein Spiel ohne mindestens einen Fehlerpfad ist keine Herausforderung und besteht den Spieltest nicht.

Schritt 7 – Produkthülle zusammenstellen

Bevor Sie die Zielkette, die Feind-KI oder das Audio bauen, stellen Sie sicher, dass das Grundgerüst aus Menü, Pause, Einstellungen und Ende funktioniert. Die Produktprüfungen erwarten, dass diese Bildschirme vorhanden und über das DOM zugänglich sind. Die __TEST-Aktionen müssen diese ohne Zeigersperre öffnen können.

Schritt 8 – Eine Runde ausführen

Eine Runde ist ein Zyklus: eine Änderung an der Szene (Licht, Kit, Material, Spielablauf) → Produktprüfungen + Spielablaufprüfungen + Look-Prüfungen → Bildpunktzahl aufzeichnen → zurück zur nächsten Änderung. Das Modell darf niemals mehrere Änderungen ohne zwischenzeitliche Prüfungen vornehmen: Eine einzelne Regression ist sofort erkennbar.

Jede Runde endet mit der Liste der fehlgeschlagenen Prüfungen und der schlechtesten Kamera (niedrigste Punktzahl). Die Runde ist gültig, wenn die fehlgeschlagenen Prüfungen die vorherige Runde nicht verschlechtern.

Prüfungsreferenz

Das Test-Framework führt diese Prüfungen aus. Jede muss in der Testausgabe grün sein. Das Modell kann sie nach eigenem Ermessen ausführen oder sich auf das Framework verlassen, aber die Ausgabe des Frameworks hat Vorrang vor der Meinung des Modells.

Produktprüfung (harness/product.mjs)

Prüft, ob das Spiel die Anforderungen an die Hülle und den Mindestinhalt erfüllt. Sie prüft das Vorhandensein von __PRODUCT und validiert jedes Feld, einschließlich der Bildschirme, Einstellungen, Eingaben, des Audio-Counts, des HUD, der Kameras und der Leistungsbudgets. Ein Fehler in der Produktprüfung bedeutet, dass das Spiel nicht das richtige Grundgerüst hat.

Zählungsprüfung (harness/census.mjs)

Prüft die von __CENSUS { coverage } gemeldete Abdeckung. coverage = 100 % bedeutet, dass jedes deklarierte Feature in der Szene vorhanden und funktionsfähig ist. Die Prüfung erwartet, dass die Seite einen Zählungsbericht zurückgibt, der Punkt-für-Punkt mit der Produktdeklaration abgeglichen wird.

Kollisionsprüfung (harness/collide.mjs)

Führt eine Reihe von Standardbewegungen für jede Szene aus (vorwärts, rückwärts, seitwärts, Sprung, Fallenlassen) und berichtet, ob der Spieler in andere Objekte eindringt, die Grenzen verlässt oder unerwartet stecken bleibt. Sie erwartet, dass __COLLIDERS und __BOUNDS korrekt offengelegt werden.

Lichtprüfung (harness/lights.mjs)

Sucht nach jedem deklarierten Licht, überprüft, ob es eine sichtbare Leuchte gibt, und meldet Lichter ohne Leuchten. Ein Licht ohne Leuchte gilt als nicht verankert und schlägt fehl.

Spieltest-Prüfung (harness/playtest.mjs)

Führt die __TEST-Aktionen aus (Start, Pause, Fortsetzen, Einstellungen, Ende, Zustand), um zu überprüfen, ob der Spielablauf abgeschlossen werden kann, der Fehlerpfad erreichbar ist und der Neustart funktioniert. Sie überprüft, ob die Aktionssequenz zu einem Win- oder Loss-Zustand führt und ob die Seite nach dem Neustart in einen neutralen Zustand zurückgesetzt wird.

Mobile Prüfung (harness/mobile.mjs)

Setzt den Viewport auf 390×844, lädt die Seite neu und prüft auf horizontalen Überlauf. Sie überprüft auch, ob Touch-Steuerelemente vorhanden und erreichbar sind.

Look-Prüfung (harness/look.mjs)

Nimmt ein Bild auf, vergleicht es mit einem Referenzbild und meldet Metriken (PSNR, SSIM, Histogramm-Ähnlichkeit). Der Schwellenwert liegt standardmäßig bei 80 % des Referenzwerts, kann aber pro Projekt eingestellt werden. Die LookPrüfung protokolliert die Bildpunktzahl, verwendet sie jedoch niemals, um eine andere Prüfung außer Kraft zu setzen.

Fehlerbehebung bei häufigen Problemen

  • Licht fällt durch Prüfung: Die Leuchte ist unsichtbar oder nicht vorhanden. Fügen Sie ein Leuchten-Objekt zur Szene hinzu (Glühbirne, Deckenleuchte, Fenster) und verknüpfen Sie es mit der Lichtquelle.
  • Kollisionsprüfung schlägt fehl: Entweder fehlt die Hülle (keine Kollisionserkennung auf dem Kit-Teil) oder die Hülle ist zu grob (rechteckiger Kasten um ein komplexes Objekt). Fügen Sie dem Teil eine Kolliderform hinzu, die enger an der Silhouette liegt.
  • Zählungsprüfung schlägt fehl: Die Seite meldet nicht __CENSUS { coverage: 100 }. Dies geschieht normalerweise, weil ein deklariertes Feature fehlt (Rolle, Werkzeug, Beat). Überprüfen Sie die Produktdeklaration erneut.
  • Mobile Prüfung schlägt fehl: Die Seite hat bei 390 Pixel Breite horizontales Scrollen. Dies wird durch feste Pixelbreiten, übergroße UI-Elemente oder nicht reagierende Layouts verursacht. Verwenden Sie prozentuale oder viewport-relative Einheiten für das Layout.
  • Spieltest-Prüfung schlägt fehl: Der Fehlerpfad ist nicht erreichbar oder der Neustart funktioniert nicht. Schreiben Sie einen manuellen Test, um den Fehlerpfad auszulösen (z. B. Stillstand, Zeitüberschreitung, Kollision mit einem feindlichen Objekt), und überprüfen Sie, ob die Seite nach dem Neustart auf den Startbildschirm zurückgesetzt wird.
  • Produktprüfung schlägt fehl: Ein Feld in __PRODUCT fehlt oder ist falsch. Überprüfen Sie das Array screens, die ui-Selektoren und die Testaktionen. Jeder Bildschirm muss ein DOM-Element sein, das bei Aktion sichtbar wird.
  • Look-Prüfung schlägt fehl: Die Bildmetriken liegen unter der Schwelle. Dies kann an Rauschen, zeitlichem Aliasing oder einer nicht deterministischen Kamera liegen. Fixieren Sie den Seed, die Kamera und den Frame-Zähler für Aufnahmen.

Abschlusskriterien

Ein Durchlauf ist abgeschlossen, wenn:

  • Die Produktprüfung besteht (alle Felder vorhanden und gültig)
  • Die Zählungsprüfung besteht (Abdeckung = 100 %)
  • Die Kollisionsprüfung besteht (null Durchdringungen, null außerhalb der Grenzen)
  • Die Lichtprüfung besteht (alle Lichter verankert)
  • Der Spieltest besteht (Spielablauf abschließbar, Fehlerpfad erreichbar, Neustart funktioniert)
  • Der mobile Test besteht (390×844, kein Überlauf, Touch vorhanden)
  • Die Look-Prüfung mindestens 80 % des Referenzwerts erreicht

Wenn eines dieser Kriterien nicht erfüllt ist, wird der Durchlauf als fehlgeschlagen gemeldet. Das Modell sollte die fehlgeschlagene Prüfung identifizieren, die Szene korrigieren und erneut ausführen.

Verwandte Skills