9. Money System

Bouw een economy systeem met MoneyManager autoload en UI display

Overzicht

In dit hoofdstuk leer je:

• MoneyManager.cs autoload singleton maken

• Signal-based architecture (MoneyChanged signal)

• TrySpend() pattern voor purchases

• AddMoney() voor income

• MoneyDisplay.cs Label component

• Signal subscriptions in UI

• Building costs via BasePlacer.BuildCost

Wat is een Economy System?

Een economy system geeft gameplay depth door resource management:

• Spelers besteden geld aan infrastructure (buildings, roads)

• Cars genereren geld door trips te voltooien (hoofdstuk 11)

• Balans: genoeg infrastructuur bouwen om trips mogelijk te maken, maar niet te veel uitgeven

Singleton pattern: Godot's AutoLoad system maakt MoneyManager globally toegankelijk via /root/MoneyManager. Elke script kan geld toevoegen/uitgeven zonder referenties door te geven.

MoneyManager script aanmaken

Maak een singleton die het geld beheert.

Nieuwe Godot-specifieke elementen:

• [Signal] - Attribuut om C# events als Godot signals te exposeren

  • [Signal] attribuut vertelt Godot: "dit is een signal"

  • delegate void NaamEventHandler(params) = C# event type

  • Convention: naam eindigt met EventHandler

  • Signal naam wordt automatisch MoneyChanged (zonder "EventHandler" suffix)

• delegate - C# event type definitie

• EmitSignal() - Fired een signal naar alle subscribers

1. Maak een nieuw script scripts/MoneyManager.cs

2. Maak de class aan die inherit van Node:

using Godot;
using System;

public partial class MoneyManager : Node
{
}

1. Voeg een export toe voor starting money:

public partial class MoneyManager : Node
{
    [Export] public int StartingMoney { get; set; } = 1000;
}

1. Voeg een property toe voor current money. Deze heeft een private setter (alleen MoneyManager kan het wijzigen):

    [Export] public int StartingMoney { get; set; } = 1000;

    public int CurrentMoney { get; private set; }
}

1. Definieer een signal voor money changes:

    public int CurrentMoney { get; private set; }

    [Signal]
    public delegate void MoneyChangedEventHandler(int newAmount);
}

1. Sla het script op

_Ready implementeren

Initialiseer het startbedrag en fire een initiële signal.

1. Voeg een lege _Ready() method toe:

    public delegate void MoneyChangedEventHandler(int newAmount);

    public override void _Ready()
    {
    }
}

1. Zet CurrentMoney op de starting value:

    public override void _Ready()
    {
        CurrentMoney = StartingMoney;
    }

1. Fire de MoneyChanged signal:

    public override void _Ready()
    {
        CurrentMoney = StartingMoney;
        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
    }

SignalName:

• SignalName.MoneyChanged = compile-time veilige signal naam

• Godot genereert dit automatisch van de delegate definitie

• Voorkomt typos ("MoneyChanged" vs "moneyChanged")

1. Sla het script op

CanAfford implementeren

Maak een helper method om te checken of de speler iets kan betalen. We gebruiken hiervoor een expression-body, gelijkaardig als je in Javascript of Typescript kan doen.

• Korte syntax voor simple returns

• => expression is hetzelfde als { return expression; }

1. Voeg een CanAfford() method toe:

    }

    public bool CanAfford(int cost) => CurrentMoney >= cost;
}

1. Sla het script op

TrySpend implementeren

Maak een method om geld uit te geven met validation.

1. Voeg een lege TrySpend() method toe:

    public bool CanAfford(int cost) => CurrentMoney >= cost;

    public bool TrySpend(int amount)
    {
    }
}

1. Check of de speler het kan betalen:

    public bool TrySpend(int amount)
    {
        if (!CanAfford(amount))
        {
            return false;
        }
    }

1. Print een waarschuwing bij onvoldoende geld:

        if (!CanAfford(amount))
        {
            GD.Print($"Not enough money! Need {amount}, have {CurrentMoney}");
            return false;
        }

1. Trek het bedrag af:

            return false;
        }

        CurrentMoney -= amount;
    }

1. Fire het signal:

        CurrentMoney -= amount;
        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
    }

1. Debug print en return success:

        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
        GD.Print($"Spent {amount}. Remaining: {CurrentMoney}");
        return true;
    }

1. Sla het script op

AddMoney implementeren

Maak een method om geld toe te voegen (car revenue).

1. Voeg een lege AddMoney() method toe:

    }

    public void AddMoney(int amount)
    {
    }
}

1. Voeg het bedrag toe:

    public void AddMoney(int amount)
    {
        CurrentMoney += amount;
    }

1. Fire de signal:

    public void AddMoney(int amount)
    {
        CurrentMoney += amount;
        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
    }

1. Debug print:

        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
        GD.Print($"Earned {amount}. Total: {CurrentMoney}");
    }

1. Sla het script op

MoneyManager als AutoLoad toevoegen

Configureer MoneyManager als singleton.

1. Open Project → Project Settings

2. Ga naar de Globals tab

3. Klik op de AutoLoad sectie

4. In het Path veld:

   • Klik het folder icoontje

   • Navigeer naar scripts/MoneyManager.cs

   • Selecteer het script

5. Node Name: MoneyManager (moet exact zo heten!)

6. Klik Add

7. MoneyManager verschijnt nu in de AutoLoad lijst

8. Klik Close

Wat doet AutoLoad?

• Godot instantieert MoneyManager automatisch bij game start

• Toegankelijk via /root/MoneyManager vanuit elke script

• Blijft bestaan tussen scene changes

BasePlacer updaten met kosten

Voeg building costs toe aan de BasePlacer, zodat de RoadPlacer en BuildingPlacer dat ook automatisch bevatten.

1. Open scripts/BasePlacer.cs

2. Voeg een cost export toe bovenaan:

public abstract partial class BasePlacer : Node
{
    [Export] public int BuildingCost { get; set; } = 100;

BuildingPlacer Build() method updaten

Nu update je de Build() method, zodat je de buildingCost ook gebruikt.

1. Open scripts/BuildingPlacer.cs

2. Update de Build() method om geld te checken en uit te geven:

    public override void Build()
    {
        Vector3I? cell = Raycaster.GetCellUnderMouse();
        if (cell == null) return;
        
        int? orientation = FindAdjacentRoad(cell.Value);
        if (orientation == null) return;

        var moneyManager = GetNode<MoneyManager>("/root/MoneyManager");
        if (!moneyManager.TrySpend(BuildingCost))
            return;

        GridMap.SetCellItem(cell.Value, SelectedBuildingId);
    }

Flow:

1. Get cell under mouse

2. Get MoneyManager singleton

3. Try to spend money (returns false als onvoldoende)

4. Early return als niet genoeg geld

5. Place building alleen als payment succesvol

6. Sla het script op

RoadPlacer updaten met kosten

Voeg road costs toe aan de RoadPlacer.

1. Open scripts/RoadPlacer.cs

2. Voeg een cost export toe na de RoadNavigation export:

    [Export] public int RoadCost { get; set; } = 50;

    [ExportGroup("Tile IDs (for Auto-Tiling)")]

1. Update de Build() method:

    public override void Build()
    {
        Vector3I? cell = Raycaster.GetCellUnderMouse();
        if (cell == null) return;

        var moneyManager = GetNode<MoneyManager>("/root/MoneyManager");
        if (!moneyManager.TrySpend(RoadCost))
            return;

        GridMap.SetCellItem(cell.Value, StraightId);
        UpdateSurroundingTiles(cell.Value);
        RoadNavigation?.RegenerateNavigationMesh();
    }

1. Sla het script op

MoneyDisplay UI toevoegen

Voeg een label toe aan de Main scene voor de money display.

1. Open scenes/Main.tscn

2. Selecteer BuildingSelector in de Scene Tree (de Control node)

3. Voeg een Label node toe als child van BuildingSelector

4. Hernoem naar MoneyDisplay

5. Selecteer MoneyDisplay

6. In de Inspector → Script: attach scripts/MoneyDisplay.cs

7. In de Inspector → Label sectie:

   • Text: "1000$" (tijdelijke placeholder)

8. In de Inspector → Control → Layout sectie:

   • Layout Preset: kies Top Right (of custom positioneer rechtsboven)

9. In de Inspector → Label → Theme Overrides → Font Sizes:

   • Font Size: 32 (groot en zichtbaar)

10. In de Inspector → Label → Theme Overrides → Colors:

    • Font Color: geel of groen (opvallend contrast)

11. Sla de scene op (Ctrl+S)

MoneyDisplay script aanmaken

Maak een UI label die het geldbedrag toont.

1. Voeg een nieuw script toe aan de MoneyDisplay node

2. Maak de class aan die inherit van Label:

using Godot;

public partial class MoneyDisplay : Label
{
}

1. Voeg een field toe voor de MoneyManager reference:

public partial class MoneyDisplay : Label
{
    private MoneyManager _moneyManager;
}

1. Sla het script op

_Ready implementeren (MoneyDisplay)

Subscribe naar de MoneyChanged signal.

1. Voeg een lege _Ready() method toe:

    private MoneyManager _moneyManager;

    public override void _Ready()
    {
    }
}

1. Haal de MoneyManager singleton op:

    public override void _Ready()
    {
        _moneyManager = GetNode<MoneyManager>("/root/MoneyManager");
    }

1. Subscribe naar de MoneyChanged signal:

    public override void _Ready()
    {
        _moneyManager = GetNode<MoneyManager>("/root/MoneyManager");
        _moneyManager.MoneyChanged += OnMoneyChanged;
    }

Signal subscription:

• C# events gebruiken += operator

• OnMoneyChanged = callback method (maken we hierna)

• Automatically aangeroepen wanneer signal fired

1. Zet de initiële value:

        _moneyManager.MoneyChanged += OnMoneyChanged;

        OnMoneyChanged(_moneyManager.CurrentMoney);
    }

Waarom manually aanroepen?

• Signal fired alleen bij changes

• We willen de initial value ook tonen

• Roep OnMoneyChanged handmatig aan met StartingMoney

1. Sla het script op

OnMoneyChanged implementeren

Maak een callback die de label text update.

1. Voeg een lege OnMoneyChanged() method toe:

    }

    private void OnMoneyChanged(int newAmount)
    {
    }
}

1. Update de label text:

    private void OnMoneyChanged(int newAmount)
    {
        Text = $"€{newAmount}";
    }

Label.Text:

• Property die de displayed text bepaalt

• String interpolation: $"€{newAmount}" = "€1000"

1. Sla het script op

Testen

Test het money systeem.

1. Start het spel (F5)

2. Check of de MoneyDisplay "€1000" toont (starting money)

3. Plaats een building:

   • Money moet decrease met 100

   • Display moet updaten naar "€900"

   • Console moet "Spent 100. Remaining: 900" printen

4. Plaats enkele roads:

   • Elke road kost 50

   • Display moet updaten

5. Test edge case - probeer te bouwen zonder geld:

   • Spend all money door buildings/roads te plaatsen

   • Probeer nog een building te plaatsen

   • Console: "Not enough money!" bericht

   • Display verandert niet (geen purchase)

6. Werkt alles? Sluit het spel (F8)

Veelgemaakte fouten

• MoneyManager niet gevonden: AutoLoad is niet correct ingesteld. Check Project Settings → Globals → AutoLoad en verify dat MoneyManager daar staat met exact die naam.

• MoneyDisplay toont niks: Script is niet attached OF Label.Text wordt niet geset. Check Inspector script attachment en debug print in OnMoneyChanged.

• Signal fired maar callback niet aangeroepen: Event handler syntax verkeerd (= ipv +=) OF method signature komt niet overeen (moet void MethodName(int) zijn).

• Money display niet readable: Font size te klein OF kleur contrast te laag. Maak groter (32+) en gebruik bright color (geel/groen/wit).

• BuildingPlacer/RoadPlacer cost werkt niet: Check of de TrySpend() call VOOR SetCellItem() staat. Early return moet gebeuren als niet genoeg geld.

Volledige scripts

Klik hier voor het volledige MoneyManager.cs script

using Godot;
using System;

public partial class MoneyManager : Node
{
    [Export] public int StartingMoney { get; set; } = 1000;

    public int CurrentMoney { get; private set; }

    [Signal]
    public delegate void MoneyChangedEventHandler(int newAmount);

    public override void _Ready()
    {
        CurrentMoney = StartingMoney;
        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
    }

    public bool CanAfford(int cost) => CurrentMoney >= cost;

    public bool TrySpend(int amount)
    {
        if (!CanAfford(amount))
        {
            GD.Print($"Not enough money! Need {amount}, have {CurrentMoney}");
            return false;
        }

        CurrentMoney -= amount;
        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
        GD.Print($"Spent {amount}. Remaining: {CurrentMoney}");
        return true;
    }

    public void AddMoney(int amount)
    {
        CurrentMoney += amount;
        EmitSignal(SignalName.MoneyChanged, CurrentMoney);
        GD.Print($"Earned {amount}. Total: {CurrentMoney}");
    }
}

Klik hier voor het volledige MoneyDisplay.cs script

using Godot;

public partial class MoneyDisplay : Label
{
    private MoneyManager _moneyManager;

    public override void _Ready()
    {
        _moneyManager = GetNode<MoneyManager>("/root/MoneyManager");
        _moneyManager.MoneyChanged += OnMoneyChanged;

        OnMoneyChanged(_moneyManager.CurrentMoney);
    }

    private void OnMoneyChanged(int newAmount)
    {
        Text = $"{newAmount}$";
    }
}