Legacy Documentation: Version 5.4
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Obsolete
Use SceneManager.LoadScene

Application.LoadLevelAdditive

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public static function LoadLevelAdditive(index: int): void;
public static void LoadLevelAdditive(int index);
public static function LoadLevelAdditive(name: string): void;
public static void LoadLevelAdditive(string name);

Parameters

Description

Loads a level additively.

Unlike LoadLevel, LoadLevelAdditive does not destroy objects in the current level. Objects from the new level are added to the current scene. This is useful for creating continuous virtual worlds, where more content is loaded in as you walk through the environment.

	// Loads the level with index 1
	Application.LoadLevel (1);

// Add items from the level named "MoreStuff". Application.LoadLevelAdditive ("MoreStuff");
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { void Example() { Application.LoadLevel(1); Application.LoadLevelAdditive("MoreStuff"); } }

LoadLevelAdditive adds new objects in the beginning of the next frame at the Inititialization stage prior to the first FixedUpdate call (see Execution Order of Event Functions).

See Also: AsyncOperation, Application.backgroundLoadingPriority, Application.LoadLevelAdditiveAsync, Application.LoadLevel, Application.LoadLevelAsync.