4. Platform Mechanics

Implementeer static, moving en falling platforms voor je platformer

Overzicht

In dit hoofdstuk bouw je verschillende soorten platforms voor je platformer. Je leert:

• Static platforms maken met StaticBody3D

• Moving platforms met AnimationPlayer

• Falling platforms die reageren op de player

Static platform scene

Begin met een eenvoudige static platform scene die later als basis dient.

1. Ga naar Scene > New Scene

2. Selecteer Other Node en zoek naar StaticBody3D

3. Klik Create

4. Hernoem de root node naar Platform

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

Waarom StaticBody3D? Dit is een physics body dat niet beweegt door gravity, maar wel collision heeft met andere bodies - perfect voor platforms.

Platform model toevoegen

1. Open het FileSystem panel

2. Navigeer naar models/platform.glb

3. Sleep platform.glb naar de Platform root node in de Scene hierarchy

4. Het model wordt nu als child toegevoegd

Scene hierarchy:

Platform (StaticBody3D)
└── platform (imported scene from platform.glb)

CollisionShape3D Toevoegen

Elke physics body heeft een collision shape nodig.

1. Selecteer de Platform 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 platform model bedekt

5. Sla de scene op

Scene hierarchy (updated):

Platform (StaticBody3D)
├── platform (imported scene)
└── CollisionShape3D (BoxShape3D)

Test de static platform

1. Open scenes/main.tscn

2. Sleep objects/Platform.tscn in de scene

3. Positioneer het platform in de level

4. Test met F5:

   • De player kan op het platform staan

   • Het platform beweegt niet

Moving platform

Maak nu een platform dat automatisch heen en weer beweegt. Gebruik AnimationPlayer om de beweging te animeren.

1. Maak een nieuwe scene (Scene > New Scene)

2. Selecteer 3D Scene

3. Hernoem de root node naar MovingPlatform

4. Rechts-klik op de root node > Add Child... > AnimatableBody3D

5. Klik Create

6. Sla de scene op als res://objects/MovingPlatform.tscn

Waarom AnimatableBody3D? Dit is een StaticBody3D die wel kan bewegen via animaties en scripts, terwijl physics bodies die erop staan correct meebewegen.

Model en collision toevoegen

1. Sleep models/platform.glb naar de AnimatableBody3D node

2. Voeg een CollisionShape3D child toe aan het AnimatableBody3D

3. Geef de CollisionShape3D een BoxShape3D

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

Scene hierarchy:

MovingPlatform (AnimatableBody3D)
├── platform (imported scene)
└── CollisionShape3D (BoxShape3D)

AnimationPlayer Toevoegen

1. Selecteer de AnimatableBody3D node

2. Rechts-klik > Add Child Node > AnimationPlayer

3. Sla de scene op

Scene hierarchy (updated):

MovingPlatform (AnimatableBody3D)
├── platform (imported scene)
├── CollisionShape3D (BoxShape3D)
└── AnimationPlayer

Move animatie maken

Maak nu een animatie die het platform heen en weer beweegt.

1. Selecteer de AnimationPlayer node

2. In het Animation panel onderaan, klik Animation > New Animation

3. Noem de animatie "move" en klik OK

4. Stel de animation length in op 2.0 seconden (rechts bovenaan in Animation panel)

5. Selecteer de MovingPlatform root node

6. Ga in de Inspector naar de Node3D > Transform property, en klik op het sleutel icoon

7. Klik op Create

8. Versleep de Animation Timer naar het einde (2 seconden)

9. In de Inspector, verplaats de X-positie naar 5, en klik terug op het sleutel icoon

10. In de Animation Editor, zorg er nu voor dat

    • de animatie heen en weer gaat, en

    • dat het platform vertraagt en versnelt

    • Dat de animatie automatisch start

Falling platform

Maak nu een platform dat naar beneden valt wanneer de player erop springt.

1. Maak een nieuwe scene (Scene > New Scene)

2. Selecteer Other Node > RigidBody3D

3. Hernoem de root node naar FallingPlatform

4. Klik Create

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

Model en collision toevoegen

1. Sleep models/platform-falling.glb naar de FallingPlatform root node

2. Voeg een CollisionShape3D child toe aan de FallingPlatform root node

3. Geef de CollisionShape3D een BoxShape3D

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

Scene hierarchy:

FallingPlatform (RigidBody3D)
├── platform-falling (imported scene)
└── CollisionShape3D (BoxShape3D)

Timer toevoegen

Gebruik een Timer-node om de vertraging te implementeren voordat het platform valt.

1. Selecteer de FallingPlatform root node

2. Rechts-klik > Add Child Node > Timer

3. Selecteer de Timer node

4. In de Inspector, stel Wait Time in op 0.5 seconden

5. Vink One Shot aan (timer loopt maar één keer af)

6. Sla de scene op

Scene hierarchy (updated):

FallingPlatform (RigidBody3D)
├── platform-falling (imported scene)
├── CollisionShape3D (BoxShape3D)
└── Timer

RigidBody3D Settings

Je wilt dat het platform pas valt wanneer de player erop staat, niet meteen bij de start.

1. Selecteer de RigidBody3D root node

2. In de Inspector, vind de Deactivation properties:

   • Freeze Mode: Kinematic

   • Freeze: Vink Freeze aan

3. Sla de scene op

Dit zorgt ervoor dat het platform initieel "bevroren" is en niet valt door gravity.

Activator area toevoegen

Gebruik een Area3D-node om de te detecteren wanneer de speler op het platform komt, zodat je daarna het platform naar beneden laat vallen.

1. Selecteer de FallingPlatform root node

2. Rechts-klik > Add Child Node > Area3D

3. Hernoem de Area3D naar FallingActivator

4. Selecteer de FallingActivator node

5. Rechts-klik > Add Child Node > CollisionShape3D

6. Geef de CollisionShape3D een BoxShape3D

7. Pas de BoxShape3D aan zodat deze een beetje boven het platform uitsteekt

8. Selecteer de FallingActivator node

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

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

11. Sla de scene op

1. Open objects/Player.tscn

2. Selecteer de Player root node

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

4. Zet Layer op 1 èn 2

Scene hierarchy (updated):

FallingPlatform (RigidBody3D)
├── platform-falling (imported scene)
├── CollisionShape3D (BoxShape3D)
├── FallingActivator (Area3D)
│   └── CollisionShape3D
└── Timer

Falling platform script

Maak nu een script dat de timer start wanneer de player op het platform komt.

1. Selecteer de FallingPlatform (RigidBody3D) root node

2. Klik op Attach Script

   • Language: C#

   • Template: Empty

   • Class Name: FallingPlatform

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

3. Klik Create

4. Voeg exported fields toe voor de Timer en Area3D:

using Godot;

public partial class FallingPlatform : RigidBody3D
{
    [Export] private Timer _fallTimer;
    [Export] private Area3D _fallActivator;
}

1. Voeg de _Ready() method toe:

using Godot;

public partial class FallingPlatform : RigidBody3D
{
    [Export] private Timer _fallTimer;
    [Export] private Area3D _fallActivator;

    public override void _Ready()
    {
    }
}

1. verbind je het Timeout signal van de timer. Wanneer de timer afloopt, bevrijd je het platform door Freeze op false te zetten:

    public override void _Ready()
    {
        // Wanneer timer afloopt, laat platform vallen
        _fallTimer.Timeout += OnTimerTimeout;
    }

    private void OnTimerTimeout()
    {
        Freeze = false;
    }

1. Verbind je het BodyEntered signal van de Area3D. Wanneer iets het platform raakt, start je de timer:

    public override void _Ready()
    {
        // Wanneer timer afloopt, laat platform vallen
        _fallTimer.Timeout += OnTimerTimeout;

        // Wanneer iets het platform raakt, start timer
        _fallActivator.BodyEntered += OnBodyEntered;
    }

    private void OnTimerTimeout()
    {
        Freeze = false;
    }

    private void OnBodyEntered(Node3D body)
    {
        _fallTimer.Start();
    }

Waarom twee signals?

• BodyEntered detecteert wanneer de player het platform raakt

• Timeout wacht 0.5 seconden voordat het platform valt

• Dit geeft de player tijd om te realiseren dat het platform gaat vallen

Nodes toewijzen in de editor

Nu moet je de Timer en FallingActivator nodes toewijzen aan het script.

1. Open objects/FallingPlatform.tscn

2. Selecteer de FallingPlatform root node

3. In de Inspector, zie je nu twee properties:

   • Fall Timer: Sleep de Timer node hierheen

   • Fall Activator: Sleep de FallingActivator (Area3D) node hierheen

4. Sla de scene op

Test de platforms

1. Open scenes/main.tscn

2. Voeg meerdere platforms toe aan je level:

   • Static platforms: Voor vaste platforms

   • Moving platforms: Voor platforms die bewegen

   • Falling platforms: Voor platforms die vallen

3. Test met F5:

   • Static platforms blijven op hun plaats

   • Moving platforms bewegen heen en weer (player beweegt mee!)

   • Falling platforms vallen ~0.5s nadat je erop springt

Tip: Plaats falling platforms boven een vangnet of respawn trigger!

Complete scripts

Klik hier voor het volledige FallingPlatform.cs script

FallingPlatform.cs

using Godot;

public partial class FallingPlatform : RigidBody3D
{
    [Export] private Timer _fallTimer;
    [Export] private Area3D _fallActivator;

    public override void _Ready()
    {
        // Wanneer timer afloopt, laat platform vallen
        _fallTimer.Timeout += OnTimerTimeout;

        // Wanneer iets het platform raakt, start timer
        _fallActivator.BodyEntered += OnBodyEntered;
    }

    private void OnTimerTimeout()
    {
        Freeze = false;
    }

    private void OnBodyEntered(Node3D body)
    {
        _fallTimer.Start();
    }
}