4. Input Actions en Basis Beweging

Leer Input Actions configureren en implementeer basis beweging met CharacterBody3D

Overzicht

In dit hoofdstuk breng je je ruimteschip tot leven! Je implementeert automatische voorwaartse beweging en 4-richtingen controle (links, rechts, omhoog, omlaag). Daarna voeg je een camera toe als child node die automatisch met het schip meevliegt.

Input actions configureren

Voordat je input kunt verwerken, moet je Input Actions definiëren in de Project Settings. Dit zijn benoemde acties (zoals "move_left") die je kunt koppelen aan toetsenbord keys, controller buttons, etc.

1. Ga in Godot naar Project > Project Settings

2. Klik op het Input Map tabblad bovenaan

3. Bij Add New Action, typ move_left en druk Enter

4. Klik op het + icoon naast "move_left"

5. Druk op de A toets (Q als je een AZERTY toetsenbord hebt), klik OK

6. Herhaal voor de andere acties:

   • move_right - toets D

   • move_up - toets W (Z als je een AZERTY toetsenbord hebt)

   • move_down - toets S

7. Sluit de Project Settings

Je hebt nu 4 input actions die je in code kunt gebruiken!

Voor Azerty gebruikers gebruik je de toetsen ZQSD. Godot zal dan de fysieke locatie gebruiken van de toets (bv. voor Z zal dit W (physical) zijn).

Camera toevoegen als child node

Voordat je beweging programmeert, heb je een camera nodig om te zien wat er gebeurt! Voeg een camera toe die automatisch met het schip meevliegt.

In Godot is de positie van een child node relatief aan de parent. Omdat de Camera3D een child wordt van Player, beweegt deze automatisch mee wanneer Player beweegt.

1. Selecteer de Player node in de Scene Hierarchy

2. Rechtsklik en kies Add Child Node

3. Zoek naar Camera3D en voeg deze toe

4. Selecteer de Camera3D in de hierarchy

5. Pas in de Inspector de Transform > Position aan:

   • X: 0 (gecentreerd)

   • Y: 2 (iets boven het schip)

   • Z: 5 (achter het schip)

Als je scene nog een losse Camera3D heeft (niet als child van Player), kun je deze verwijderen met Delete. Gebruik nu alleen de camera die met het schip meebeweegt.

Auto-forward movement implementeren

Laat het ruimteschip automatisch vooruit vliegen! Maak een variabele voor de snelheid en gebruik deze in _PhysicsProcess() om het schip te bewegen.

Nieuwe Godot-specifieke elementen:

• [Export] - Maakt de variabele zichtbaar in de Inspector, zodat je de snelheid kunt aanpassen zonder code te wijzigen

• Velocity - Een Vector3 property die de snelheid van de CharacterBody3D bepaalt

• MoveAndSlide() - Beweegt de CharacterBody3D op basis van de Physics eigenschappen (zoals Velocity) van de CharacterBody3D en detecteert collision met de omgeving

• Transform.Basis - De forward richting van het object in local space

• -forwardSpeed - Negatief omdat in Godot -Z = vooruit is

• _PhysicsProcess() - Wordt aangeroepen op vaste tijdsintervallen, perfect voor physics-based beweging

CharacterBody3D heeft ingebouwde physics. Door Velocity in te stellen en MoveAndSlide() aan te roepen, kan je schip nu dus botsen met obstakels en andere physics objecten.

1. Voeg een speed variabele toe bovenaan de class:

public partial class PlayerController : CharacterBody3D
{
    [Export] private float _forwardSpeed = 10f;
}

De [Export] attribuut maakt deze variabele aanpasbaar in de Godot Inspector.

1. Voeg de lege _PhysicsProcess() method toe:

public partial class PlayerController : CharacterBody3D
{
    [Export] private float _forwardSpeed = 10f;

    public override void _PhysicsProcess(double delta)
    {
    }
}

1. Maak een movement variabele aan:

    public override void _PhysicsProcess(double delta)
    {
        Vector3 movement = Vector3.Zero;
    }

Begin met een nul-vector (Vector3.Zero) en bouw de beweging stap voor stap op.

1. Voeg voorwaartse beweging toe:

    public override void _PhysicsProcess(double delta)
    {
        Vector3 movement = Vector3.Zero;

        // Beweeg automatisch vooruit (langs de -Z as)
        movement += Transform.Basis.Z * -_forwardSpeed;
    }

Transform.Basis.Z geeft de forward richting van het schip. Vermenigvuldig met -_forwardSpeed omdat in Godot -Z = vooruit.

1. Pas de Velocity aan en beweeg met physics:

    public override void _PhysicsProcess(double delta)
    {
        Vector3 movement = Vector3.Zero;

        // Beweeg automatisch vooruit (langs de -Z as)
        movement += Transform.Basis.Z * -_forwardSpeed;

        // Pas de Velocity aan en beweeg met physics
        Velocity = movement;
        MoveAndSlide();
    }

Velocity bepaalt de snelheid van de CharacterBody3D. MoveAndSlide() beweegt het schip en detecteert collisions.

1. Test met F6. Je ruimteschip vliegt nu automatisch vooruit!

Turning en vertical movement toevoegen

Voeg nu stuurbesturing toe! Het schip kan draaien (links/rechts) en omhoog/omlaag bewegen. Het schip beweegt altijd in de richting waar het naartoe wijst.

Nieuwe Godot-specifieke elementen:

• Input.IsActionPressed() - Checkt of een input action momenteel ingedrukt is (geeft true terug zolang de toets wordt ingehouden)

• Rotation - De yaw rotatie (draaien links/rechts) in radialen

1. Voeg twee nieuwe variabelen toe:

public partial class PlayerController : CharacterBody3D
{
    [Export] private float _forwardSpeed = 10f;
    [Export] private float _turnSpeed = 2f;
    [Export] private float _verticalSpeed = 5f;
}

1. Voeg turning toe. Plaats dit na de forward movement, maar voor Velocity = movement:

    public override void _PhysicsProcess(double delta)
    {
        Vector3 movement = Vector3.Zero;
        movement += Transform.Basis.Z * -_forwardSpeed;

        // Links/Rechts - draai het schip
        if (Input.IsActionPressed("move_left"))
            Rotation = new Vector3(Rotation.X, Rotation.Y + _turnSpeed * (float)delta, Rotation.Z);
        if (Input.IsActionPressed("move_right"))
            Rotation = new Vector3(Rotation.X, Rotation.Y - _turnSpeed * (float)delta, Rotation.Z);

        Velocity = movement;
        MoveAndSlide();
    }

We passen Rotation.Y aan (yaw - draaien links/rechts). Vermenigvuldig met delta voor smooth, frame-rate independent rotatie.

1. Test met F6. Gebruik A en D - het schip draait!

2. Voeg verticale beweging toe. Plaats dit na de turning code:

    public override void _PhysicsProcess(double delta)
    {
        Vector3 movement = Vector3.Zero;
        movement += Transform.Basis.Z * -_forwardSpeed;

        // Links/Rechts - draai het schip
        if (Input.IsActionPressed("move_left"))
            Rotation = new Vector3(Rotation.X, Rotation.Y + _turnSpeed * (float)delta, Rotation.Z);
        if (Input.IsActionPressed("move_right"))
            Rotation = new Vector3(Rotation.X, Rotation.Y - _turnSpeed * (float)delta, Rotation.Z);

        // Omhoog/Omlaag (Y-as)
        if (Input.IsActionPressed("move_up"))
            movement.Y += _verticalSpeed;
        if (Input.IsActionPressed("move_down"))
            movement.Y -= _verticalSpeed;

        Velocity = movement;
        MoveAndSlide();
    }

Pas movement.Y aan om het schip omhoog en omlaag te laten bewegen.

1. Test met F6. Gebruik W/A/S/D - volledige controle!

Experimenteer met snelheden! Selecteer de Player node in Godot en kijk in de Inspector. Je ziet nu Forward Speed, Turn Speed en Vertical Speed dankzij [Export]. Pas de waarden aan en test opnieuw!

Boost functie toevoegen

Voeg een boostfunctie toe die het schip 20% sneller maakt wanneer je de spatiebalk indrukt.

Boost input actie

Voeg eerst de boost input actie toe aan je project. Ga naar Project > Project Settings > Input Map. Voeg een nieuwe actie toe genaamd "boost" en wijs de Spatiebalk toe.

Boost multiplier

Voeg een boost multiplier variabele toe:

[Export] private float _boostMultiplier = 1.2f; // 20% sneller

Dit betekent dat het schip 1.2× (20%) sneller vliegt tijdens boost.

Boost toepassen

De boost werkt door de forward speed tijdelijk te verhogen. Pas de forward movement code aan.

1. Vervang de forward movement regel door een versie met boost check:

Oude code (verwijder dit):

movement += Transform.Basis.Z * -_forwardSpeed;

Nieuwe code (voeg dit toe):

// Auto-forward movement met optionele boost
float currentSpeed = _forwardSpeed;
if (Input.IsActionPressed("boost"))
    currentSpeed *= _boostMultiplier;

movement += Transform.Basis.Z * -currentSpeed;

Maak een currentSpeed variabele die start op normale snelheid. Als de boost-toets is ingedrukt, verhoog je deze met de multiplier.

1. De volledige _PhysicsProcess() ziet er nu zo uit:

public override void _PhysicsProcess(double delta)
{
    Vector3 movement = Vector3.Zero;

    // Auto-forward movement met optionele boost
    float currentSpeed = _forwardSpeed;
    if (Input.IsActionPressed("boost"))
        currentSpeed *= _boostMultiplier;

    movement += Transform.Basis.Z * -currentSpeed;

    // Links/Rechts - draai het schip
    if (Input.IsActionPressed("move_left"))
        Rotation = new Vector3(Rotation.X, Rotation.Y + _turnSpeed * (float)delta, Rotation.Z);
    if (Input.IsActionPressed("move_right"))
        Rotation = new Vector3(Rotation.X, Rotation.Y - _turnSpeed * (float)delta, Rotation.Z);

    // Omhoog/Omlaag (Y-as)
    if (Input.IsActionPressed("move_up"))
        movement.Y += _verticalSpeed;
    if (Input.IsActionPressed("move_down"))
        movement.Y -= _verticalSpeed;

    // Pas de Velocity aan en beweeg met physics
    Velocity = movement;
    MoveAndSlide();
}

1. Test met F6. Hou de spatiebalk ingedrukt - het schip gaat nu sneller!

Complete Script

Klik hier voor het volledige PlayerController.cs script

using Godot;

public partial class PlayerController : CharacterBody3D
{
	[Export] private float _forwardSpeed = 10f;
	[Export] private float _turnSpeed = 2f;
	[Export] private float _verticalSpeed = 5f;
	[Export] private float _boostMultiplier = 1.2f;

	public override void _PhysicsProcess(double delta)
	{
		Vector3 movement = Vector3.Zero;

		// Auto-forward movement met optionele boost
		float currentSpeed = _forwardSpeed;
		if (Input.IsActionPressed("boost"))
			currentSpeed *= _boostMultiplier;

		movement += Transform.Basis.Z * -currentSpeed;

		// Links/Rechts - draai het schip
		if (Input.IsActionPressed("move_left"))
			Rotation = new Vector3(Rotation.X, Rotation.Y + _turnSpeed * (float)delta, Rotation.Z);
		if (Input.IsActionPressed("move_right"))
			Rotation = new Vector3(Rotation.X, Rotation.Y - _turnSpeed * (float)delta, Rotation.Z);

		// Omhoog/Omlaag (Y-as)
		if (Input.IsActionPressed("move_up"))
			movement.Y += _verticalSpeed;
		if (Input.IsActionPressed("move_down"))
			movement.Y -= _verticalSpeed;

		// Pas de Velocity aan en beweeg met physics
		Velocity = movement;
		MoveAndSlide();
	}
}