Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

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

Application.LoadLevel

static function LoadLevel(index: int): void;
static void LoadLevel(int index);
static def LoadLevel(index as int) as void
static function LoadLevel(name: string): void;
static void LoadLevel(string name);
static def LoadLevel(name as string) as void

Parameters

indexThe level to load.
nameThe name of the level to load.

Description

Loads the level by its name or index.

Before you can load a level you have to add it to the list of levels used in the game. Use File->Build Settings... in Unity and add the levels you need to the level list there. MonoBehaviour.OnLevelWasLoaded is called on all active game objects after the level has been loaded.

	// Load the level named "HighScore".

Application.LoadLevel ("HighScore");

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void Example() {
        Application.LoadLevel("HighScore");
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def Example() as void:
		Application.LoadLevel('HighScore')

When loading a new level all game objects that have been loaded before are destroyed. If you want to let an object survive when loading a new level, use Object.DontDestroyOnLoad. Calling LoadLevel will update Application.loadedLevel and Application.loadedLevelName.

See Also: Application.LoadLevelAsync, Application.LoadLevelAdditive, Application.LoadLevelAdditiveAsync.