1. Shader-Kompilierung, Kochen, Staging und Packaging trennen
Shader-Kompilierung, Content Cooking, Staging und Packaging sind getrennte Phasen. Das Shader-Arbeiten wandelt Material- und globale Shader-Permutationen in zielplattform-spezifische Shader-Formate um. Cooking serialisiert platformbereite Assets. Staging assembliert gecookte Inhalte und Voraussetzungen. Packaging erzeugt den verteilbaren Container oder Installer. Benennen Sie die fehlerhafte Phase, bevor Sie Einstellungen oder Caches ändern.
Annotieren Sie ein Build-Log mit Phasenbeginn- und -endezeiten, Zielplattform, Konfiguration, Engine-Revision, Shader-Formaten, Cook-Modus und Ausgabepfad. Eine langsame erste Shader-Kompilierung kann durch Cache-Auffüllung erwartet werden; ein Kochvorgang, der wiederholt bei einem Asset fehlschlägt, ist ein deterministischer Inhaltfehler; ein gestaffelter Build, der nicht startet, ist ein anderes Akzeptanzproblem.
Getrennte Checkliste für Shader-Kompilierung, Kochen, Staging und Packaging
- Formulieren Sie die Entscheidung für „Shader-Kompilierung, Cooking, Staging und Packaging trennen“ in einem Satz.
- Dokumentieren Sie, wie die Berechtigung an Shader-Permutationen verwaltet, versioniert und validiert wird.
- Testen Sie die zugehörige Suchanfrage „unreal engine cooking failed“ anhand derselben Akzeptanzkriterien.
- Erfassen Sie Frame-Perzentile, Lane-Millisekunden, Hitches, Peak- und Resident-Speicher, Loads, Bandbreite und Regressionsgrenzen.
- Halten Sie eine rückgängig machbare Arbeitsversion vor und dokumentieren Sie die Einschränkung, die einen Rollback erforderlich machen würde.
2. Das erste umsetzbare Log-Evidenzstück bewahren
Bewahren Sie das vollständige Log vor der Bereinigung auf. Suchen Sie von oben nach dem ersten Fehler, der einem Asset, Plugin, Modul, Serializer, SDK, Shader-Compiler oder Plattformregel zugeordnet ist; der finale „Unknown Error“ fasst oft eine frühere Ursache zusammen. Speichern Sie die Kommandozeile, Umgebung, Quellrevision, aktivierte Plugins, Ziel-RHI und ob der Lauf sauber oder inkrementell war.
Erstellen Sie einen nahen Erfolgstestfall, indem Sie eine verdächtige Map, ein Asset, ein Plugin oder eine Konfigurationsänderung entfernen, ohne alles andere zu verändern. Wenn der Fehler verschwindet, stellen Sie das Element wieder her und reproduzieren Sie erneut. Dieser beidseitige Test unterscheidet einen echten Abhängigkeitsfehler von einem vorübergehenden Worker- oder Cache-Symptom und liefert der CI ein fokussiertes Regressions-Fixture.
Bewahren Sie die Checkliste der ersten umsetzbaren Log-Nachweise auf
- Geben Sie die Entscheidung für „Das erste umsetzbare Log-Evidenzstück bewahren“ in einem Satz an.
- Dokumentieren Sie, wie Cook-Phase und Zielplattform-Inhalte zugeordnet, versioniert und validiert werden.
- Testen Sie die zugehörige Suchanfrage „unreal engine cooking failed“ anhand derselben Akzeptanzkriterien.
- Erfassen Sie Frame-Perzentile, Lane-Millisekunden, Hitches, Peak- und Resident-Speicher, Loads, Bandbreite und Regressionsgrenzen.
- Halten Sie eine rückgängig machbare Arbeitsversion vor und dokumentieren Sie die Einschränkung, die einen Rollback erforderlich machen würde.
3. Diagnose von Shader-Permutationen und Derived Data
Das Anwachsen der Permutationen entsteht durch Materialfunktionen, Static Switches, Qualitätsstufen, Plattformen, Vertex Factories und globale Shader-Bedingungen. Erstellen Sie eine Bestandsaufnahme der Kombinationen, die das ausgelieferte Spiel tatsächlich benötigt, bevor Sie die Kompilierung erzwingen. Eine Material-Instanz kann Laufzeit-Parameter günstig ändern, während ein Static Switch einen eigenen Kompilierungspfad erzeugt, der gebaut und gespeichert werden muss.
Derived Data Cache speichert reproduzierbare abgeleitete Produkte und kann wiederholte Arbeit reduzieren, ist aber nicht die Wahrheit der Wahrheit. Vergleichen Sie lokale Cold-Builds, warme lokale Builds und Shared-Cache-Builds; protokollieren Sie Trefferverhalten, Worker-Nachfrage, Netzwerkdurchsatz und Invalidierung nach Engine- oder Quelländerungen. Das Löschen von DDC ist ausschließlich ein Diagnoseversuch, erst nachdem Beweise gespeichert wurden.
Diagnostizieren Sie Shader-Permutationen und Derived Data Checkliste
- Formulieren Sie die Entscheidung für „Diagnose von Shader-Permutationen und Derived Data“ in einem Satz.
- Dokumentieren Sie, wie die früheste umsetzbare Build-Log-Evidenz zugeordnet, versioniert und validiert wird.
- Testen Sie die zugehörige Suchanfrage „unreal engine cooking failed“ anhand derselben Akzeptanzkriterien.
- Erfassen Sie Frame-Perzentile, Lane-Millisekunden, Hitches, Peak- und Resident-Speicher, Loads, Bandbreite und Regressionsgrenzen.
- Halten Sie eine rückgängig machbare Arbeitsversion vor und dokumentieren Sie die Einschränkung, die einen Rollback erforderlich machen würde.
4. Diagnose von Kochfehlern nach Asset und Abhängigkeit
Kochfehler zeigen häufig fehlende Referenzen, Redirector, nicht unterstützte Asset-Formate, editor-only Abhängigkeiten, Serialisierungsänderungen, Plugin-Inhaltsregeln, in der Konfiguration ausgelassene Maps oder Zielplattform-Einschränkungen. Verwenden Sie den Asset-Pfad im frühesten Fehler, um Referenzen zu prüfen und das Asset in derselben Engine-Revision zu laden, die von der Automatisierung verwendet wird.
Testen Sie das reparierte Asset in einem minimalen Cook und danach im vollständigen Projekt. Beheben Sie Redirectors gezielt, speichern Sie nur betroffene Pakete neu, prüfen Sie Plugin-Deskriptoren und Runtime-Module und bestätigen Sie, dass Soft References und Asset-Manager-Regeln den erforderlichen Inhalt enthalten. Eine erfolgreiche Editor-Ladung beweist nicht, dass das Ziel-Cook ihn enthält oder deserialisieren kann.
Diagnostizieren Sie Kochfehler nach Asset und Abhängigkeits-Checkliste
- Formulieren Sie die Entscheidung für „Diagnose von Kochfehlern nach Asset und Abhängigkeit“ in einem Satz.
- Dokumentieren Sie, wie die Clean-Build-Zeiterfassung und Cache-Grenzen verwaltet, versioniert und validiert werden.
- Testen Sie die zugehörige Suchanfrage „unreal engine cooking failed“ anhand derselben Akzeptanzkriterien.
- Erfassen Sie Frame-Perzentile, Lane-Millisekunden, Hitches, Peak- und Resident-Speicher, Loads, Bandbreite und Regressionsgrenzen.
- Halten Sie eine rückgängig machbare Arbeitsversion vor und dokumentieren Sie die Einschränkung, die einen Rollback erforderlich machen würde.
5. Buildzeit reduzieren, ohne Fehler zu verbergen
Reduzieren Sie die Dauer durch Entfernen ungenutzter Permutationen, Stabilisierung des gemeinsamen Cache-Zugriffs, Erhöhung der sicheren Worker-Parallellität, Aufteilung unabhängiger Ziele und Vermeidung unnötiger vollständiger Invalidierung. Prüfen Sie jede Änderung gegen denselben Clean- und inkrementellen Build. Verbergen Sie keinen deterministischen Fehler mit Retry-Schleifen und werten Sie einen lokalen schnellen Warm-Build nicht als Release-Verbesserung aus.
Verfolgen Sie Shader-Kompilierungszeit, Kochzeit pro Paket, Cache-Transfer, CPU-Auslastung, Spitzenarbeitsspeicher, Datentransferrate der Festplatte, Artefaktgröße und das längste serielle Segment. Ein sinnvolles Optimierungsprotokoll enthält die Quellrevision, Hardware, Ziel, Cache-Zustand und Streuung über mehrere Durchläufe, sodass das Ergebnis auf einem anderen Builder reproduzierbar ist.
Checkliste: Buildzeit reduzieren, ohne Fehler zu verbergen
- Geben Sie die Entscheidung für „Buildzeit reduzieren, ohne Fehler zu verbergen“ in einem Satz an.
- Dokumentieren Sie, wie die Berechtigung an Shader-Permutationen verwaltet, versioniert und validiert wird.
- Testen Sie die zugehörige Suchanfrage „unreal engine cooking failed“ anhand derselben Akzeptanzkriterien.
- Erfassen Sie Frame-Perzentile, Lane-Millisekunden, Hitches, Peak- und Resident-Speicher, Loads, Bandbreite und Regressionsgrenzen.
- Halten Sie eine rückgängig machbare Arbeitsversion vor und dokumentieren Sie die Einschränkung, die einen Rollback erforderlich machen würde.
6. In Automation reproduzieren und auf einem anderen Rechner
Automatisierung beweist, ob der Projektzustand portabel ist. Starte von einem sauberen Checkout auf einer zweiten Maschine oder einem Worker, stelle nur genehmigte Caches wieder her, installiere die dokumentierte SDK und Engine und führe den exakten Befehl aus. Wenn es nur auf einer Workstation erfolgreich ist, vergleiche Umgebungsvariablen, Plugins, generierte Spieldateien, Berechtigungen und lokal modifizierte Assets.
Halten Sie quellcodekontrollierte Eingaben getrennt von Intermediate, Saved, DerivedDataCache, gestagetem Output und erzeugten Binärdateien. Veröffentlichen Sie Build-Zeiten und Cache-Diagnosen als Artefakte. Die Regression sollte das zuvor fehlschlagende Paket und einen Launch-Smoke-Test enthalten, nicht nur einen grünen Cook-Endcode.
Checkliste: In Automation reproduzieren und auf einem anderen Rechner
- Geben Sie die Entscheidung für „In Automation reproduzieren und auf einem anderen Rechner“ in einem Satz an.
- Dokumentieren Sie, wie Cook-Phase und Zielplattform-Inhalte zugeordnet, versioniert und validiert werden.
- Testen Sie die zugehörige Suchanfrage „unreal engine cooking failed“ anhand derselben Akzeptanzkriterien.
- Erfassen Sie Frame-Perzentile, Lane-Millisekunden, Hitches, Peak- und Resident-Speicher, Loads, Bandbreite und Regressionsgrenzen.
- Halten Sie eine rückgängig machbare Arbeitsversion vor und dokumentieren Sie die Einschränkung, die einen Rollback erforderlich machen würde.
7. Definieren Sie ein Akzeptanz- und Rollback-Gate für Packaging
Ein Packaging-Gate erfordert einen sauberen oder policy-definierten Build, vollständige Logs, Timing im Budget, Artefakt-Hash und -Größe, erfolgreiche Installation oder Extraktion, Start außerhalb des Editors, erforderliches Laden einer Map, Speicher- oder Netzwerk-Smoke-Tests und keine neuen Warnungen hoher Schwere. Ausnahmen benötigen Verantwortliche, Ablaufdaten und eine Rücksetzungsentscheidung.
Behalten Sie das zuletzt als gut bekannte Artefakt und dessen Toolchain-Metadaten bei. Wenn eine Änderung die Build-Zeit-Schwelle überschreitet oder den Starttest fehlschlägt, führen Sie ein Bisection auf Quell- oder Content-Revisionen statt eines vollständigen Cache-Leerens durch. Der endgültige Nachweis ist ein reproduzierbares Artefakt auf der Zielplattform, nicht eine Editor-Sitzung, die zufällig funktioniert.
Definieren Sie eine Packaging-Akzeptanz- und Rollback-Gate-Checkliste
- Geben Sie die Entscheidung für „Definieren eines Packaging-Akzeptanz- und Rollback-Gates“ in einem Satz an.
- Dokumentieren Sie, wie die früheste umsetzbare Build-Log-Evidenz zugeordnet, versioniert und validiert wird.
- Testen Sie die zugehörige Suchanfrage „unreal engine cooking failed“ anhand derselben Akzeptanzkriterien.
- Erfassen Sie Frame-Perzentile, Lane-Millisekunden, Hitches, Peak- und Resident-Speicher, Loads, Bandbreite und Regressionsgrenzen.
- Halten Sie eine rückgängig machbare Arbeitsversion vor und dokumentieren Sie die Einschränkung, die einen Rollback erforderlich machen würde.
SEELE AI Unreal 5 Workflow: generieren, Vorschau, optimieren, Paketieren und Veröffentlichen
SEELE AI ist vor oder parallel zur Unreal-Produktionsphase sinnvoll, wenn das Team eine Szenenrichtung, einen Spieler-Loop, das Kamerafeeling, ein Content-Briefing oder einen Testplan vergleichen muss. Öffnen Sie die kanonische Unreal-Landing-Page, wählen Sie eine reale Workspace-Karte aus und übertragen Sie den Prompt mit zugehöriger Quellenangabe in den Browser-Generierungs-Workspace.
SEELE AI kann ein natives Unreal 5 Spiel generieren, es im Browser in einer Vorschau anzeigen, optimieren und paketieren und ein herunterladbares Spiel oder gepacktes Build für externe Veröffentlichung oder bezahlte Seele-Spiele bereitstellen. Verkäufe sind nicht garantiert.
Offizielle Quellen und verwandte Unreal-Anleitungen
Diese Seite ist eine eigenständige Workflow-Anleitung. Verhaltensänderungen der Engine zwischen Versionen, Plugins, Plattformen und Projekteinstellungen unterscheiden sich, daher prüfen Sie versionsspezifische Details in der Epic-Dokumentation und bewahren Sie die für Ihre Entscheidung verwendeten Nachweise.
Unreal Engine ist eine Marke von Epic Games. SEELE AI ist unabhängig und dieser Leitfaden ist nicht durch Epic Games unterstützt.
- Content Cooking — Erstellt für Produktumfang, Workflow, Version oder Richtlinienprüfungen ist nur erstklassiges Material zugelassen; verwenden Sie nur Behauptungen, die die Quelle tatsächlich aussagt.
- Shader-Entwicklung in Unreal Engine (aktualisiert Juli 2026) — Erstellt für Produktumfang, Workflow, Version oder Richtlinienprüfungen ist nur erstklassiges Material zugelassen; verwenden Sie nur Behauptungen, die die Quelle tatsächlich aussagt.
- Derived Data Cache in Unreal Engine (aktualisiert Juli 2026) — Erstellt für Produktumfang, Workflow, Version oder Richtlinienprüfungen ist nur erstklassiges Material zugelassen; verwenden Sie nur Behauptungen, die die Quelle tatsächlich aussagt.
- Inhalte testen und optimieren — Erstellt für Produktumfang, Workflow, Version oder Richtlinienprüfungen ist nur erstklassiges Material zugelassen; verwenden Sie nur Behauptungen, die die Quelle tatsächlich aussagt.
Häufig gestellte Fragen
Ist Shader-Kompilierung dasselbe wie Cooking?
Nein. Shader-Kompilierung erstellt Shader-Permutationen; Cooking konvertiert Inhalte für eine Zielplattform vor dem Staging und Packaging.
Wo soll ich mit einem Kochfehler anfangen?
Bewahren Sie das vollständige Log auf und beheben Sie den frühesten deterministischen Fehler in Asset, Plugin, Konfiguration oder Toolchain.
Sollte ich zuerst den Derived Data Cache löschen?
Nicht zuerst. Sichern Sie den Nachweis und reproduzieren Sie ihn, bevor Sie Caches leeren; andernfalls können Sie einen deterministischen Projektexfehler verdecken.
Warum dauern saubere Builds länger?
Saubere Builds erzeugen Derived Data und Cooked Output neu, die von inkrementellen Builds wiederverwendet werden können. Messen Sie beide getrennt.
Kann ein einziges fehlerhaftes Asset das Cooking stoppen?
Ja. Nicht unterstützte Formate, kaputte Referenzen, Serialisierungsfehler oder Plattformregeln können den Kochvorgang stoppen.
Was belegt die Korrektur?
Ein sauberer automatisierter Cook und ein lauffähiges verpacktes Artefakt auf der Zielplattform beweisen mehr als einen Editor-Neustart.
