---
generated_by: gdlink-build
generated_at: 2026-06-23T12:34:28Z
do_not_edit: true
title: Particle
brick_type: executor
tier: Basic
generated: true
---

# Particle

**Category:** Executor
**Tier:** Basic

## Purpose

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

## Visual Reference

```{raw} html
<div class="illustration-container"><div class="illustration-box"><div class="box-header">As added to your scene</div><img src="https://gdlink.solventech.ca/guide/assets/images/bricks/particle_executor.png" alt="Particle brick as it appears in the GDLink editor" loading="lazy" style="max-width:100%;height:auto;display:block;margin:0 auto;border-radius:8px;" /></div></div>
```

## 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.

```{raw} html
<div class="illustration-container">
        <div class="illustration-box">
            <div class="box-header">Generated UI Mockup — showing expanded properties</div>
            <div class="real-node brick-executor">
                <div class="real-header">
                    <div class="real-title"><span class="brick-icon-fallback"></span> <span>Particle</span></div>
                    <div class="real-controls"><div class="real-checkbox"></div><div class="real-btn">-</div><div class="real-btn">x</div></div>
                </div>
                <div class="real-inner-panel"><div class="real-row name-row" style="position:relative;"><span class="real-label">Name:</span><div class="real-input" style="color:#666; font-style:italic;">Label this brick...</div><div class="real-port" style="left:-15px;"></div></div><div class="real-row"><span class="real-label">Action:</span><div class="real-input-dropdown">Emit</div></div><div class="real-row"><span class="real-label" style="width: auto; padding-right:8px;">Target:</span><div class="real-input" style="justify-content:space-between; padding:4px 8px;"><span></span><div class="real-input-dropdown-btn" style="padding:2px 6px;">v</div></div></div><div class="real-row"><span class="real-label">Speed:</span><div class="real-inline-input" style="border-bottom: 1px solid #2f333b;"><span>1.0</span></div><div class="real-val-btn" style="margin-left:4px;">v</div></div><div class="real-row"><span class="real-label">Count:</span><div class="real-inline-input" style="border-bottom: 1px solid #2f333b;"><span>1.0</span></div><div class="real-val-btn" style="margin-left:4px;">v</div></div><div class="real-inline-row" style="margin-top:4px;"><div class="real-inline-btn" style="background:#2f343d;">Verbose</div></div></div>
            </div>
        </div>
    </div>
```

## 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) |