Skip to content

Scene Reference

Actions/conditions to change the current scene (or pause it and launch another one, or go back to the previous one), check if a scene or the game has just started/resumed, preload assets of a scene, get the current scene name or loading progress, quit the game, set background color, or disable input when focus is lost.

Actions

Stop and go back to previous scene
Stop this scene and go back to the previous paused one.
To pause a scene, use the "Pause and start a new scene" action.

See parameters & details

There are no parameters to set for this action.

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is PopScene.

Preload scene
Preload a scene resources as soon as possible in background.

See parameters & details
  • Parameter 1 (🔤 Name of a scene (String)): Name of the new scene

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is PrioritizeLoadingOfScene.

Pause and start a new scene
Pause this scene and start the specified one.
Later, you can use the "Stop and go back to previous scene" action to go back to this scene.

See parameters & details
  • Parameter 1 (🔤 Name of a scene (String)): Name of the new scene

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is PushScene.

Quit the game
Quit the game

See parameters & details

There are no parameters to set for this action.

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is Quit.

Change the scene
Stop this scene and start the specified one instead.

See parameters & details
  • Parameter 1 (🔤 Name of a scene (String)): Name of the new scene
  • Parameter 2 (❓ Yes or No): Stop any other paused scenes?

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is Scene.

Background color
Change the background color of the scene.

See parameters & details
  • Parameter 1: color

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this action internal type (in GDevelop JSON) is SceneBackground.

Conditions

Scene preloaded
Check if scene resources have finished to load in background.

See parameters & details
  • Parameter 1: 🔤 Name of a scene (String)

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is AreSceneAssetsLoaded.

At the beginning of the scene
Is true only when scene just begins.

See parameters & details

There are no parameters to set for this condition.

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DepartScene.

Does scene exist
Check if a scene exists.

See parameters & details
  • Parameter 1 (🔤 Name of a scene (String)): Name of the scene to check

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is DoesSceneExist.

Game has just resumed
Check if the game has just resumed from being hidden. It happens when the game tab is selected, a minimized window is restored or the application is put back on front.

See parameters & details

There are no parameters to set for this condition.

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is HasGameJustResumed.

Scene just resumed
The scene has just resumed after being paused.

See parameters & details

There are no parameters to set for this condition.

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is SceneJustResumed.

Scene loading progress
Compare The progress of resources loading in background for a scene (between 0 and 1)..

See parameters & details
  • Parameter 1: 🔤 Name of a scene (String)
  • Parameter 2: 🟰 Relational operator
  • Parameter 3 (🔢 Number): Value to compare

Technical note: parameter 0 is an internal parameter handled by GDevelop.

Technical note: this condition internal type (in GDevelop JSON) is SceneLoadingProgress.

Expressions

Expression Description
CurrentSceneName() Name of the current scene
SceneLoadingProgress(scene name) Return The progress of resources loading in background for a scene (between 0 and 1)..
🔤 Name of a scene (String) Scene name

The Scene extension is always installed in all GDevelop projects: there is no need to add it from the Project Manager.

This page is an auto-generated reference page about the Scene feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.