# andresg309/scenemaster architecture

> Architecture diagram of the GitHub repository andresg309/scenemaster, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andresg309/scenemaster
- Repository: https://github.com/andresg309/scenemaster

## Overview

SceneMaster is a Unity runtime package for orchestrating scene changes through a fluent request API, transition animations, optional asynchronous loading, callbacks, and loading-screen scenes. A game caller configures a request with SceneTransitionBuilder; SceneMaster validates and performs it, delegates visual phases to a TransitionEffect, and optionally configures a LoadingScreen. The graph includes the documented default transition and progress-screen capabilities; paths and edges are limited to the supplied tree, README, and excerpts.

Main entry points: [`Runtime/Scripts/SceneMaster.cs`](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/SceneMaster.cs) (Scene manager), [`Runtime/Scripts/SceneTransitionBuilder.cs`](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/SceneTransitionBuilder.cs) (Request builder), [`Runtime/Default Loading Screens/With Progress Bar/ScreenWithProgressBar.cs`](https://github.com/andresg309/scenemaster/blob/main/Runtime/Default%20Loading%20Screens/With%20Progress%20Bar/ScreenWithProgressBar.cs) (Progress screen), [`Runtime/Scripts/Classes/TransitionEffect.cs`](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/Classes/TransitionEffect.cs) (Transition effect API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Request API"]
  node_builder["Request builder"]
  node_request["Transition request"]
end

subgraph group_orchestration["Transition Runtime"]
  node_manager["Scene manager<br/>[SceneMaster.cs]"]
end

subgraph group_effects["Visual Effects"]
  node_effect_base["Transition effect API"]
  node_simple_effect["Simple animation"]
  node_sideways_effect["Sideways panels"]
  node_fade_effect["Fade transition"]
  node_circle_effect["Circle transition"]
end

subgraph group_loading["Loading Screens"]
  node_loading_api["Loading screen API<br/>[LoadingScreen.cs]"]
  node_progress_screen["Progress screen"]
  node_loading_scene["Loading screen scene"]
end

node_game(("Game code"))
node_unity_scenes["Unity scene system"]

node_game -->|"configures request"| node_builder
node_builder -->|"sets options"| node_request
node_builder -->|"executes request"| node_manager
node_manager -->|"reads options"| node_request
node_manager -->|"loads scenes"| node_unity_scenes
node_manager -->|"runs transition"| node_effect_base
node_simple_effect -->|"implements"| node_effect_base
node_sideways_effect -->|"implements"| node_effect_base
node_manager -->|"configures screen"| node_loading_api
node_progress_screen -->|"implements"| node_loading_api
node_manager -.->|"activates screen"| node_progress_screen
node_loading_scene -.->|"contains implementation"| node_progress_screen
node_manager -.->|"uses optional effect"| node_fade_effect
node_manager -.->|"uses optional effect"| node_circle_effect

click node_builder "https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/SceneTransitionBuilder.cs"
click node_request "https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/Classes/SceneTransitionRequest.cs"
click node_manager "https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/SceneMaster.cs"
click node_effect_base "https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/Classes/TransitionEffect.cs"
click node_simple_effect "https://github.com/andresg309/scenemaster/blob/main/Runtime/DefaultTransitions/(Template)%20SimpleTransition/SimpleTransition.cs"
click node_sideways_effect "https://github.com/andresg309/scenemaster/blob/main/Runtime/DefaultTransitions/CloseSideways/CloseSidewaysTransition.cs"
click node_fade_effect "https://github.com/andresg309/scenemaster/tree/main/Runtime/DefaultTransitions/Fade"
click node_circle_effect "https://github.com/andresg309/scenemaster/tree/main/Runtime/DefaultTransitions/CircleExpand"
click node_loading_api "https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/Classes/LoadingScreen.cs"
click node_progress_screen "https://github.com/andresg309/scenemaster/blob/main/Runtime/Default%20Loading%20Screens/With%20Progress%20Bar/ScreenWithProgressBar.cs"
click node_loading_scene "https://github.com/andresg309/scenemaster/blob/main/Runtime/Default%20Loading%20Screens/With%20Progress%20Bar/LoadingScreenWithProgressBar.unity"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_builder,node_request toneBlue
class node_manager toneAmber
class node_effect_base,node_simple_effect,node_sideways_effect,node_fade_effect,node_circle_effect toneMint
class node_loading_api,node_progress_screen,node_loading_scene toneRose
class node_game,node_unity_scenes toneIndigo
```

## Components

### Request API

- [Request builder](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/SceneTransitionBuilder.cs): `Runtime/Scripts/SceneTransitionBuilder.cs`
- [Transition request](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/Classes/SceneTransitionRequest.cs): `Runtime/Scripts/Classes/SceneTransitionRequest.cs`

### Transition Runtime

- [Scene manager](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/SceneMaster.cs): `Runtime/Scripts/SceneMaster.cs`

### Visual Effects

- [Transition effect API](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/Classes/TransitionEffect.cs): `Runtime/Scripts/Classes/TransitionEffect.cs`
- [Simple animation](https://github.com/andresg309/scenemaster/blob/main/Runtime/DefaultTransitions/(Template)%20SimpleTransition/SimpleTransition.cs): `Runtime/DefaultTransitions/(Template) SimpleTransition/SimpleTransition.cs`
- [Sideways panels](https://github.com/andresg309/scenemaster/blob/main/Runtime/DefaultTransitions/CloseSideways/CloseSidewaysTransition.cs): `Runtime/DefaultTransitions/CloseSideways/CloseSidewaysTransition.cs`
- [Fade transition](https://github.com/andresg309/scenemaster/tree/main/Runtime/DefaultTransitions/Fade): `Runtime/DefaultTransitions/Fade`
- [Circle transition](https://github.com/andresg309/scenemaster/tree/main/Runtime/DefaultTransitions/CircleExpand): `Runtime/DefaultTransitions/CircleExpand`

### Loading Screens

- [Loading screen API](https://github.com/andresg309/scenemaster/blob/main/Runtime/Scripts/Classes/LoadingScreen.cs): `Runtime/Scripts/Classes/LoadingScreen.cs`
- [Progress screen](https://github.com/andresg309/scenemaster/blob/main/Runtime/Default%20Loading%20Screens/With%20Progress%20Bar/ScreenWithProgressBar.cs): `Runtime/Default Loading Screens/With Progress Bar/ScreenWithProgressBar.cs`
- [Loading screen scene](https://github.com/andresg309/scenemaster/blob/main/Runtime/Default%20Loading%20Screens/With%20Progress%20Bar/LoadingScreenWithProgressBar.unity): `Runtime/Default Loading Screens/With Progress Bar/LoadingScreenWithProgressBar.unity`

### Other components

- **Game code**
- **Unity scene system**

## Connections

- Game code → Request builder: configures request (evidence: `README.md`)
- Request builder → Transition request: sets options (evidence: `Runtime/Scripts/SceneTransitionBuilder.cs`)
- Request builder → Scene manager: executes request (evidence: `Runtime/Scripts/SceneTransitionBuilder.cs`)
- Scene manager → Transition request: reads options (evidence: `Runtime/Scripts/SceneMaster.cs`)
- Scene manager → Unity scene system: loads scenes (evidence: `Runtime/Scripts/SceneMaster.cs`)
- Scene manager → Transition effect API: runs transition (evidence: `Runtime/Scripts/SceneMaster.cs`)
- Simple animation → Transition effect API: implements (evidence: `Runtime/DefaultTransitions/(Template) SimpleTransition/SimpleTransition.cs`)
- Sideways panels → Transition effect API: implements (evidence: `Runtime/DefaultTransitions/CloseSideways/CloseSidewaysTransition.cs`)
- Scene manager → Loading screen API: configures screen (evidence: `Runtime/Scripts/SceneMaster.cs`)
- Progress screen → Loading screen API: implements (evidence: `Runtime/Default Loading Screens/With Progress Bar/ScreenWithProgressBar.cs`)
- Scene manager → Progress screen: activates screen (evidence: `Runtime/Default Loading Screens/With Progress Bar/ScreenWithProgressBar.cs`)
- Loading screen scene → Progress screen: contains implementation
- Scene manager → Fade transition: uses optional effect
- Scene manager → Circle transition: uses optional effect
