> For the complete documentation index, see [llms.txt](https://lionstudios.gitbook.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lionstudios.gitbook.io/readme/features/loading-scene.md).

# Splash Scene

The Lion Splash Scene is an optional feature that you can place before your loading or main game scene to initialize SDKs and load dynamic data safely. It keeps startup logic separate and reduces race conditions by ensuring services are ready before gameplay begins. It also handles displaying studio logos during startup.

{% hint style="warning" %}
This feature always loads the next scene in your Build Settings scene list. If you need to branch to different scenes (for example, based on player state or remote config), implement that logic in the next scene after the splash flow.
{% endhint %}

### Setup

The Splash Scene is automatically added to your Build Settings at index 0.

{% hint style="warning" %}
Remove any hard-coded calls to SceneManager.LoadScene(0) to avoid accidentally loading the splash scene.
{% endhint %}

Unity’s default splash screen will be disabled automatically (if your Unity license/version allows it). Make sure your project is on a plan/version that supports disabling the Unity splash screen (for example, Unity Pro/Enterprise or Unity 6+).

#### Wizard

You can configure everything automatically using the [Setup Wizard](/readme/getting-started.md).

#### Manual

You can also run setup manually from the Splash Scene settings window.

The Setup button is only enabled when changes are needed:

* The Splash Scene is not at index 0 in Build Settings, or
* Unity’s default splash screen is currently enabled.

### Settings

<figure><img src="/files/vApuPE5foOemgp0SPVmG" alt=""><figcaption></figcaption></figure>

**Use Async Loading**

* Loads SDK initialization and dynamic data asynchronously. This can improve load time for some games, so test on device to see what performs best.

**Enable Logos**

* Enable this to see more logo options

**Show Studio Logo**

* Includes your studio logo in the splash sequence. Recommended size: 512x512

**Show Lion Logo**

* Includes the Lion Studios logo in the splash sequence. Only enable this after explicit approval from your Lion Studios representative&#x20;

**Lion+ Variant**

* Includes the Lion Studios Plus variant logo in the splash sequence. Only enable this after explicit approval from your Lion Studios representative&#x20;

{% hint style="info" %}
Contact your Lion Studios representative before enabling the Lion Studios logo.
{% endhint %}

#### Manually Setup Loading Scene

<figure><img src="/files/QKb0Hx2P3mlqGQo7PvIv" alt="" width="563"><figcaption></figcaption></figure>

* This button will handle splash screen setup for you. It will add the AnimatedLionLogoScene.unity to your 0th index in the build scene list
* Clicking this button will overwrite any existing AnimatedLionLogoScene.unity you may have had setup previously.&#x20;

<figure><img src="/files/JFYvmj6AIHxQwgsOYbbh" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="danger" %}
NOTE: When upgrading to Lion SDK 2.0, you must complete this "Manual Setup Loading Scene" process in order for the Splash scene to work properly
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://lionstudios.gitbook.io/readme/features/loading-scene.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.