SceneManagement

A dependency-aware scene loading system that wraps Unity's SceneManager with graph-based scene dependencies.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      SceneManager                           │
│  (Static API for loading, unloading, and querying scenes)   │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                       SceneGraph                            │
│         (ScriptableObject storing all SceneNodes)           │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                       SceneNode                             │
│     (Holds a Scene reference and its dependencies)          │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                         Scene                               │
│   (Serializable wrapper around UnityEngine.SceneAsset)      │
└─────────────────────────────────────────────────────────────┘

Key Features

Dependency Chain Resolution — Automatically loads prerequisite scenes before the target scene.
Async Loading — Supports Task-based asynchronous scene loading and unloading.
Implicit Conversions — Seamlessly convert between Scene, string, and Unity's native Scene struct.
Event-Driven — SceneLoaded and SceneUnloaded events notify listeners of scene transitions.

Quick Start

using Paragon.Core.SceneManagement;

// Load a scene by name (with dependencies)
SceneManager.LoadScene("Gameplay");

// Load asynchronously
await SceneManager.LoadSceneAsync("Gameplay");

// Check if a scene is loaded
bool loaded = SceneManager.IsSceneLoaded("Gameplay");

// Subscribe to scene events
SceneManager.SceneLoaded += scene => Debug.Log($"Loaded: {scene.Name}");