Weapon Effects

Voeg muzzle flash particle effect toe aan de railgun

Overzicht

Voeg een visueel effect toe aan het wapen om schieten impactvol te maken:

• Muzzle flash - Korte energieflits bij het schieten van de railgun

Muzzle Flash - GPUParticles3D

De muzzle flash is een korte energieflits aan het uiteinde van het wapen wanneer je schiet. Voeg dit toe als child van de bestaande Muzzle marker.

1. Open objects/Railgun.tscn

2. Selecteer de Muzzle node (Marker3D)

3. Rechts-klik > Add Child Node > GPUParticles3D

4. Hernoem deze node naar MuzzleFlash

5. Sla de scene op

Scene hierarchy:

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

Waarom als child van Muzzle? Door de MuzzleFlash als child van de Muzzle marker te plaatsen, hoeven we geen positie in te stellen - hij zit automatisch op de juiste plek aan het uiteinde van het wapen.

Muzzle Flash Material

Maak een speciaal materiaal dat de particle kleuren correct weergeeft.

1. Selecteer de MuzzleFlash node

2. In de Inspector, vind GeometryInstance3D > Geometry > Material Override

3. Klik op het dropdown > New StandardMaterial3D

4. Klik op de nieuwe StandardMaterial3D om het te openen

5. Onder Shading, zet Mode op Unshaded

6. Onder Transparency, zet Mode op Alpha

7. Onder Vertex Color, zet Use As Albedo op aan (vink aan), dit zorgt dat de kleuren uit de particle settings zichtbaar worden

8. Onder Cull Mode, zet op disabled (BELANGRIJK! anders zullen je particles niet zichtbaar zijn vanuit de speler)

Muzzle Flash One-Shot Settings

De muzzle flash moet een korte burst zijn per shot.

1. Selecteer de MuzzleFlash node

2. In de Inspector, vind Emitting en vink deze UIT

3. Onder Time, zet:

   • Lifetime: 0.05 (zeer korte flash)

   • Amount: 3 (enkele particles voor subtle effect)

   • One Shot: vink aan

   • Explosiveness: 1.0

   • Randomness: 0.5

   • zet Fixed FPS op 60

4. Onder Drawing, vink Local Coords aan

Muzzle Flash Process Material

1. Selecteer de MuzzleFlash node

2. In de Inspector, vind Process Material

3. Klik op het dropdown > New ParticleProcessMaterial

4. Klik op de nieuwe ParticleProcessMaterial

Muzzle Flash Direction

De flash moet naar voren schieten vanuit het wapen.

1. Onder Process Material > Spawn > Velocity Direction, zet:

   • X: 0

   • Y: 0

   • Z: -1 (voorwaarts)

2. Onder Spread, zet 15 (kleine spreiding)

3. Onder Initial Velocity, zet:

   • Min: 8.0

   • Max: 12.0

Muzzle Flash Scale

1. Onder Process Material > Display > Scale, zet:

   • Min: 0.3

   • Max: 0.5

2. Klik het [empty] veld naast Scale Curve

3. Selecteer New CurveTexture

4. Klik op de nieuwe CurveTexture

5. Klik op de het veld naar Curve

   • Linker punt: Sleep omhoog tot Y = 1.0

   • Rechter punt: Sleep omhoog tot Y = 0

Muzzle Flash Color

Gebruik een fel-cyaan-naar-blauw-gradient voor een energie-effect dat past bij de railgun.

1. Onder Process Material > Display > Color Curves, klik het [empty] veld naast Color Ramp

2. Selecteer New GradientTexture1D

3. Klik op de nieuwe GradientTexture1D

4. Klik op het [empty] veld naast Gradient

5. Selecteer New Gradient

6. Klik op de nieuwe Gradient

   1. Klik op de linker color marker

   2. In de color picker, zet (fel cyan):

      • R: 0.0

      • G: 1.0

      • B: 1.0

      • A: 1.0

   3. Klik op de rechter color marker

   4. In de color picker, zet (donker blauw):

      • R: 0.0

      • G: 0.2

      • B: 0.8

      • A: 0.0 (volledig transparant)

Muzzle Flash Mesh

1. Selecteer de MuzzleFlash node

2. In de Inspector, vind Draw Passes

3. Onder Pass 1, klik het dropdown > New QuadMesh

4. Klik op de nieuwe QuadMesh

5. Zet Size op:

   • X: 0.15

   • Y: 0.15

Particle Triggeren via Script

Nu moet je het particle-systeem triggeren wanneer het wapen schiet.

1. Open scripts/Railgun.cs

2. Voeg eerst een exported field toe voor de particle node:

using Godot;

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

    [Export] private GpuParticles3D _muzzleFlash;

    // ... rest van de code
}

1. Trigger nu de particle in OnShoot(). Het particle systeem gebruikt one-shot mode, dus het speelt één keer af per trigger. De muzzle flash is zeer kort (0.05s) voor een snelle energieflits.

using Godot;

public partial class Railgun : Node3D
{
    // ... rest van de code

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

        _fireRateTimer.Start();

        // Trigger muzzle flash
        _muzzleFlash.Emitting = true;

        // 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!");
    }
}

Particle Node Toewijzen in de Editor

Nu moet je de particle-node toewijzen aan het Railgun script.

1. Open objects/Railgun.tscn

2. Selecteer de Railgun root node

3. In de Inspector, zie je nu een nieuwe property: Muzzle Flash

4. Navigeer naar Muzzle > MuzzleFlash en sleep deze naar de Muzzle Flash property

5. Sla de scene op

Test de Weapon Effect

Test met F5!

Je zou nu moeten zien:

• Bij elk schot verschijnt een cyan energieflits aan het uiteinde van het wapen

• De flash verdwijnt heel snel (0.05s)

• De flash past bij de cyan beam van de railgun

Als het effect niet verschijnt:

• Check of Emitting UIT staat in de MuzzleFlash node

• Controleer of One Shot aanstaat

• Check of Railgun.cs geen errors heeft

• Controleer of de MuzzleFlash node correct is toegewezen in de Inspector

Complete Script

Het volledige Railgun script met particle effect

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;

    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;

        // 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();
    }
}