Table of Contents

Detail Instance Output Node

  • Category: IO
  • Edition: All editions
  • Output type: Grass and small plants on Polaris terrain
  • Typical place in a graph: at the end of a spawning chain, after Scatter

Detail Instance Output places grass and small plants on a Polaris terrain, one plant per position. Give it positions, usually a dense Scatter, and a Detail Template; optional masks thin the plants out and vary their size and rotation. Unity terrain does not use it: Unity terrain grass comes from Detail Density Output.

When to use it

Inputs

Slot Type Required What to connect
Positions Positions Yes Where to place each plant, usually a dense Scatter. Points outside the biome are skipped. With nothing connected, no plants.
Density Mask No Thins the plants out: its brightness, times Density Multiplier, is the chance each position keeps its plant.
Vertical Scale Mask No The height of each plant, times Vertical Scale Multiplier.
Horizontal Scale Mask No The width of each plant, times Horizontal Scale Multiplier.
Rotation Y Mask No Turns each plant around its vertical axis, between Min Rotation and Max Rotation.

Outputs

Slot Type What it holds
Output Positions The placed plants with their size and rotation. You rarely need it.

Properties

Property Default Range What it does
Detail Template None A Detail Template asset The grass or plant to place. Create one with Assets > Create > Vista > Detail Template. Without a template, nothing is placed.
Density Multiplier 1 0 and up Scales the chance that each position keeps its plant.
Vertical Scale Multiplier 1 0 and up Plant height, times the Vertical Scale mask if connected.
Horizontal Scale Multiplier 1 0 and up Plant width, times the Horizontal Scale mask if connected.
Min Rotation, Max Rotation -360, 360 -360 to 360 The rotation range, picked by the Rotation Y mask.
Rotation Multiplier 1 0 and up Scales the Rotation Y mask before it picks a rotation.
Seed 0 Any integer Changes which positions the Density mask removes. It is combined with the biome's seed.

Common properties

Property What it does
Id The node's unique name in this graph, shown for reference. You cannot edit it. Scripts and the AI workflow CLI use it to find the node.
Split Execution Lets this node run over several frames so the editor stays responsive during long generations. It only works when Allow Split Execution is on in the graph settings. This node finishes in one step, so splitting only adds a short pause around it; leave it off.

Output nodes cannot be bypassed.

Recipes

  • Grass on Polaris: grass mask → Scatter (small Spacing, a few meters) → Detail Instance Output.
  • One graph for both terrain systems: the same grass mask → Detail Density Output, and → Scatter → Detail Instance Output, both with the same Detail Template. Each terrain system uses the one it supports.
Note

Unity terrain ignores this output; on a Unity terrain nothing is placed. Use Detail Density Output there.

Warning

Grass needs many positions. Check the point count of the Scatter before generating a large biome, and keep Spacing as large as the look allows.

Performance

The node is a single quick GPU step. The cost is in the number of positions and the plants rendered.

For AI agents

  • Type name: DetailInstanceOutputNode. Slot ids: Positions = 0 (Buffer), Density = 1, Vertical Scale = 2, Horizontal Scale = 3, Rotation Y = 4 (Masks); Output = 100 (Buffer).
  • Properties for vista_graphitor_node_set: detailTemplate (asset path), densityMultiplier, verticalScaleMultiplier, horizontalScaleMultiplier, minRotation, maxRotation, rotationMultiplier, seed. Same per instance rules as TreeOutputNode.
  • Not bypassable. Skipped without a valid template or when the biome's Data Mask excludes DetailInstances. Unity terrain has no detail instance populator; Polaris only.