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.
- 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. - 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).
- 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. - 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.
- 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.
- 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:
| Artefakt | Prüfung |
|---|---|
| eine in sich geschlossene HTML-Datei, keine Netzwerkanfragen | Laden bei deaktiviertem Netzwerk |
Seitenvertrag offengelegt (__READY, __STATS, __SCENE, __AUDIT, __COLLIDERS, __BOUNDS, __TESTMOVE, __TEST, __GAME, __PRODUCT) | Framework liest sie aus |
| fertige Spielhülle | Menü, Einstellungen, Pause, Speichern, Touch, HUD-Hierarchie, Ende/Neustart |
| Inhaltsbreite | ≥2 Feinde/interagierbare Rollen, ≥2 Werkzeuge, ≥1 Zielkette, ≥3 Beats |
| Zählungsbericht | Abdeckung = 100 %, null Fehler |
| Lichtprüfung | jedes Licht an einer Leuchte verankert |
| Kollisionsbericht | null Durchdringungen, null außerhalb der Grenzen, Kollider-Parität 100 % |
| Spieltest | Spielablauf abschließbar, Fehlerpfad erreichbar, Neustart funktioniert |
| Mobiler Bericht | 390×844 Layout, kein horizontaler Überlauf, Touch-Steuerung vorhanden |
| Box-Bericht zu 3–6 Subjektobjekten | jede Metrik >= 0,8 des Referenzwerts |
| Bildpunktzahl | gemeldet, 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.
| Artefakt | Minimum |
|---|---|
| Bildschirme | Menü, Spielen, Pause, Einstellungen, Verloren, Gewonnen |
| Titelbildschirm | sichtbar beim Laden; HUD versteckt; Titel, Prämisse, Start, Einstellungen/Steuerung |
| Einstellungen | Empfindlichkeit, Lautstärke, Sichtfeld, Y-Invertierung, Qualität (oder eine gleichwertige Zusammenstellung) |
| Persistenz | ein Schlüssel überlebt das Neuladen (beste Punktzahl/Fortschritt/Einstellungen) |
| Eingabe | Tastatur + 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) |
| HUD | Ziel+Fortschritt, Überleben, Waffe/Munition, Kontextaufforderung, Kompass/Markierungen, Untertitel |
| Audio | Stummschaltung + ≥6 Zustandsänderungsereignisse |
| Kameras | Helden- + Nahaufnahmen-Standbildkameras in __PRODUCT.cameras |
| Leistung | festgelegte Budgets für Aufrufe/Dreiecke/Lichter, gemessen nach dem Start |
| Mobil | 390×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.
| Bereich | Vertikaler Ausschnitt | Fertiges kleines Spiel |
|---|---|---|
| Ziele | 1 Kette, 3 Beats | 1–3 Ketten, 5–8 Beats |
| Feinde/Interaktionsrollen | 2 | 3–5 + ein Höhepunkt |
| Waffen/Werkzeuge | 2 (primär + sekundär) | 3–5 |
| Spielerverben | bewegen, zielen, feuern, nachladen | + hocken/springen/interagieren/fähigkeit |
| Welt | ein Ort, 3 Tiefenschichten | 2–3 verbundene Räume |
| Hülle | Titel, Pause, Einstellungen, Ende | + speichern, qualität, touch |
| Sitzung | 3–8 min | 10–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.
- Licht – eine einzelne dominante Quelle mit einer definierten Richtung, Farbe und Höhe, plus eine Umgebung für Reflexionen und Fülllicht.
- Materialien – Variation in Rauheit, Normalen und Schmutz, nicht nur Farbe.
- Komposition und Dichte – Objekte in mehreren Größenordnungen und Tiefen, mit einem klaren Blickfang und lesbaren Größenhinweisen.
- Bildentstehung – Anti-Aliasing, Tonemapping, Bloom, Körnung, Vignette.
- 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.
| Entscheidung | Inhalt |
|---|---|
| Motiv | Worum geht es im Bild, in welchem Maßstab |
| Zeit und Wetter | bestimmt Nebel, Reflexionsstärke, Kontrast |
| Hauptlicht | Richtung, Höhe, Farbtemperatur, Intensität |
| Himmel und Umgebung | Farbe der Schattenfüllung |
| Materialfamilie | Welche Oberflächen gibt es, wie rau, wie nass |
| Blickfang | Worauf das Auge zuerst fallen soll |
| Einschränkungen | Was 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.
| Szenario | Hauptlicht | Fülllicht / IBL | Luft | Signaturmaterial |
|---|---|---|---|---|
| Industrie bei Nacht | kühles, niedrig-mittleres Hauptlicht, praktische Leuchten | Himmelsumgebung, warme Lichthöfe | exponentiell, himmelfarben | nasser Boden, leuchtende Leuchten |
| Bedeckter Tageslicht | breites Himmels-Hauptlicht, 35–60° | starkes IBL | dünne Luftperspektive | matter Beton, Pfützen |
| Goldene Stunde / Gegenlicht | niedriges, warmes Hauptlicht hinter dem Motiv | kühle Himmelsfüllung | langer Dunst, Randlicht | nasser Asphalt, Glas, Metall |
| Klarer Mittag | hohes Hauptlicht, harte Schatten | Himmelsfüllung + Aufhellung | minimal | Sand, Stein, Farbe |
| Innenraum mit praktischen Leuchten | Fenster + einige warme Quellen | Fenster-/Himmelsumgebung | Lichtstrahlen, Staub | Holz, Stoff, Metall |
| Unterirdisch / künstliches Licht | praktische Leuchten + Leuchtmittel | niedrige Umgebung | volumetrisch | nasser 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.
| Spalte | Typ | Beispiel |
|---|---|---|
| Teil | Kennung | führerhaus, container20, rad_vr, hub |
| Abmessungen | [x, y, z] | [2.4, 1.6, 6.0] |
| Masse | kg oder vernachlässigbar | 2500 |
| Kollider | Kasten / Kugel / Zylinder / Netz | Kasten |
| Unterteile | Liste der enthaltenen Teile | [tür_l, tür_r] (optional) |
| Aufkleber | Kennung + UV-Transformation | dreckig: (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äche | Albedo | Rauheit | Normalenstärke | Maßstab |
|---|---|---|---|---|
| Boden_dreckig | #5c4a3a | 0.85 | 0.4 | 8.0 |
| Wand_beton | #9a9a9a | 0.75 | 0.6 | 4.0 |
| Rost_metall | #6b4c3a | 0.45 | 0.8 | 2.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.
| Licht | Typ | Position | Farbe / Temperatur | Intensität | Falloff | Leuchte |
|---|---|---|---|---|---|---|
| sonne | gerichtet | (0.3, 0.7, -0.5) | #fff4e0 | 12 | — | sonnenscheibe |
| deckenlicht_01 | punkt | (4.0, 3.5, -2.0) | 3000 K | 80 | 6 | deckenleuchte_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.
| Verb | System | Rückmeldung | Fehler | Test |
|---|---|---|---|---|
| heben | Hebekran-Physik, Kabine neigt sich | Kabel strafft sich, Last schwankt | Überlast / Kippen / Zeitlimit | Ladezone 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
__PRODUCTfehlt oder ist falsch. Überprüfen Sie das Arrayscreens, dieui-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.