genart.dev
Plugins

Terrain

Landscape composition — sky, mountains, water, vegetation, and 12 scene recipes.

Landscape composition with 21 layer types for building complete scenes. Includes depth-lane coordination, atmospheric perspective modes, and 12 one-shot scene recipe tools.

Installation

npm install @genart-dev/plugin-terrain

Layer Types

Type IDDisplay NameDescription
terrain:skySkySky gradient with time-of-day presets
terrain:profileTerrain ProfileRidgeline silhouettes with depth-aware coloring
terrain:cloudsCloudsNoise-driven cloud formations (cumulus, stratus, cirrus)
terrain:waterWater SurfaceWater gradient with wave lines and shimmer
terrain:riverRiverPerspective river with tapering and banks
terrain:pathPathTrails, roads, walkways with perspective tapering
terrain:shoreShoreBeach/shoreline transitions with foam and debris
terrain:fieldFieldVegetation layers (grass, wheat, wildflowers)
terrain:rockRockBoulder formations with varied textures
terrain:treelineTreelineForest silhouettes with canopy styles
terrain:celestialCelestialSun, moon, stars with glow halos
terrain:fogFog LayerAtmospheric fog bands with variable opacity
terrain:starfieldStarfieldScattered stars with optional Milky Way band
terrain:cliff-faceCliff FaceRock wall formations with texture modes
terrain:snowfieldSnowfieldSnow coverage with drift patterns and sparkle
terrain:buildingBuildingArchitecture silhouettes with roof/body colors
terrain:bridgeBridgeStructures (stone arch, wooden, suspension)
terrain:reflectionReflectionWater reflections with ripple distortion
terrain:hazeHazeAtmospheric haze bands
terrain:fenceFenceFencing and walls with post spacing and sag
terrain:boatBoatVessels with scale, tilt, and hull/sail colors

Properties

terrain:sky

PropertyTypeDefaultDescription
presetselect"noon"Time of day: dawn, noon, golden-hour, dusk, night
zenithColorcolorTop sky color
horizonColorcolorBottom sky color
hazeColorcolorHaze band color
hazeIntensitynumberHaze opacity (0–1)
hazePositionnumberVertical haze center (0–1)
horizonLinenumberHorizon position (0.3–1.0)
depthLaneselectDepth lane placement

terrain:profile

PropertyTypeDefaultDescription
presetselectalpine-range, rolling-hills, mesa-plateau, coastal-cliffs, sand-dunes, foothills
seednumber42Random seed (0–99999)
terrainTypeselectmountains, hills, plains
ridgeCountnumberNumber of ridges (1–20)
roughnessnumberSurface roughness (0–1)
elevationMinnumberMinimum elevation (0–1)
elevationMaxnumberMaximum elevation (0–1)
renderStyleselectsolid, contour, hatched
contourCountnumberContour lines (4–60)
baseEdgeselectflat, natural, jagged, waterline
foregroundColorcolorNearest ridge color
backgroundRidgeColorcolorFarthest ridge color
depthEasingselectlinear, quadratic, cubic, exponential
atmosphericModeselectnone, western, ink-wash
depthLaneselectDepth lane placement

terrain:clouds

PropertyTypeDefaultDescription
presetselectfair-weather, overcast, wispy-high, storm-clouds, scattered
seednumber42Random seed
coveragenumberCloud coverage (0–1)
cloudTypeselectcumulus, stratus, cirrus
scalenumberNoise scale (1–10)
windDirectionnumberDrift direction (−45 to 45°)
cloudColorcolorCloud body color
shadowColorcolorCloud shadow color
softnessnumberEdge softness (0.1–1.0)
depthLaneselectDepth lane placement

terrain:treeline

PropertyTypeDefaultDescription
presetselectdeciduous-canopy, conifer-ridge, autumn-treeline, misty-forest, palm-fringe, winter-bare
seednumber42Random seed
canopyStyleselectrounded, pointed, fan, bare
colorcolorFoliage color
highlightColorcolorHighlight color
shadowColorcolorShadow color
densitynumberCanopy fill (0.2–1.0)
heightnumberTreeline height as canvas fraction (0.05–0.4)
irregularitynumberTop edge irregularity (0–1)
atmosphericModeselectnone, western, ink-wash
depthLaneselectDepth lane placement

terrain:water

PropertyTypeDefaultDescription
presetselectstill-lake, choppy-sea, mountain-stream, river, pond
seednumber42Random seed
waterlinePositionnumberWater surface position (0.1–0.95)
rippleFrequencynumberWave frequency (1–40)
rippleAmplitudenumberWave height (0–5)
waterColorcolorWater color
depthDarkeningnumberBottom darkening (0–1)
shimmerIntensitynumberHighlight shimmer (0–1)
depthLaneselectDepth lane placement

MCP Tools

Single Layer Tools

ToolDescription
add_skyAdd sky gradient with time-of-day presets
add_terrain_profileAdd ridgeline silhouettes with depth-aware coloring
add_cloudsAdd cloud formations (cumulus, stratus, cirrus)
add_water_surfaceAdd water surface with gradient, waves, shimmer
add_riverAdd perspective river with tapering and banks
add_pathAdd trails/roads with perspective tapering
add_shoreAdd beach/shoreline with foam and debris
add_fieldAdd vegetation (grass, wheat, wildflowers)
add_rockAdd boulder formations with varied textures
add_treelineAdd forest silhouettes with canopy styles
add_celestialAdd sun/moon/stars with glow halos
add_fog_layerAdd atmospheric fog bands
add_starfieldAdd scattered stars with optional Milky Way
add_cliff_faceAdd rock wall formations
add_snowfieldAdd snow coverage with drift patterns
add_buildingAdd architecture silhouettes
add_bridgeAdd bridge structures (stone, wooden, suspension)
add_reflectionAdd water reflections with ripple distortion
add_hazeAdd atmospheric haze bands
add_fenceAdd fencing/walls with post spacing
add_boatAdd vessels with hull/sail options

Composition Tool

ToolDescription
create_landscapeCreate complete landscape with auto-assigned depth lanes

Scene Recipes

ToolDescription
create_mountain_valleyAlpine ridges + valley fog + treeline + meadow
create_river_sceneRolling hills + river + shore + treeline + reflection
create_coastal_moonlightNight sky + starfield + moon + water + rocky shore
create_park_riversideGentle hills + river + path + treeline + building
create_shan_shuiChinese mountain-water landscape
create_pastoralCountryside: hills + wheat + lane + fence + farmhouse
create_forest_clearingTreeline + ferns + ground fog + woodland trail
create_alpine_lakeAlpine range + snow + calm water + cliff + mist
create_japanese_gardenCalm water + stone bridge + rock + treeline
create_desert_expanseMesa plateau + cliff + dry scrub + heat haze
create_winter_woodlandHills + snow + conifers + morning mist
create_tropical_coastCalm sea + sandy beach + sailboat + golden haze

Configuration Tools

ToolDescription
set_time_of_dayUpdate sky layer to time-of-day preset
list_terrain_presetsList presets filtered by category
set_terrain_depthAdjust depth properties on a terrain profile
set_depth_laneSet depth lane using named slots (sky→overlay)

Example

{
  "tool": "create_landscape",
  "arguments": {
    "sky": "golden-hour",
    "terrain": "rolling-hills",
    "clouds": "scattered",
    "water": "still-lake"
  }
}