Global variables (Autoload)

In de vorige les heb je var score = 0 in je karakter gezet en vanuit het muntje body.score += 1 aangeroepen. Dat werkt — totdat je de score op het scherm wilt tonen en je vanuit een Label-script via get_node("../CharacterBody2D").score moet gaan zoeken. Eén verschuiving in de Scene Tree en het breekt. In deze les leer je een schonere oplossing: global variables die overal in je project beschikbaar zijn.

Godot 4.7

Geschreven voor Godot 4.7.x — zie Godot-versies voor compatibiliteit.

Voorspel: een variabele die overal woont

Wat als de score op één vaste plek leefde, buiten alle nodes om, altijd bereikbaar met dezelfde naam? Hoe zou je dat technisch oplossen?

Antwoord

Je maakt een apart script (bijvoorbeeld global.gd) dat niet aan een node hangt. Daarna vertel je Godot via Autoload: "laad dit script automatisch bij het opstarten en houd het de hele speelsessie in de lucht". Vanaf dat moment kun je vanuit elk ander script Global.score schrijven of lezen — geen get_node(...) meer, geen kapotte links als je iets verplaatst.

Het probleem in één regel

Variabelen die je in een node-script zet, leven alleen zolang die node bestaat. Global lost dat op door buiten de Scene Tree te leven.

Stap 1: Maak een nieuw script

1. Ga naar FileSystem (linksonder).
2. Klik met rechts → New Script.
3. Noem het global.gd.
4. Zorg dat er geen node aan gekoppeld is — het is een los script.

Stap 2: Voeg je variabelen toe

extends Node

var score = 0
var levens = 3

Dat is alles. Dit script bevat variabelen die je overal wilt gebruiken.

Stap 3: Stel het in als Autoload

Dit is de belangrijkste stap. Door het script als Autoload te registreren, laadt Godot het automatisch bij het opstarten en is het overal beschikbaar.

1. Ga naar Project → Project Settings.
2. Klik bovenin op het tabblad Globals, en daarbinnen op Autoload. Het tabblad Globals staat naast General; is het venster smal, scroll dan even door de rij.
3. Klik op het mapje naast Path en kies global.gd.
4. Bij Node Name vul je Global in (met hoofdletter).
5. Klik op Add.

Global is nu overal beschikbaar in je project.

De Autoload-instelling staat ook in de Nodes cheatsheet.

Voorspel: wat als je deze stap vergeet?

Wat denk je dat er gebeurt als je Stap 3 overslaat en meteen Global.score += 1 in je muntje-script zet?

Antwoord

Je krijgt de melding Identifier "Global" not declared in the current scope, en niet pas als je een munt raakt. Godot controleert de namen in een script al bij het inlezen. De script-editor kleurt de regel meteen rood, en druk je toch op Play, dan stopt Godot bij het laden van het muntje-script, nog voordat het spel draait. Het script global.gd bestaat wel op schijf, maar Godot kent de naam Global pas nadat je hem in Autoload hebt geregistreerd. Een script zonder Autoload is als een boek in een gesloten kast: het bestaat, maar niemand kan erbij.

Stap 4: Refactor naar Global.score

In de vorige les hoogde je de score op via body.score += 1. Nu we een Global hebben, gebruiken we dat.

In je muntje-script:

extends Area2D

func _on_body_entered(body: Node2D) -> void:
    Global.score += 1
    print("Score: ", Global.score)
    queue_free()

In je karakter-script: verwijder de regel var score = 0. Die hebben we niet meer nodig — de score leeft voortaan in Global.

Overal dezelfde syntax: Global.variabelnaam. Geen get_node(...), geen kapotte links bij hernoemen.

Functies in je global script

Je kunt ook functies toevoegen aan je global script:

extends Node

var score = 0
var levens = 3

func reset():
    score = 0
    levens = 3

func verlies_leven():
    levens -= 1
    if levens <= 0:
        print("Game Over!")

Deze roep je op dezelfde manier aan:

Global.verlies_leven()
Global.reset()

Een functie die antwoord geeft

De functies hierboven doen iets: ze zetten waarden goed of printen iets. Daarom staat er -> void achter zodra je het type opschrijft. Dat pijltje betekent: deze functie geeft niets terug.

Vaak wil je een functie juist iets laten teruggeven, zodat je het antwoord kunt gebruiken. Zet daarnaast in je global script:

func is_game_over() -> bool:
    return levens <= 0

-> bool zegt: deze functie geeft een true of een false terug. Met return stuur je die waarde naar de plek waar de functie werd aangeroepen. Vanaf dan kun je hem gebruiken alsof je die vergelijking ter plekke had opgeschreven:

if Global.is_game_over():
    print("Je hebt geen levens meer")

Hier bouw je op verder: Return

Weet je dit niet meer zeker? Lees het terug voordat je verdergaat.

• Python Return

In Python levert een functie zonder return de waarde None op. GDScript noemt dat void. Het is precies hetzelfde idee, met een andere naam:

Wat je schrijft	Wat de functie teruggeeft	In Python
func reset() -> void:	niets	een functie zonder return
func is_game_over() -> bool:	true of false	return levens <= 0
func aantal_levens() -> int:	een heel getal	return levens

Waarom zou je is_game_over() maken in plaats van overal if Global.levens <= 0: te schrijven?

Antwoord

Omdat je dan één plek hebt waar staat wat "game over" betekent. Wil je later dat het spel al eindigt bij één leven over, of dat je ook game over bent als de tijd op is, dan pas je die ene functie aan in plaats van vijf verspreide if-regels.

De naam helpt bovendien mee: if Global.is_game_over(): lees je als een zin, if Global.levens <= 0: moet je ontcijferen.

tip

Gebruik global variables voor dingen die je in meerdere scènes nodig hebt: score, levens, instellingen. Gebruik gewone var voor dingen die alleen in één node leven.

In de volgende les zet je Global.score op het scherm met een Label.

Opdracht 7.3.a: voeg levens toe aan Global

Je hebt nu Global.score. Pas dezelfde aanpak toe op levens.

Voeg var levens = 3 toe aan global.gd en laat je vijand-script Global.levens -= 1 doen bij contact (in plaats van body.levens -= 1 uit de vorige les).

Klik hier voor een tip.

• Open global.gd en voeg var levens = 3 toe onder var score = 0.
• Open je vijand-script en vervang body.levens -= 1 door Global.levens -= 1.
• Print de huidige waarde met print("Levens: ", Global.levens).
• Verwijder ook var levens = 3 uit je karakter-script (zoals je dat met score deed).

Klik hier voor de oplossing.

In global.gd:

extends Node

var score = 0
var levens = 3

In je vijand-script:

extends Area2D

func _on_body_entered(body: Node2D) -> void:
    Global.levens -= 1
    print("Levens: ", Global.levens)
    queue_free()

Er gaat iets mis

Global werkt niet / Global.score geeft een fout

Oorzaak: Global is geen ingebouwd Godot-concept. Het is een script dat je zelf als Autoload moet registreren. Zonder die instelling kent Godot de naam Global niet.

Oplossing:

1. Ga naar Project → Project Settings → Globals → Autoload.
2. Klik op het mapje naast Path en kies global.gd.
3. Vul bij Node Name precies Global in (met hoofdletter G).
4. Klik op Add.

Mijn score-variabele reset bij elke nieuwe scène

Oorzaak: Je gebruikt een gewone var score = 0 in een node-script. Als die node verdwijnt (bij het laden van een nieuwe scène), verdwijnt ook de variabele.

Oplossing: Zet de variabele in global.gd in plaats van in het node-script. Dat script blijft de hele speelsessie bestaan.