Application.LoadLevelAdditive

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.