Audio Effects

Voeg geluid toe aan je FPS shooter met AudioStreamPlayer

Overzicht

Voeg geluiden toe aan je FPS shooter:

• Weapon fire sound - Schietgeluid bij elk railgun schot

• Enemy death sound - Geluid wanneer een enemy sterft

Railgun Fire Sound

Begin met een geluid wanneer het wapen schiet.

1. Open objects/Railgun.tscn

2. Selecteer de Railgun root node

3. Rechts-klik > Add Child Node > AudioStreamPlayer3D

4. Hernoem deze node naar FireSound

5. Sla de scene op

Scene hierarchy:

Railgun (Node3D)
├── blaster (MeshInstance3D)
├── FireRateTimer (Timer)
├── Muzzle (Marker3D)
│   └── MuzzleFlash (GPUParticles3D)
└── FireSound (AudioStreamPlayer3D)

Fire Sound Instellen

1. Selecteer de FireSound node

2. In de Inspector, vind Stream

3. Klik op het dropdown > Load

4. Navigeer naar res://sounds/ en selecteer het blaster.ogg geluid

5. Klik Open

Voor weapon sounds wil je GEEN autoplay of loop - je triggert het bij elke shot.

1. Met FireSound geselecteerd:

   • Autoplay: UIT

   • Stream Paused: UIT

2. Expand Stream - zorg dat Loop UIT staat

3. Onder Volume, zet Volume Db op 0 (standaard volume)

Fire Sound Triggeren via Script

Je moet het geluid afspelen wanneer er geschoten wordt.

1. Open scripts/Railgun.cs

2. Voeg een exported field toe voor de audio player:

using Godot;

public partial class Railgun : Node3D
{
    [Export] private Timer _fireRateTimer;
    [Export] private Node3D _weaponMount;
    [Export] private Marker3D _muzzle;
    [Export] private GpuParticles3D _muzzleFlash;
    
    [Export] private AudioStreamPlayer3D _fireSound;

    // ... rest van de code
}

1. Nu speel je het geluid af in OnShoot():

public void OnShoot(RayCast3D raycast)
{
    if (!_fireRateTimer.IsStopped())
        return;

    _fireRateTimer.Start();

    // Trigger muzzle flash
    _muzzleFlash.Emitting = true;

    // Speel fire sound
    _fireSound.Play();

    // Bepaal het eindpunt van de beam
    Vector3 beamEnd = raycast.IsColliding()
        ? raycast.GetCollisionPoint()
        : _muzzle.GlobalPosition - raycast.GlobalBasis.Z * 100;

    // Teken de beam naar het hit point
    ShowBeam(_muzzle.GlobalPosition, beamEnd);

    // Check target hit
    if (raycast.GetCollider() is Target targetHit)
        targetHit.OnHit();

    GD.Print("Railgun fired!");
}

1. In de Editor, selecteer de Railgun node

2. Sleep de FireSound node naar de Fire Sound property in de Inspector

3. Sla op

Test de Fire Sound

Test met F5!

Je zou nu moeten horen:

• Elke keer dat je schiet (linkermuisknop), speelt een weapon sound

• Het geluid klinkt altijd even luid, ongeacht camera positie

• Het geluid synchroniseert met de visuele muzzle flash en beam

Als je geen geluid hoort:

• Check of Autoplay UIT staat

• Controleer of het audio bestand correct is ingeladen

• Zorg dat je computer volume aan staat

• Check of de FireSound node correct is toegewezen in de Inspector

Enemy Death Sound

Voeg nu een geluid toe wanneer een enemy sterft. Gebruik hier een AudioStreamPlayer3D voor omdat enemies op verschillende plekken in de level zijn.

1. Open objects/Enemy.tscn

2. Selecteer de torso node (RigidBody3D met Target.cs)

3. Rechts-klik > Add Child Node > AudioStreamPlayer3D

4. Hernoem deze node naar DeathSound

5. Sla de scene op

Scene hierarchy:

Enemy (Node3D)
├── AimRaycast (RayCast3D)
└── root (Node3D)
    ├── torso (RigidBody3D) - Target.cs
    │   ├── antenna (MeshInstance3D)
    │   ├── torso (MeshInstance3D)
    │   ├── CollisionShape3D
    │   ├── HitParticles (GPUParticles3D)
    │   └── DeathSound (AudioStreamPlayer3D)
    ├── blaster-left (MeshInstance3D) - Railgun.cs
    └── blaster-right (MeshInstance3D) - Railgun.cs

Death Sound Instellen

1. Selecteer de DeathSound node

2. In de Inspector, vind Stream

3. Klik op het dropdown > Load

4. Navigeer naar res://sounds/ en selecteer het enemy_destroy.ogg sound

5. Klik Open

6. Zet Autoplay op UIT

7. Expand Stream en zorg dat Loop UIT staat

3D Audio Settings voor Death Sound

1. Selecteer de DeathSound node

2. In de Inspector, onder Attenuation:

   • Unit Size: 5.0 (geluid blijft op vol volume tot 5 meter)

   • Max Distance: 40.0 (geluid is onhoorbaar na 40 meter)

3. Onder Attenuation Model, klik het dropdown en selecteer Inverse Square

Death Sound Script

Je moet het geluid afspelen wanneer de enemy sterft. Pas de Target.cs aan om eerst het death sound te spelen.

1. Open scripts/Target.cs

2. Voeg een exported field toe voor de death sound:

using Godot;

public partial class Target : RigidBody3D
{
    [Export] private Node3D _root;
    [Export] private GpuParticles3D _hitParticles;
    [Export] private AudioStreamPlayer3D _deathSound;

    // ... rest van de code
}

1. Nu spelen we het death sound af, verbergen we de enemy visuals, en wachten tot de effecten klaar zijn:

using Godot;

public partial class Target : RigidBody3D
{
    [Export] private Node3D _root;
    [Export] private GpuParticles3D _hitParticles;
    [Export] private AudioStreamPlayer3D _deathSound;

    public void OnHit()
    {
        // Speel death sound
        _deathSound.Play();

        // Trigger hit particles
        _hitParticles.Emitting = true;

        GD.Print("Target destroyed!");

        // Verberg alle meshes in de enemy
        foreach (var child in _root.GetChildren())
        {
            if (child is MeshInstance3D mesh)
                mesh.Visible = false;
        }

        // Wacht 2 seconden voordat we de enemy verwijderen
        // Zo kunnen de particles en audio hun animatie afspelen
        GetTree().CreateTimer(2.0).Timeout += () => _root.QueueFree();
    }
}

1. In de Editor, open objects/Enemy.tscn

2. Selecteer de torso node

3. In de Inspector, sleep de DeathSound node naar de Death Sound property

4. Sla op

Test alle Audio

Test met F5!

Je zou nu moeten horen:

• Railgun fire sound: Elke keer dat je schiet

• Enemy death sound: Wanneer een enemy sterft (3D spatialized - zachter verder weg)

Als geluiden niet werken:

• Check of alle audio bestanden correct zijn ingeladen

• Controleer of alle exported fields correct zijn toegewezen in de Inspector

• Zorg dat Autoplay UIT staat voor beide sounds

• Controleer je computer volume instellingen

Complete Scripts

Klik hier voor de volledige scripts met audio

Railgun.cs

using Godot;

public partial class Railgun : Node3D
{
    [Export] private Timer _fireRateTimer;
    [Export] private Node3D _weaponMount;
    [Export] private Marker3D _muzzle;
    [Export] private GpuParticles3D _muzzleFlash;
    [Export] private AudioStreamPlayer _fireSound;

    public override void _Process(double delta)
    {
        GlobalTransform = _weaponMount.GlobalTransform;
    }

    public void OnShoot(RayCast3D raycast)
    {
        if (!_fireRateTimer.IsStopped())
            return;

        _fireRateTimer.Start();

        // Trigger muzzle flash
        _muzzleFlash.Emitting = true;

        // Speel fire sound
        if (_fireSound != null)
            _fireSound.Play();

        // Bepaal het eindpunt van de beam
        Vector3 beamEnd = raycast.IsColliding()
            ? raycast.GetCollisionPoint()
            : _muzzle.GlobalPosition - raycast.GlobalBasis.Z * 100;

        // Teken de beam naar het hit point
        ShowBeam(_muzzle.GlobalPosition, beamEnd);

        // Check target hit
        if (raycast.GetCollider() is Target targetHit)
            targetHit.OnHit();

        GD.Print("Railgun fired!");
    }

    private void ShowBeam(Vector3 start, Vector3 end)
    {
        // Maak een cilinder mesh voor de beam
        var beamMesh = new CylinderMesh();
        beamMesh.TopRadius = 0.02f;
        beamMesh.BottomRadius = 0.02f;
        beamMesh.Height = 1.0f;

        var material = new StandardMaterial3D();
        material.ShadingMode = BaseMaterial3D.ShadingModeEnum.Unshaded;
        material.AlbedoColor = Colors.Cyan;
        material.NoDepthTest = true;

        var beamInstance = new MeshInstance3D
        {
            Mesh = beamMesh,
            MaterialOverride = material,
            CastShadow = GeometryInstance3D.ShadowCastingSetting.Off
        };

        GetTree().Root.AddChild(beamInstance);

        Vector3 direction = end - start;
        float distance = direction.Length();

        beamInstance.GlobalPosition = start + direction / 2;
        beamInstance.LookAt(end, Vector3.Up);
        beamInstance.RotateObjectLocal(Vector3.Right, Mathf.Pi / 2);
        beamInstance.Scale = new Vector3(1, distance, 1);

        GetTree().CreateTimer(0.05).Timeout += () => beamInstance.QueueFree();
    }
}

Target.cs

using Godot;

public partial class Target : RigidBody3D
{
    [Export] private Node3D _root;
    [Export] private GpuParticles3D _hitParticles;
    [Export] private AudioStreamPlayer3D _deathSound;

    public void OnHit()
    {
        // Speel death sound
        if (_deathSound != null)
            _deathSound.Play();

        // Trigger hit particles
        if (_hitParticles != null)
            _hitParticles.Emitting = true;

        GD.Print("Target destroyed!");

        // Verberg alle meshes in de enemy
        foreach (var child in _root.GetChildren())
        {
            if (child is MeshInstance3D mesh)
                mesh.Visible = false;
        }

        // Wacht 2 seconden voordat we de enemy verwijderen
        // Zo kunnen de particles en audio hun animatie afspelen
        GetTree().CreateTimer(2.0).Timeout += () => _root.QueueFree();
    }
}