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.