scene-module

What problem does it solve?

Provides a consistent, async-first approach to loading and transitioning between Unity scenes, removing manual scene activation complexity, preventing concurrent load conflicts, and exposing progress for loading screens and UI feedback. It integrates scene operations with game state transitions so navigation (menu → loading → gameplay) is reliable and observable.

Core Features & Use Cases

• Asynchronous scene loading and unloading with manual activation control and progress reporting suitable for loading bars.
• Additive scene support for overlays such as HUDs and modular scene composition.
• Transition handling (Fade, Crossfade, Slide, Instant, Custom) with configurable durations and simple placeholders for animation hooks.
• Convenience navigation methods for common flows like going to main menu or gameplay, plus utilities to check whether a scene is loaded.
• Use Case: Replace ad-hoc SceneManager calls with this service to show a loading screen while a level loads, track progress to 90% before activation, and then perform a fade-in transition into gameplay.

Quick Start

Use the scene-module to load the gameplay scene with a fade transition and monitor LoadingProgress until it reaches completion.