---
generated_by: gdlink-build
generated_at: 2026-06-23T12:34:28Z
do_not_edit: true
title: Scene
brick_type: executor
tier: Basic
generated: true
---

# Scene

**Category:** Executor
**Tier:** Basic

## Purpose

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

## Visual Reference

```{raw} html
<div class="illustration-container"><div class="illustration-box"><div class="box-header">As added to your scene</div><img src="https://gdlink.solventech.ca/guide/assets/images/bricks/scene_executor.png" alt="Scene brick as it appears in the GDLink editor" loading="lazy" style="max-width:100%;height:auto;display:block;margin:0 auto;border-radius:8px;" /></div></div>
```

## 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

```{raw} html
<div class="illustration-container">
        <div class="illustration-box">
            <div class="box-header">Generated UI Mockup — showing expanded properties</div>
            <div class="real-node brick-executor">
                <div class="real-header">
                    <div class="real-title"><span class="brick-icon-fallback"></span> <span>Scene</span></div>
                    <div class="real-controls"><div class="real-checkbox"></div><div class="real-btn">-</div><div class="real-btn">x</div></div>
                </div>
                <div class="real-inner-panel"><div class="real-row name-row" style="position:relative;"><span class="real-label">Name:</span><div class="real-input" style="color:#666; font-style:italic;">Label this brick...</div><div class="real-port" style="left:-15px;"></div></div><div class="real-row"><span class="real-label">Mode:</span><div class="real-input-dropdown">Load Scene</div></div><div class="real-row"><span class="real-label" style="width: auto; padding-right:8px;">Scene Path:</span><div class="real-input" style="justify-content:space-between; padding:4px 8px;"><span></span><div class="real-input-dropdown-btn" style="padding:2px 6px;">v</div></div></div><div class="real-inline-row" style="margin-top:4px;"><div class="real-inline-btn" style="background:#2f343d;">Verbose</div></div></div>
            </div>
        </div>
    </div>
```

## 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)
```