scene-module

Load and transition Unity scenes asynchronously with progress reporting.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/punkfuncgames/tetris-clone --skill scene-module
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scene-module
Source: https://github.com/punkfuncgames/tetris-clone/tree/main/.claude/skills/scene-module
Command: npx skills add https://github.com/punkfuncgames/tetris-clone --skill scene-module

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about scene-module

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I load Unity scenes asynchronously with a progress bar?

Asynchronous scene loading in Unity with progress reporting is handled by tracking operation progress to 0.9 before manual activation. This approach exposes loading values suitable for UI bars while preventing concurrent load conflicts during level transitions.

Can I use UniTask for async scene management in Unity?

UniTask-based async methods are used for scene management to handle asynchronous loading and unloading operations. This integration supports manual activation control and prevents concurrent load conflicts during state-driven scene navigation.

What is the best way to handle additive scene overlays for Unity HUDs?

Additive scene support allows loading overlay scenes such as HUDs and modular level components without unloading the base scene. This enables modular scene composition while maintaining asynchronous loading and progress tracking.

How do transitions work when navigating between Unity menu and gameplay scenes?

Transitions during scene navigation use configurable effects like Fade, Crossfade, Slide, or Instant with set durations. They include simple placeholders for animation hooks and integrate with game state services to ensure reliable menu to gameplay flows.

Why does my Unity async scene loading stall at 90% progress?

Async scene loading progress tracks to 0.9 before manual activation is triggered. The operation intentionally holds at 90% until allowSceneActivation is called, ensuring the loading screen remains visible until the game state transition is fully ready.

How to prevent concurrent scene load conflicts in Unity game projects?

Preventing concurrent load conflicts is achieved by using a dedicated scene service that manages asynchronous operations and game state transitions. This centralized approach replaces ad-hoc SceneManager calls and ensures reliable, observable navigation.