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

Technical note: parameter 0 are internal parameters handled by GDevelop.

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

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

Technical note: parameter 0 are internal parameters handled by GDevelop.

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
  • Parameter 1 (🔤 Name of a scene (String)): Name of the new scene

Technical note: parameter 0 are internal parameters handled by GDevelop.

Quit the game
Quit the game

See parameters

Technical note: parameter 0 are internal parameters handled by GDevelop.

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

See parameters
  • 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 are internal parameters handled by GDevelop.

Background color
Change the background color of the scene.

See parameters
  • Parameter 1: color

Technical note: parameter 0 are internal parameters handled by GDevelop.

Conditions

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

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

Technical note: parameter 0 are internal parameters handled by GDevelop.

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

See parameters

Technical note: parameter 0 are internal parameters handled by GDevelop.

Does scene exist
Check if a scene exists.

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

Technical note: parameter 0 are internal parameters handled by GDevelop.

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

Technical note: parameter 0 are internal parameters handled by GDevelop.

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

See parameters

Technical note: parameter 0 are internal parameters handled by GDevelop.

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

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

Technical note: parameter 0 are internal parameters handled by GDevelop.

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.