Quick Start

Compatibility

Fully compatible with Unity 6. Tested on:
✅ Unity 6.4
✅ Unity 6.3
✅ Unity 6.2
✅ Unity 6.1
✅ Unity 6.0

✅ All platforms

✅ Input System (New)
✅ Input Manager (Old)

✅ Built-in
✅ URP
✅ HDRP

Setup

Prepare Your Loader Prefab

The loading screen is a self-contained prefab instantiated at runtime. The simplest workflow is to pass a direct prefab reference when triggering a load.

If you'd like to use a fixed loading screen without a reference, you can navigate to Evo Loader -> Resources -> EvoLoaderConfig and set a default loading screen prefab.

Add Your Scene to Build Profiles

Make sure the target scene is added to the Build Profile. Evo Loader uses Unity's SceneManager under the hood and will log an error if the scene cannot be found.

Triggering a Load

From Inspector

Add a Load Trigger component to any GameObject and configure your load parameters directly in the Inspector. No code required.

Add the Load Trigger component to a GameObject

Set the Listener Type to match how you want the load to be triggered

Fill in the Load Parameters section — target scene, loader prefab, load mode, and events

Hit Play — the load fires automatically based on the chosen listener

See the Load Trigger page for more details.

From Code

The simplest way to trigger a load is a single static call:

SimpleLoad.cs

using Evo.Loader;

// Load with a specific loader prefab assigned in the Inspector
LoadingScreen.LoadScene("GameScene", myLoaderPrefab);

// Load without a prefab reference
// Uses the default screen from the config asset (Evo Loader/Resources/EvoDefaultConfig.asset)
LoadingScreen.LoadScene("MainMenu");

// Load additively
LoadingScreen.LoadSceneAdditive("UIOverlay");

// Show a loading screen without loading any scene (for transitions or splash screens)
LoadingScreen.ShowTransition();

For more control, you can use LoadParameters:

ParameterLoad.cs

using UnityEngine;
using Evo.Loader;

public class MyLoader : MonoBehaviour
{
    public LoadingScreen loaderPrefab;

    public void GoToGameScene()
    {
        LoadParameters parameters = new()
        {
            targetScene = "GameScene",
            loadingScreen = loaderPrefab,
            loadMode = LoadMode.Single,
            useEmptySceneBuffer = true
        };

        parameters.onLoadStart.AddListener(() => Debug.Log("Load started!"));
        parameters.onLoadComplete.AddListener(() => Debug.Log("Load complete!"));

        LoadingScreen.LoadScene(parameters);
    }
}

See the Loading Screen page for more details.

Load Modes

Mode	Description
`Single`	Classic scene swap. The current scene is replaced by the target scene.
`Additive`	The target scene is loaded alongside the current scene.
`TransitionOnly`	Shows the loading screen without loading any scene. Useful for custom transitions or splash screens.

Compatibility

Setup

Prepare Your Loader Prefab

Add Your Scene to Build Profiles

Triggering a Load

From Inspector

From Code

Load Modes

Explore Further

Loading Screen

Load Trigger

Background Database

Hint Database

On this page