SceneManager

A static service that provides scene loading, unloading, and query operations with automatic dependency resolution.

Definition

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

public class SceneManager

Events

SceneLoaded

Raised when a scene finishes loading.

public static event Action<Scene> SceneLoaded;

SceneUnloaded

Raised when a scene is unloaded.

public static event Action<Scene> SceneUnloaded;

Methods

LoadScene()

Loads a scene synchronously with optional dependency loading.

public static void LoadScene(
    Scene scene, 
    bool loadDependencies = true, 
    LoadSceneMode loadSceneMode = LoadSceneMode.SINGLE);

Parameter	Type	Description
scene	Scene	The scene to load
loadDependencies	bool	Whether to load dependencies first
loadSceneMode	LoadSceneMode	Single or additive loading

LoadSceneAsync()

Loads a scene asynchronously with optional dependency loading.

public static async Task LoadSceneAsync(
    Scene scene, 
    bool loadDependencies = true, 
    LoadSceneMode loadSceneMode = LoadSceneMode.SINGLE);

Parameter	Type	Description
scene	Scene	The scene to load
loadDependencies	bool	Whether to load dependencies first
loadSceneMode	LoadSceneMode	Single or additive loading

Returns: Task — Completes when all scenes finish loading

UnloadScene()

Unloads a scene asynchronously (fire-and-forget).

public static async void UnloadScene(Scene scene, bool unloadDependencies = false);

Parameter	Type	Description
scene	Scene	The scene to unload
unloadDependencies	bool	Whether to unload dependencies

UnloadSceneAsync()

Unloads a scene asynchronously with await support.

public static async Task UnloadSceneAsync(Scene scene, bool unloadDependencies = false);

Parameter	Type	Description
scene	Scene	The scene to unload
unloadDependencies	bool	Whether to unload dependencies

Returns: Task — Completes when unloading finishes

GetActiveScene()

Returns the currently active scene.

public static Scene GetActiveScene();

Returns: Scene — The active scene

SetActiveScene()

Sets the active scene.

public static void SetActiveScene(Scene scene);

Parameter	Type	Description
scene	Scene	The scene to activate

GetLoadedScenes()

Returns all currently loaded scenes.

public static IEnumerable<Scene> GetLoadedScenes();

Returns: IEnumerable<Scene> — Loaded scenes from the graph

IsSceneLoaded()

Checks if a scene is currently loaded.

public static bool IsSceneLoaded(Scene scene);

Parameter	Type	Description
scene	Scene	The scene to check

Returns: bool — true if loaded

TryGetScene()

Attempts to find a scene by name or path.

public static bool TryGetScene(string sceneNameOrPath, out Scene scene);

Parameter	Type	Description
sceneNameOrPath	string	Scene name or full path
scene	out Scene	The found scene

Returns: bool — true if found

GetScene()

Returns a scene by name or path.

public static Scene GetScene(string sceneNameOrPath);
public static Scene GetScene(UnityScene unityScene);

Returns: Scene — The scene, or null if not found

GetUnityScene()

Converts a Scene to Unity's native scene struct.

public static UnityScene GetUnityScene(Scene scene);

Returns: UnityScene — The Unity scene struct

MoveGameObjectToScene()

Moves a GameObject to a specific scene.

public static void MoveGameObjectToScene(GameObject gameObject, Scene scene);

MoveGameObjectToActiveScene()

Moves a GameObject to the currently active scene.

public static void MoveGameObjectToActiveScene(GameObject gameObject);

Example

using Paragon.Core.SceneManagement;
using UnityEngine;

public class GameLoader : MonoBehaviour
{
    private async void Start()
    {
        // Subscribe to events
        SceneManager.SceneLoaded += OnSceneLoaded;
        
        // Load with dependencies
        await SceneManager.LoadSceneAsync("MainMenu");
    }
    
    private void OnSceneLoaded(Scene scene)
    {
        Debug.Log($"Scene loaded: {scene.Name}");
    }
}

See Also

• Scene

• SceneGraph

• LoadSceneMode