1. シェーダーコンパイル、クッキング、ステージング、パッケージングを分離する
シェーダーコンパイル、コンテンツクッキング、ステージング、パッケージングは独立した工程である。シェーダーの処理では、マテリアルとグローバルシェーダーのパーミュテーションを対象のシェーダーフォーマットへ変換する。クッキングは、プラットフォーム用にシリアライズされたアセットを生成する。ステージングではクッキング済みコンテンツと前提条件を集約する。パッケージングは配布用コンテナまたはインストーラーを生成する。設定やキャッシュを変更する前に、どの工程が失敗したかを特定する。
1つのビルドログに、フェーズ開始時刻と終了時刻、ターゲットプラットフォーム、構成、エンジンリビジョン、シェーダーフォーマット、クックモード、出力パスを注釈します。最初のシェーダーコンパイルが遅いのは、キャッシュの初期投入であることが想定される場合があります。1つのアセットでクックが繰り返し失敗する場合は決定的なコンテンツ欠陥です。ステージング済みビルドが起動しない場合は別の受け入れ問題です。
シェーダーコンパイル、クッキング、ステージング、パッケージングのチェックリストを分離
- 「シェーダーコンパイル、クッキング、ステージング、パッケージングの分離」についての判断を1文で示す。
- シェーダーのパーミュテーションがどのように所有され、バージョン管理され、検証されているかを記録する。
- 関連クエリ「unreal engine cooking failed」を同じ受け入れ基準でテストします。
- フレーム分位数、レーンミリ秒、ヒッチ、ピークメモリと常駐メモリ、ロード、帯域幅、リグレッション閾値を取得する。
- 可逆的な作業リビジョンを保持し、ロールバックを必要とする制限事項を書き込む。
2. 最初に実行可能なログ証拠を保持する
クリーンアップ前にフルログを保存してください。最上部から、アセット、プラグイン、モジュール、シリアライザ、SDK、シェーダーコンパイラ、またはプラットフォーム規則に関連する最初のエラーを検索します。最後の「Unknown Error」はしばしばそれ以前の原因を要約しています。コマンドライン、実行環境、ソースリビジョン、有効化されたプラグイン、ターゲットRHI、クリーン実行か増分実行かを保存してください。
疑わしい1つのマップ、アセット、プラグイン、または設定変更を他を変えずに除去して成功ケースを作成します。エラーが消える場合は、その項目を復元して再度再現してください。この両側テストにより、実在する依存関係か一過性のワーカー/キャッシュ症状かを判別でき、CIに対して焦点を絞った回帰フィクスチャを提供します。
最初に実行可能なログ証拠のチェックリストを保持する
- 「最初に実行可能なログ証拠を保持する」について1文で意思決定を述べてください。
- クックステージとターゲットプラットフォームコンテンツがどのように所有され、バージョン管理され、検証されるかを記録します。
- 関連クエリ「unreal engine cooking failed」を同じ受け入れ基準でテストします。
- フレーム分位数、レーンミリ秒、ヒッチ、ピークメモリと常駐メモリ、ロード、帯域幅、リグレッション閾値を取得する。
- 可逆的な作業リビジョンを保持し、ロールバックを必要とする制限事項を書き込む。
3. シェーダーパー�ミュテーションと派生データを診断する
パーミュテーションの増大は、マテリアル機能、スタティックスイッチ、品質レベル、プラットフォーム、頂点ファクトリ、グローバルシェーダー条件から発生する。出荷ゲームが実際に必要とする組み合わせを先に棚卸しし、不要なコンパイルを強制しない。マテリアルインスタンスは実行時パラメータを安価に変更できるが、スタティックスイッチは必ず別々のコンパイルパスを作り、構築および保存が必要になる。
派生データキャッシュ（DDC）は再現可能な派生成果物を保存し、繰り返し作業を減らせますが、真の情報源ではありません。ローカルコールド、ローカルウォーム、共有キャッシュビルドを比較し、ヒット挙動、ワーカー同時実行数、ネットワークスループット、エンジンまたはソース変更後の無効化を記録します。DDCのクリアは、証拠を保存した後の診断実験としてのみ実施してください。
シェーダーパーミュテーションと派生データの診断チェックリスト
- 「シェーダーパーミュテーションと派生データの診断」の判断を1文で示す。
- 最初に実行可能なビルドログ証拠がどのように所有され、バージョン管理され、検証されるかを記録します。
- 関連クエリ「unreal engine cooking failed」を同じ受け入れ基準でテストします。
- フレーム分位数、レーンミリ秒、ヒッチ、ピークメモリと常駐メモリ、ロード、帯域幅、リグレッション閾値を取得する。
- 可逆的な作業リビジョンを保持し、ロールバックを必要とする制限事項を書き込む。
4. アセットと依存関係ごとにクッキング失敗を診断する
クック失敗は通常、参照の欠落、リダイレクタ、未対応アセット形式、エディタ専用依存関係、シリアライズ変更、プラグインコンテンツルール、設定から除外されたマップ、またはターゲットプラットフォーム制限によって発生します。自動化で使用しているのと同じエンジンリビジョンで、最初のエラーに示されたアセットパスを使って参照を調査し、そのアセットを読み込んでください。
修復したアセットを最小構成のクックで確認し、その後フルプロジェクトで確認する。リダイレクトorを意図的に修正し、影響を受けたパッケージのみ再保存し、プラグイン記述子とランタイムモジュールを検証し、ソフト参照とアセットマネージャールールに必須コンテンツが含まれていることを確認する。エディターで読み込めることは、ターゲットクックに含まれていること、またはデシリアライズできることを示すものではない。
アセットと依存関係チェックリストでシェーダーコンパイル失敗を診断する
- 「アセットと依存関係を使ったクッキング失敗の診断」についての判断を1文で述べる。
- クリーンビルド時間の計測とキャッシュ境界がどのように所有され、バージョン管理され、検証されるかを記録する。
- 関連クエリ「unreal engine cooking failed」を同じ受け入れ基準でテストします。
- フレーム分位数、レーンミリ秒、ヒッチ、ピークメモリと常駐メモリ、ロード、帯域幅、リグレッション閾値を取得する。
- 可逆的な作業リビジョンを保持し、ロールバックを必要とする制限事項を書き込む。
5. 不具合を隠さずにビルド時間を短縮する
未使用のパーミュテーションを除去し、共有キャッシュアクセスを安定化させ、安全なワーカー並列性を増加させ、独立したターゲットを分割し、不要な完全無効化を避けることで時間を短縮する。各変更は同一のクリーンビルドとインクリメンタルビルドで比較する。リトライループで決定的な失敗を隠したり、ローカルの高速ウォームビルドをリリース改善とみなしたりしないこと。
シェーダーコンパイル時間、パッケージごとのクック時間、キャッシュ転送、CPU 使用率、ピークメモリ、ディスクスループット、成果物サイズ、最も長い直列セグメントを追跡する。再現性の高い最適化レポートでは、ソースリビジョン、ハードウェア、対象、キャッシュ状態、および複数回実行時のばらつきを記載し、別のビルダーでも結果を再現できるようにする。
不具合を隠さずにビルド時間を短縮するチェックリスト
- 「不具合を隠さずにビルド時間を短縮する」について、1文で意思決定を述べてください。
- シェーダーのパーミュテーションがどのように所有され、バージョン管理され、検証されているかを記録する。
- 関連クエリ「unreal engine cooking failed」を同じ受け入れ基準でテストします。
- フレーム分位数、レーンミリ秒、ヒッチ、ピークメモリと常駐メモリ、ロード、帯域幅、リグレッション閾値を取得する。
- 可逆的な作業リビジョンを保持し、ロールバックを必要とする制限事項を書き込む。
6. 自動化と別のマシンで再現する
自動化は、プロジェクト状態が移植可能かどうかを証明します。2台目のマシンまたはワーカーでクリーンチェックアウトから開始し、承認済みキャッシュのみを復元し、記録されたSDKとエンジンをインストールし、正確なコマンドを実行します。1つのワークステーションでのみ成功する場合は、環境変数、プラグイン、生成されたゲームファイル、権限、およびローカルで変更されたアセットを比較します。
ソース管理下の入力を Intermediate、Saved、DerivedDataCache、ステージング出力、生成バイナリとは分離して管理する。ビルド時間とキャッシュ診断を成果物として公開する。回帰確認には、以前失敗していたパッケージと起動時のスモークテストを含め、単にクック終了コードが成功というだけでは不十分。
自動化と別のマシンで再現するチェックリスト
- 「自動化と別のマシンで再現する」について1文で意思決定を述べてください。
- クックステージとターゲットプラットフォームコンテンツがどのように所有され、バージョン管理され、検証されるかを記録します。
- 関連クエリ「unreal engine cooking failed」を同じ受け入れ基準でテストします。
- フレーム分位数、レーンミリ秒、ヒッチ、ピークメモリと常駐メモリ、ロード、帯域幅、リグレッション閾値を取得する。
- 可逆的な作業リビジョンを保持し、ロールバックを必要とする制限事項を書き込む。
7. パッケージ受け入れとロールバックゲートを定義する
パッケージングゲートには、クリーンまたはポリシーで定義されたビルド、完全なログ、予算内のタイミング、成果物のハッシュとサイズ、インストールまたは解凍の成功、エディタ外での起動、必要なマップ読み込み、保存またはネットワークのスモークテスト、そして新規の高重要度警告がないことが必要です。例外には所有者、期限日、ロールバック判断が必要です。
最後に確認済みで正常な成果物とそのツールチェーンメタデータを保持する。変更がビルド時間のしきい値を超えた場合や起動テストに失敗した場合は、すべてのキャッシュを消去するのではなく、ソースまたはコンテンツのリビジョンを bisect して原因を特定する。最終的な証拠は、ターゲットプラットフォーム上で再現可能な成果物であり、たまたま動作するエディターセッションではない。
パッケージング受け入れおよびロールバックゲートチェックリストを定義
- 「パッケージング受け入れおよびロールバックゲート」を1文で定義してください。
- 最初に実行可能なビルドログ証拠がどのように所有され、バージョン管理され、検証されるかを記録します。
- 関連クエリ「unreal engine cooking failed」を同じ受け入れ基準でテストします。
- フレーム分位数、レーンミリ秒、ヒッチ、ピークメモリと常駐メモリ、ロード、帯域幅、リグレッション閾値を取得する。
- 可逆的な作業リビジョンを保持し、ロールバックを必要とする制限事項を書き込む。
SEELE AI Unreal 5ワークフロー：生成、プレビュー、最適化、パッケージ化、公開
SEELE AIは、シーンの方向性、プレイヤーループ、カメラフィール、コンテンツブリーフ、またはテスト計画を比較する必要がある場合、Unreal本番の前または並行して有効です。正規のUnrealランディングページを開き、実在するワークスペースカードを選択し、ソース属性を保持したままブラウザ生成ワークスペースへプロンプトを渡してください。
SEELE AIはネイティブUnreal 5ゲームを生成し、ブラウザ内でプレビューし、最適化およびパッケージ化し、外部での公開または有料Seeleゲーム用のダウンロード可能なゲームまたはパッケージ化済みビルドを提供できます。売上の保証はありません。
公式情報源と関連するUnrealガイド
このページは独立したワークフローガイドです。エンジンの挙動はリリース、プラグイン、プラットフォーム、プロジェクト設定によって変化するため、バージョン固有の詳細はEpicのドキュメントで確認し、意思決定に用いた証拠を保全してください。
Unreal EngineはEpic Gamesの商標です。SEELE AIは独立したものであり、このガイドはEpicの推奨を意味するものではありません。
- コンテンツクッキング — 製品範囲、ワークフロー、バージョン、またはポリシー確認には一次情報のみを使用し、ソースが実際に述べている主張のみを扱ってください。
- Unreal Engine におけるシェーダー開発（2026年7月レビュー） — 製品範囲、ワークフロー、バージョン、またはポリシー確認には一次情報のみを使用し、ソースが実際に述べている主張のみを扱ってください。
- Unreal Engine の Derived Data Cache（2026年7月レビュー） — 製品範囲、ワークフロー、バージョン、またはポリシー確認には一次情報のみを使用し、ソースが実際に述べている主張のみを扱ってください。
- コンテンツのテストと最適化 — 製品範囲、ワークフロー、バージョン、またはポリシー確認には一次情報のみを使用し、ソースが実際に述べている主張のみを扱ってください。
よくある質問
シェーダーコンパイルはクッキングと同じですか？
いいえ。シェーダーコンパイルはシェーダー置換を生成し、クッキングはコンテンツをターゲットプラットフォーム向けに変換してパッケージング前に準備します。
クック失敗はどこから始めるべきですか？
完全なログを保持し、最初に再現性のあるアセット、プラグイン、設定、またはツールチェーンのエラーを修正する。
最初に Derived Data Cache を削除すべきか？
まず行うのではない。キャッシュを削除する前に証拠を保存して再現しなければ、決定的なプロジェクト欠陥を隠してしまう可能性がある。
なぜクリーンビルドは時間がかかるのか？
クリーンビルドは、インクリメンタルビルドが再利用できる派生データとクック済み出力を再生成する。両者を別々に計測する。
不良アセット1つでクッキング全体を停止させることはあるか？
はい。未対応形式、破損参照、シリアライズエラー、プラットフォームルールはクックを停止させる可能性があります。
何が修正を証明するか？
クリーンな自動クックと、対象プラットフォームで起動可能なパッケージ成果物があって初めて、エディタの再起動以上の証明となります。
