# particle-trail — Particle Trail VFX

A continuous stream of fading particles that follows a moving object. Creates motion blur / wake effects for projectiles, power-ups, and dashing characters.

## Use Cases

- **Projectile trail**: Arrow, bullet, fireball — follow the projectile
- **Dash trail**: Character dashing — brief trail on rapid movement
- **Collectible glow**: Coin/gem with ambient sparkle trail
- **Boss aura**: Constant particle aura around boss entity

## Parameters

| Parameter | Default | Description |
|-----------|---------|-------------|
| `count` | 20 | Max simultaneous particles |
| `lifetime` | 0.4s | How long each particle fades |
| `size` | 8px | Starting particle size |
| `color` | gold | Particle tint color |
| `emitRate` | 30/s | Particles emitted per second |
| `fadeOut` | true | Particles fade as they age |

## Engine References

- **Phaser 3**: `ref/phaser.js` — uses `scene.add.particles` with `follow()` mode
