Table of Contents

Object Output Node

  • Category: IO
  • Edition: All editions
  • Output type: Prefab instances on the terrain
  • Typical place in a graph: at the end of a spawning chain, after Scatter

Object Output places copies of a prefab on the terrain as separate GameObjects: rocks, boulders, ruins, logs, fences, buildings, anything that is not a terrain tree or grass. Give it positions, usually from Scatter, and an Object Template that says which prefab to use. Optional masks thin the objects out and vary their size and rotation. Use one Object Output per kind of object.

Boulders placed along a steep, rocky band of a grassy slope

When to use it

  • Rocks, boulders, stumps, logs, ruins, props: objects with their own colliders, scripts or LOD groups.
  • Objects that must follow the slope, with Align To Normal in the template.
  • Not for: trees that should render as terrain trees (use Tree Output, much cheaper in large numbers); grass and small plants (use Detail Density Output).

Inputs

Slot Type Required What to connect
Positions Positions Yes Where to place each object, usually Scatter. Points outside the biome are skipped. With nothing connected, nothing is placed.
Density Mask No Thins the objects out: its brightness, times Density Multiplier, is the chance each position keeps its object. Usually you shape density before Scatter instead.
Vertical Scale Mask No The height of each object, times Vertical Scale Multiplier. 1 is the prefab's own size.
Horizontal Scale Mask No The width and depth of each object, times Horizontal Scale Multiplier. Connect the same mask as Vertical Scale to resize evenly.
Rotation Y Mask No Turns each object around its vertical axis, between Min Rotation and Max Rotation. Without it, every object gets the same rotation.

Outputs

Slot Type What it holds
Output Positions The placed objects with their size and rotation. You rarely need it; the objects reach the scene without connecting anything here.

Properties

Property Default Range What it does
Object Template None An Object Template asset The object to place. An Object Template holds the prefab and whether it aligns to the slope (Align To Normal, with a Normal Alignment Error to vary the tilt). Create one with Assets > Create > Vista > Object Template. Without a template, nothing is placed.
Density Multiplier 1 0 and up Scales the chance that each position keeps its object. Without a Density mask, it is the chance alone.
Vertical Scale Multiplier 1 0 and up Object height relative to the prefab, times the Vertical Scale mask if connected.
Horizontal Scale Multiplier 1 0 and up Object width and depth relative to the prefab, 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.

How it works

When the biome generates, each terrain tile gets a child object named ~VistaSpawnerRoot, with one group per template (named ~ plus the template's name), and every placed object is spawned into it as a prefab instance. Objects sit on the terrain's surface at their position, with the prefab's own scale times the scale masks. The Vista Manager's Object Per Frame sets how many are spawned each frame, so large counts do not freeze the editor.

Example

Small rocks from the Vista samples, scaled up 5 times into boulders (Vertical Scale Multiplier and Horizontal Scale Multiplier 5), placed by Scatter (Spacing 30) on a Slope Mask of the steep ground. The grass is a Detail Density Output on the gentle ground. The image at the top of the page shows the result: the boulders follow the steep, rocky band, with a few strays where the slope mask fades out.

Recipes

  • Boulders on rocky slopes: Slope Mask (steep) → Scatter → Object Output, with a Noise on both scale inputs for varied sizes.
  • Varied rotation: a Noise with a small Scale → Rotation Y, Min Rotation -180, Max Rotation 180.
  • No grass under the rocks: the same positions → Dots → Expand → invert → multiply into the grass mask.
Warning

Every generation deletes ~VistaSpawnerRoot and spawns everything again. Changes you make by hand to spawned objects are lost on the next generation. Place hand made objects outside that root.

Note

An Object Template has a Variants list, but Object Output currently places only the main Prefab. For several kinds of object, use several Object Output nodes.

Note

Without a Rotation Y mask, all objects face the same way. Connect a fine Noise for natural variety.

Warning

Each object is a full GameObject. Thousands of them cost memory, generation time and rendering. Check how many points Scatter makes, and use Tree Output for vegetation in large numbers.

Performance

The node itself is a single quick GPU step. Spawning the GameObjects at the end of generation takes most of the time, spread over frames by Object Per Frame.

For AI agents

  • Type name: ObjectOutputNode. 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: objectTemplate (asset path), densityMultiplier, verticalScaleMultiplier, horizontalScaleMultiplier (≥ 0), minRotation, maxRotation, rotationMultiplier, seed.
  • Same per instance rules as TreeOutputNode (keep chance, scale, rotation). Spawned under <terrain>/~VistaSpawnerRoot/~<template name>; the root is destroyed and rebuilt on each generation. Only template.prefab is used; alignToNormal tilts to the terrain normal.
  • Not bypassable. Skipped without a valid template or when the biome's Data Mask excludes ObjectInstances.