Enum SceneLoadState

Describes the lifecycle state of a managed scene load or unload operation performed by ScyllaSceneManager and exposed on State.

Namespace: Scylla.Core.Scenes
Assembly: ScyllaCore.dll
Syntax
public enum SceneLoadState
Remarks

The state progresses monotonically through the loading pipeline. Operations that request manual activation hold in WaitingForActivation (Unity reports progress 0.9 at that point) until the activation gate is opened, then pass through Activating to a terminal state. Unloads skip the activation phase entirely and move straight from Loading to Completed.

Completed and Failed are terminal; an operation never leaves either state once reached, and never reports any other value afterward regardless of further per-frame ticking.

Fields

Name Description
Activating

The activation gate is open and Unity (or, under Addressables, SceneInstance.ActivateAsync) is activating the scene objects. Once entered, the operation never reports back to WaitingForActivation, even if AllowActivation is set back to false, because activation is irreversible.
Completed

The operation finished successfully. Progress is 1.0 and, for load operations, Scene holds the resulting scene handle. Terminal state.
Failed

The operation failed; a description of the failure is available on Error. Terminal state.
Loading

The scene data is actively being loaded; Progress advances from 0 toward the 0.9 activation-gate threshold. For unload operations this state also covers the whole unload, since unloads have no activation phase and Progress advances directly to 1.
NotStarted

The operation handle has been created but the underlying Unity AsyncOperation (or, under Addressables, the load handle) has not yet been attached and started. This is the state set by the SceneLoadOperation constructor before ScyllaSceneManager begins the asynchronous load pipeline.
WaitingForActivation

The scene data is fully loaded and the operation is holding at the activation gate, with Progress pinned at 0.9, waiting for the caller to open AllowActivation and for any configured minimum duration to elapse. Never reached by unload operations.
See Also