Particles

Particle systems — falling, floating, scatter, mist, trailing, flow, and mark fields with depth lanes.

Depth-aware particle systems with 7 layer types, 46 presets, and atmospheric perspective modes. Supports falling, floating, scattered, mist band, trailing, flow field, and mark field particles.

Installation

npm install @genart-dev/plugin-particles

Layer Types

Type ID	Display Name	Description
`particles:falling`	Falling	Gravity-driven particles (snow, rain, petals, embers)
`particles:floating`	Floating	Ambient drifting particles (dust, fireflies, pollen)
`particles:scatter`	Scatter	Static scattered elements (leaves, pebbles, shells)
`particles:mist`	Mist	Horizontal fog/mist bands with noise
`particles:trailing`	Trailing	Motion trails (meteors, speed rain, sparks)
`particles:flow`	Flow	Curl-noise flow paths (smoke, ink, aurora)
`particles:mark-field`	Mark Field	Directional marks (grass blades, reeds, ink scatter)

Properties

particles:falling

Property	Type	Default	Description
`preset`	`select`	`"snow"`	snow, rain, autumn-leaves, petals, embers, ash-fall, cherry-blossoms, confetti, pine-needles
`seed`	`number`	`42`	Random seed (0–99999)
`count`	`number`	`150`	Number of particles (5–2000)
`sizeMin`	`number`	`2`	Minimum size (0.5–20)
`sizeMax`	`number`	`6`	Maximum size (0.5–20)
`windAngle`	`number`	`10`	Wind angle in degrees (−60 to 60)
`windStrength`	`number`	`0.15`	Wind strength (0–1)
`fallProgress`	`number`	`0.5`	Fall position snapshot (0–1)
`color`	`color`	`"#FFFFFF"`	Particle color
`colorVariation`	`number`	`0.1`	Color variation (0–1)
`opacity`	`number`	`0.7`	Particle opacity (0–1)
`depthDistribution`	`select`	`"uniform"`	uniform, foreground-heavy, background-heavy, midground
`depthEasing`	`select`	`"linear"`	linear, quadratic, cubic, exponential
`horizonY`	`number`	`0.3`	Horizon line position (0–1)
`depthLane`	`select`	`"foreground"`	Depth lane for scene integration
`atmosphericMode`	`select`	`"none"`	none, western, ink-wash

particles:flow

Property	Type	Default	Description
`preset`	`select`	`"flow-smoke"`	flow-smoke, ink-diffusion, aurora, lava-flow, water-current, wind-streams
`seed`	`number`	`42`	Random seed
`count`	`number`	`60`	Number of flow paths (5–500)
`pathSteps`	`number`	`80`	Steps per path (10–300)
`stepSize`	`number`	`0.018`	Step distance (0.002–0.08)
`noiseScale`	`number`	`1.2`	Curl noise scale (0.1–8.0)
`swirling`	`number`	`0.15`	Swirl intensity (0–1)
`flowAngle`	`number`	`0`	Base flow direction (0–360°)
`flowStrength`	`number`	`0`	Flow field strength (0–1)
`sizeMin`	`number`	`0.8`	Minimum stroke size (0.2–20)
`sizeMax`	`number`	`2.5`	Maximum stroke size (0.2–20)
`color`	`color`	`"#C8C8C8"`	Flow color
`opacity`	`number`	`0.55`	Opacity (0–1)
`depthLane`	`select`	`"foreground"`	Depth lane
`atmosphericMode`	`select`	`"none"`	none, western, ink-wash

particles:mark-field

Property	Type	Default	Description
`preset`	`select`	`"grass-blades"`	grass-blades, reed-field, ink-scatter, dry-brush, charcoal-scatter, calligraphy-marks
`seed`	`number`	`42`	Random seed
`count`	`number`	`300`	Number of marks (10–2000)
`markLength`	`number`	`0.04`	Mark length as canvas fraction (0.005–0.3)
`markWidth`	`number`	`1.5`	Mark stroke width (0.2–12)
`angle`	`number`	`-80`	Base angle in degrees (−180 to 180)
`angleVariation`	`number`	`20`	Angle variation (0–180°)
`curvature`	`number`	`0.25`	Mark curvature (0–1)
`markStyle`	`select`	`"ink"`	ink, brush, pencil, technical
`color`	`color`	`"#1C1C1C"`	Mark color
`opacity`	`number`	`0.7`	Opacity (0–1)
`depthLane`	`select`	`"foreground"`	Depth lane
`atmosphericMode`	`select`	`"none"`	none, western, ink-wash

MCP Tools

Tool	Description
`add_particles`	Add a particle layer by preset (auto-resolves layer type)
`list_particle_presets`	List 46 presets, optionally filtered by category
`set_particle_depth`	Configure depth: horizonY, easing, distribution, band
`set_particle_motion`	Configure motion: wind angle/strength, drift, fall progress
`set_particle_style`	Configure visuals: color, opacity, glow, size range
`set_depth_lane`	Set depth lane and atmospheric mode
`create_atmosphere`	Create multi-layer atmospheric scene from 6 recipes
`randomize_particles`	Add a random particle layer, optionally by category
`set_mist_band`	Configure mist band position, softness, density, layers

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "particles:falling",
    "properties": {
      "preset": "cherry-blossoms",
      "seed": 42,
      "count": 200,
      "windAngle": 15,
      "windStrength": 0.2,
      "fallProgress": 0.6,
      "depthLane": "foreground"
    }
  }
}

Particles

On this page