SceneGraphBuildProcessor

Internal build processor that injects the SceneGraph asset into builds as a preloaded asset, then restores the original preloaded assets list after the build completes.

Definition

Namespace: Paragon.Core.SceneManagement.Editor Assembly: Paragon.Editor.dll

internal class SceneGraphBuildProcessor : IPreprocessBuildWithReport, IPostprocessBuildWithReport

Implements: IPreprocessBuildWithReport, IPostprocessBuildWithReport

Remarks

The SceneGraph is normally stored in ProjectSettings/SceneGraph.asset (outside the Assets/ folder), which means it isn't included in builds by default. This processor handles the injection:

1. Pre-build — Copies ProjectSettings/SceneGraph.asset to Assets/Build/Resources/SceneGraph.asset, imports it, and adds it to PlayerSettings.GetPreloadedAssets()

2. Post-build — Restores the original preloaded assets list (removing the temporarily added entry)

The callback order is 1, ensuring it runs early in the build pipeline.

Properties

callbackOrder

int IOrderedCallback.callbackOrder => 1;

Build callback execution order. Runs early (1) to ensure the SceneGraph is available for other processors.

Methods

OnPreprocessBuild

Copies the SceneGraph from ProjectSettings/ into Assets/Build/Resources/, imports it, and adds it to the preloaded assets.

void IPreprocessBuildWithReport.OnPreprocessBuild(BuildReport report)

Build failure on error: If the SceneGraph cannot be loaded or is already in the preloaded assets list, the build fails with a BuildFailedException.

OnPostprocessBuild

Restores the original preloaded assets list, removing the temporarily injected SceneGraph.

void IPostprocessBuildWithReport.OnPostprocessBuild(BuildReport report)

Common Pitfalls

Do NOT manually add SceneGraph to Preloaded Assets The build processor handles this automatically. If the SceneGraph is already in the preloaded assets list, the build will fail with an ArgumentException.

Assets/Build/Resources/ is created during build The processor creates Assets/Build/Resources/ if it doesn't exist. This folder is a temporary build artifact.

See Also

• EditorSceneManager — Manages the SceneGraph asset at ProjectSettings/SceneGraph.asset

• SceneGraphEditor — Editor that triggers save operations on the graph