Scene

Category: Executor Tier: Basic

Purpose

Controls scene loading, transitions, and game flow including level changes, menu navigation, and scene overlays.

Visual Reference

As added to your scene
Scene brick as it appears in the GDLink editor

When To Use

  • Level transitions (complete level -> load next)

  • Menu navigation (main menu -> settings -> game)

  • UI button navigation (Control host + UI Click listener)

  • Game over / restart (reload current scene)

  • Pause menus (add overlay scene)

  • Victory screens (load ending scene)

  • Quit buttons (exit game)

  • Loading screens (scene transitions)

Runtime Behavior

Executes: When activated, performs scene management operations

Generated UI Mockup — showing expanded properties
Scene
-
x
Name:
Label this brick...
Mode:
Load Scene
Scene Path:
v
Verbose

Properties

Property

Type

Default

Notes

Mode

option

Load Scene

Scene operation to perform

Scene Path

string

Path to scene file (e.g. res://scenes/level2.tscn).

Verbose

bool

False

Log scene operation to console for debugging

Example Use Cases

Load Next Level:

Collision(LevelExit) -> AND -> Scene(mode=Load Scene, path="res://levels/level2.tscn", transition=Fade)
// Change to next level with fade transition

Restart on Death:

Property(HP, Less or Equal, 0) -> AND -> Scene(mode=Reload Current, transition=Fade, duration=1.0)
// Reload current level when player dies

Pause Menu:

Keyboard(Escape) -> AND -> Scene(mode=Add Scene, path="res://ui/pause_menu.tscn")
// Add pause menu as overlay

Quit Game:

Keyboard(Q) -> AND -> Scene(mode=Quit Game)
// Exit application (in pause menu or game over screen)

Menu Navigation:

// Main menu buttons on Control hosts
UI Click(Left, Pressed) -> AND -> Scene(mode=Load Scene, path="res://scenes/game.tscn")
UI Click(Left, Pressed) -> AND -> Scene(mode=Load Scene, path="res://scenes/settings.tscn")
UI Click(Left, Pressed) -> AND -> Scene(mode=Quit Game)

Restart Button:

UI Click(Left, Pressed) -> AND -> Scene(mode=Reload Current)