# particle-confetti — Celebration Confetti VFX

Falling confetti shower for level complete, win screens, and achievement moments.

## Two Approaches

### Approach A: Sprite Sheet (Cross-Engine, Recommended)
```bash
playcraft image use-vfx --preset confetti --output assets/vfx/confetti.png
```

### Approach B: Runtime Particles (Phaser 3)
Colorful rectangles with gravity, rotation, and wind drift.

## Parameters

| Parameter | Default | Description |
|-----------|---------|-------------|
| `count` | 80 | Total confetti pieces |
| `duration` | 2000ms | Emitter active time |
| `colors` | rainbow | Confetti color palette |
| `gravity` | 300 | Downward fall speed |
| `spread` | full width | Horizontal spawn width |
| `rotation` | random | Per-piece rotation speed |

## Decision Notes

| Decision | Reason |
|----------|--------|
| Top-edge spawn | Confetti should fall from above, creating natural rain effect |
| Multiple colors | Celebration requires visual richness; single color looks monotone |
| 2s duration | Long enough to feel festive; not so long it interrupts next scene |
