5. Breakable Blocks

Maak vernietigbare blokken met collision detection

Overzicht

In dit hoofdstuk maak je breakable blocks die de player kan vernietigen door er van onderaf tegenaan te springen (Mario-style). Je leert:

• StaticBody3D gebruiken voor breakable blocks

• Area3D positioneren voor bottom-detection

• Signals verbinden via de UI

• QueueFree() om nodes te verwijderen

Brick scene maken

Begin met een simpele brick-scene die later breakable wordt.

1. Ga naar Scene > New Scene

2. Selecteer Other Node en zoek naar StaticBody3D

3. Klik Create

4. Hernoem de root node naar Brick

5. Sla de scene op als res://objects/Brick.tscn

Waarom StaticBody3D? Dit is een physics body dat niet beweegt door gravity of forces, maar wel collideert met andere bodies - perfect voor platforms en breakable blocks.

Brick model toevoegen

Voeg nu het brick-model toe.

1. Open het FileSystem panel

2. Navigeer naar models/brick.glb

3. Sleep brick.glb naar de Brick root node in de Scene hierarchy

4. Het model wordt nu als child toegevoegd

Scene hierarchy:

Brick (StaticBody3D)
└── brick (imported scene from brick.glb)

CollisionShape3D Toevoegen

Elke physics body heeft een collision shape nodig.

1. Selecteer de Brick root node

2. Rechts-klik > Add Child Node > CollisionShape3D

3. In de Inspector van CollisionShape3D:

   • Shape > New BoxShape3D

4. Pas de BoxShape3D aan zodat deze het brick model bedekt

5. Sla de scene op

Scene hierarchy (updated):

Brick (StaticBody3D)
├── brick (imported scene)
└── CollisionShape3D (BoxShape3D)

Test de brick in de level

Voeg de brick toe aan de level om te testen.

1. Open scenes/main.tscn

2. Ga naar het File System venster, en sleep objects/brick.tscn in de scene

3. Positioneer de brick ergens in de level waar de player kan springen

4. Test met F5:

   • De player kan op de brick staan

   • De brick gedraagt zich als een normaal platform

Area3D voor Detectie

Maak de brick nu breakable door een Area3D toe te voegen die detecteert wanneer de player er van onderaf tegenaan springt (zoals in klassieke platformers).

1. Open objects/Brick.tscn

2. Selecteer de Brick root node

3. Rechts-klik > Add Child Node > Area3D

4. Hernoem de Area3D naar BreakDetector

5. Voeg een CollisionShape3D child toe aan BreakDetector

6. Geef de CollisionShape3D een BoxShape3D

7. Pas de BoxShape3D aan en positioneer aan de onderkant van de brick

8. Selecteer de BreakDetector node

9. In de Inspector, open de CollisionObject3D > Collision property

10. Zet Mask op 2 (en vink 1 uit)

11. Sla de scene op

Scene hierarchy (updated):

Brick (StaticBody3D)
├── brick (imported scene)
├── CollisionShape3D (BoxShape3D)
└── BreakDetector (Area3D)
    └── CollisionShape3D (BoxShape3D - plat, onderaan)

Brick script toevoegen

Maak nu een script voor de brick.

1. Open objects/brick.tscn

2. Selecteer de Brick root node

3. Klik op Attach Script

   • Language: C#

   • Template: Empty

   • Class Name: Brick

   • Path: res://scripts/Brick.cs

4. Klik Create

5. Godot maakt gebruik van een template script met een lege _Process en _Ready method. Deze methods hebben we voorlopig niet nodig, dus mag je ze verwijderen.

6. Voeg een lege Break() method toe:

using Godot;

public partial class Brick : StaticBody3D
{
    private void Break()
    {
        GD.Print("Brick broken!");
    }
}

BodyEntered Signal Verbinden

Verbind het BodyEntered-signaal van de BreakDetector aan je Break()-methode via de UI.

1. In objects/Brick.tscn, selecteer de BreakDetector (Area3D) node

2. Ga naar het Node tabblad in de Inspector (naast de Inspector tab)

3. Dubbelklik op het body_entered(body: Node3D) signal

4. In het "Connect a Signal" venster:

   • Receiver Method: Break (type dit in)

   • Zorg dat Brick geselecteerd is als receiver node

5. Klik Connect En pas de signature van Break() aan naar:

private void Break(Node3D body)
{
    GD.Print("Brick broken!");
}

Test de signal connection

Test eerst of de signal correct verbonden is.

1. Test met F5:

   • Spring onder de brick door en raak hem van onderaf

   • Check de Output console (onderaan in Godot)

   • Zie je "Brick broken!" in de console?

   • Loop bovenop de brick - geen output! (correct, de Area3D zit onderaan)

Brick verwijderen

Voeg nu de code toe om de brick echt te verwijderen.

1. Pas de Break() method aan:

private void Break(Node3D body)
{
    // Wacht .2 seconden voordat we de brick verwijderen
    // Zo botst de speler nog eventjes tegen de brick
    GetTree().CreateTimer(0.2).Timeout += QueueFree;
}

Wat doet QueueFree()? Dit verwijdert de node aan het einde van het huidige frame - veiliger dan Free() omdat het wacht tot alle processing klaar is.

1. Test met F5:

   • Spring onder de brick door en raak hem van onderaf

   • De brick verdwijnt!

   • Loop bovenop de brick - hij breekt NIET (dit is correct!)

Meerdere bricks in de level

Nu kun je meerdere bricks toevoegen aan de level.

1. Open scenes/main.tscn

2. Instance meerdere Brick.tscn scenes op verschillende locaties

3. Positioneer ze:

   • Tussen platforms waar de player onder door kan springen

   • Boven collectibles die de player wil bereiken

   • Als obstakels die versperren maar verwijderd kunnen worden

4. Test met F5 en vernietig alle bricks door er van onderaf tegenaan te springen!

Complete brick script

Klik hier voor het volledige Brick.cs script

using Godot;

public partial class Brick : StaticBody3D
{
    private void Break(Node3D body)
    {
        // Verwijder de brick uit de scene
        GetTree().CreateTimer(0.2).Timeout += QueueFree;
    }
}