![Package Icon](/addons/maaacks_scene_loader/media/scene_loader-icon-black-transparent-256x256.png)  

# Godot Scene Loader
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/Maaack/Godot-Scene-Loader)
![GitHub Release Date](https://img.shields.io/github/release-date/Maaack/Godot-Scene-Loader)
[![Discord members](https://img.shields.io/discord/772191827570720798.svg?label=&logo=discord&logoColor=ffffff)](https://discord.gg/AyZrJh5AMp)  

A scene loader with loading screen, progress bar, and error handling.

For *Godot 4.7* (4.3+ compatible)

[Example on itch.io](https://maaack.itch.io/godot-game-template) of *[Maaack's Game Template](https://github.com/Maaack/Godot-Game-Template)*, which includes additional features.

## Objective

For quickly adding a loading screen with a progress bar in-between your scene changes.

### Extras or Components

Users that want additional features can try *[Maaack's Game Template](https://github.com/Maaack/Godot-Game-Template)* or other options from the [plugin suite](/addons/maaacks_scene_loader/docs/PluginSuite.md).  

## Installation

*Maaack's Scene Loader* is available in both the *Godot Asset Library* and the *Godot Asset Store*. It is available as a plugin, meaning it can be added to an existing project. 

### Existing Project
While editing a project in *Godot*:

1.  Go to the **Asset Store** tab.
2.  Search for "Maaack's Scene Loader".
3.  Click on the result to open the plugin details.
4.  Click to **Download**.
5.  Check that contents are getting installed to `addons/` and there are no conflicts.
6.  Click to **Install**.
7.  Reload the project (you may see errors before you do this).
8.  Enable the plugin from the **Project > Project Settings > Plugins** tab.

## Usage

Change scenes in your project using paths by calling `SceneLoader.load_scene(_path_to_scene_)`.

### More Documentation

[Loading Scenes](/addons/maaacks_scene_loader/docs/LoadingScenes.md)  
[Automatic Updating](/addons/maaacks_scene_loader/docs/AutomaticUpdating.md)  

## Media

### Screenshots

![Loading 33%](/addons/maaacks_scene_loader/media/screenshot-6-loading-screen-1.png)  
![Still Loading 69%](/addons/maaacks_scene_loader/media/screenshot-6-loading-screen-3.png)  
![Stalled Loaded 69%](/addons/maaacks_scene_loader/media/screenshot-6-loading-screen-4.png)  
[More Screenshots](/addons/maaacks_scene_loader/docs/Screenshots.md)  

## Featured Games

| HeartFix Express | Baking Godium | Rent Seek Kill |  
| :-------:| :-------: | :-------: |
| ![HeartFix Express](/addons/maaacks_scene_loader/media/thumbnail-game-heartfix-express.png) | ![Baking Godium](/addons/maaacks_scene_loader/media/thumbnail-game-baking-godium.png) | ![Rent-Seek-Kill](/addons/maaacks_scene_loader/media/thumbnail-game-rent-seek-kill.png) |
|  [Find on Steam](https://store.steampowered.com/app/3983290/HeartFix_Express_Demo/)  | [Play on itch.io](https://maaack.itch.io/baking-godium) | [Play on itch.io](https://xandruher.itch.io/rent-seek-kill)  |

[All Shared Games](/addons/maaacks_scene_loader/docs/GamesMade.md)  

## Community

Join the [Discord server](https://discord.gg/AyZrJh5AMp) and share your work with others. It's also a space for getting or giving feedback, and asking for help. 

## Links
[Attribution](/addons/maaacks_scene_loader/ATTRIBUTION.md)  
[License](/addons/maaacks_scene_loader/LICENSE.txt)  
[Godot Asset Store](https://store.godotengine.org/asset/maaack/maaacks-scene-loader/)  
[Godot Asset Library](https://godotengine.org/asset-library/asset/2896)