Background Database

Overview

Background Database is a ScriptableObject that holds a list of sprites to cycle as the loading screen's background. Backgrounds fade (and optionally slide) in and out according to the backgroundAnimation settings on the LoadingScreen component.

Keeping backgrounds in a separate asset means you can swap artwork, create per-level variants, or share the same database across multiple loading screen prefabs without touching the prefab itself.

Creating a Database

Properties

Using Multiple Databases

You can assign different databases to different loading screen prefabs — for example, a boss encounter screen with thematic artwork versus a generic level transition. Because databases are ScriptableObjects, they can be shared, duplicated, and edited independently.

Code Example

using Evo.Loader;
using UnityEngine;

public class BackgroundDatabaseExample : MonoBehaviour
{
    public BackgroundDatabase backgrounds;

    void Start()
    {
        // Add a background at runtime.
        // To avoid modifying the source asset, work on a cloned instance.
        BackgroundDatabase runtimeDB = Instantiate(backgrounds);

        Sprite newBg = Resources.Load<Sprite>("Backgrounds/Forest");
        if (newBg != null)
        {
            runtimeDB.backgrounds.Add(newBg);
        }
    }
}