Particle

Category: Executor Tier: Basic

Purpose

Controls GPUParticles2D and CPUParticles2D emission states for gameplay bursts, lingering effects, and one-shot visual cues.

Visual Reference

As added to your scene
Particle brick as it appears in the GDLink editor

Runtime Behavior

Properties

  • Action (Enum, “Emit”):

    • Emit: Enables emission and keeps the particle node running.

    • Stop: Disables emission.

    • One-Shot: Restarts the emitter and fires exactly one cycle.

  • Target Node (String, “”): Optional particle node name or path. If empty, the executor uses the runtime host or the first particle descendant it finds.

  • Speed Scale (Float, 1.0): Adjusts the particle simulation speed.

  • Amount Multiplier (Float, 1.0): Scales the emitter amount against its saved base amount.

  • Verbose (Bool, false): Hidden inspector debug flag. Logs the resolved particle target and the applied action.

Generated UI Mockup — showing expanded properties
Particle
-
x
Name:
Label this brick...
Action:
Emit
Target:
v
Speed:
1.0
v
Count:
1.0
v
Verbose

Properties

Property

Type

Default

Notes

Action

option

Emit

Emit starts or continues the burst. Stop halts emission. One-Shot restarts and fires one burst.

Target

string

Particle node name or relative path (empty = self/first particle descendant)

Speed

float

1.0

Emission simulation speed scale

Count

float

1.0

Scales the particle amount against the emitter’s base amount

Verbose

bool

False

Log particle operations (controlled by ladybug button)