Plants

Procedural plants — trees, flowers, ferns, grasses, and ecosystems via L-systems, phyllotaxis, and geometric engines.

Procedural botanical illustration using L-system, phyllotaxis, and geometric engines. 110 presets across 9 categories with drawing styles, growth animation, and wind dynamics.

Installation

npm install @genart-dev/plugin-plants

Layer Types

Type ID	Display Name	Description
`plants:tree`	Tree	L-system trees with depth-based coloring
`plants:fern`	Fern	L-system ferns (Barnsley, maidenhair, bracken)
`plants:flower`	Flower	L-system, phyllotaxis, and geometric flowers
`plants:vine`	Vine	Climbing and trailing L-system plants
`plants:grass`	Grass	Grasses, cereals, and bamboo via L-system
`plants:phyllotaxis`	Phyllotaxis	Rosettes, spirals, and radial patterns
`plants:root-system`	Root System	Taproots, fibrous roots, rhizomes via L-system
`plants:hedge`	Hedge	Dense shrubs and hedgerows from multiple instances
`plants:ecosystem`	Ecosystem	Multi-plant scene with depth and atmospheric perspective

Properties

All plant layer types (except ecosystem) share a common property set.

Common Properties

Property	Type	Default	Description
`seed`	`number`	`42`	Random seed for stochastic variation
`iterations`	`number`	`0`	L-system iteration count (0–12)
`trunkColor`	`color`	`""`	Trunk/stem color
`branchColor`	`color`	`""`	Branch/secondary color
`leafColor`	`color`	`""`	Leaf/accent color
`drawingStyle`	`select`	`"precise"`	Drawing style: precise, ink-sketch, silhouette
`detailLevel`	`select`	`"standard"`	Detail: minimal, sketch, standard, detailed, botanical-plate
`strokeJitter`	`number`	`0`	Stroke jitter amount (0–1)
`inkFlow`	`number`	`0.5`	Ink flow/wetness (0–1)
`lineWeight`	`number`	`1`	Line weight multiplier (0.1–5)
`elevation`	`number`	`0`	View elevation angle in degrees (0–90)
`azimuth`	`number`	`0`	View rotation in degrees (0–360)
`growthTime`	`number`	`1`	Growth time 0–1 (continuous tDOL interpolation)
`growthCurve`	`select`	`"linear"`	Growth easing: linear, sigmoid, spring
`windDirection`	`number`	`0`	Wind direction in degrees (0–360)
`windStrength`	`number`	`0`	Wind strength (0–1)
`gustFrequency`	`number`	`1`	Gust oscillation frequency (0.1–5)
`gustVariance`	`number`	`0.3`	Gust strength randomness (0–1)
`windTurbulence`	`number`	`0`	Spatial wind variation via Perlin noise (0–1)
`windTime`	`number`	`0`	Wind animation time within gust cycle (0–1)
`showFruit`	`boolean`	`false`	Enable fruit rendering
`fruitType`	`select`	`"apple"`	Fruit type: apple, orange, cherry, berry, cone, acorn, seed-pod
`fruitDensity`	`number`	`0.3`	Fruit density (0–1)
`showBark`	`boolean`	`false`	Enable bark texture
`barkType`	`select`	`"furrowed"`	Bark: smooth, furrowed, peeling, rough, ringed
`showVeins`	`boolean`	`false`	Enable leaf vein rendering
`veinPattern`	`select`	`"pinnate"`	Vein pattern: pinnate, palmate, parallel, dichotomous

plants:hedge (additional)

Property	Type	Default	Description
`count`	`number`	`5`	Number of plant instances (2–15)
`density`	`number`	`0.7`	Overlap density factor (0.2–1.0)

plants:ecosystem

Property	Type	Default	Description
`seed`	`number`	`42`	Random seed
`arrangement`	`select`	`"scatter"`	Style: scatter, row, grove, border, terraced
`groundType`	`select`	`"none"`	Ground: none, grass, soil, water, stone, snow
`groundColor`	`color`	`""`	Ground color
`fog`	`number`	`0.3`	Atmospheric fog strength (0–1)
`atmosphereColor`	`color`	`"#8899bb"`	Atmosphere color for perspective
`drawingStyle`	`select`	`"precise"`	Drawing style: precise, ink-sketch, silhouette
`detailLevel`	`select`	`"standard"`	Detail level
`lineWeight`	`number`	`1`	Line weight multiplier

MCP Tools

Tool	Description
`add_plant`	Add a plant layer from 110 botanical presets
`list_plant_presets`	List presets with filtering by category, tags, complexity, or engine
`search_plants`	Full-text search across preset names, scientific names, and tags
`set_plant_grammar`	Edit L-system grammar: axiom, productions, iterations, angles
`set_plant_tropism`	Configure tropism forces (gravity, phototropism, susceptibility)
`set_plant_season`	Switch color palette to seasonal variant (spring/summer/autumn/winter)
`grow_plant`	Step L-system growth by changing iteration count
`create_garden`	Compose multiple plant layers with random positions and seeds
`randomize_plant`	Add a random plant, optionally constrained by category or engine
`analyze_phyllotaxis`	Compute parastichy numbers, divergence angle, Fibonacci spirals
`explain_grammar`	Human-readable explanation of a preset's L-system grammar
`create_inflorescence`	Create flower clusters (bouquet, wreath, meadow, row, spiral)
`set_plant_style`	Set drawing style and detail level with jitter and ink flow
`suggest_plant_style`	Get ranked style recommendations for a preset
`set_plant_growth`	Set continuous growth time and 3D camera angle
`advance_plant_growth`	Advance growth time by step or to target value
`set_plant_wind`	Configure wind dynamics (direction, strength, gusts, turbulence)
`create_ecosystem`	Create multi-plant scene with depth and atmospheric perspective
`export_plant_paths`	Export preset as stroke paths for plugin-painting brush layers

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "plants:tree",
    "properties": {
      "seed": 137,
      "iterations": 5,
      "drawingStyle": "ink-sketch",
      "detailLevel": "detailed",
      "windStrength": 0.3,
      "windDirection": 270
    }
  }
}

Plants

On this page