Table of Contents

Crater Node

  • Category: Generators
  • Edition: All editions
  • Output type: Height (signed) and four masks
  • Typical place in a graph: the first node of a crater biome, followed by erosion and texturing

Crater builds a complete impact crater in one node: a raised rim, a bowl that digs below the surrounding ground, terraces stepping down the inner wall, and a small rise in the middle of the floor. The outline is gently bent so it never looks like a perfect circle, and a light surface roughness gives erosion something to work on. It is fast, with no simulation. Four extra outputs mark the rim, the inner wall, the floor and the outer slope for texturing.

Crater with a raised rim, two terraces on the inner wall and a central rise

When to use it

  • A meteor or impact crater, a caldera, a sinkhole or a quarry pit as the main landform of a biome.
  • A field of craters, as a stamp for Splatter 2 (recipe moon-surface).
  • Masks for texturing a crater: bare rock on the rim, rubble on the wall, sediment or a lake on the floor, ejecta outside.
  • Not for: a volcano with a cone and a vent (use Volcano); a plain round pit or ring without the crater details (use Shape Torus or Radial Gradient).

Inputs

None.

Outputs

Slot Type What it holds
Height Mask (signed) The crater's height relative to the surrounding ground: above 0 for the rim and outer slope, below 0 for the bowl. It only digs into the ground when the biome's Blending > Height Map is set to Raise (see the warning below).
Rim Mask A band over the crest of the rim, for exposed rock or scorched ground.
Wall Mask The inner wall with its terraces, from the rim down to the floor, for rock or rubble.
Floor Mask The floor of the bowl, including the central rise, for sediment, lava or a lake.
Outer Slope Mask The slope outside the rim down to the foot, for ejecta and debris. Nothing beyond the foot.

The masks follow the bent outline and scale with Rim Size. Masks that nothing reads are not drawn, so they cost nothing unless connected.

Properties

Property Default Range What it does
Seed Random Any integer Changes how the outline bends and the surface roughness. It is combined with the biome's seed.
Rim Height 80 0 and up, meters Height of the rim above the surrounding ground.
Floor Depth 140 0 and up, meters Depth of the floor below the surrounding ground. It digs in only with the biome's height blend set to Raise.
Size 0.95 0.1 to 1 Diameter of the foot (where the outer slope meets the ground), as a fraction of the biome width.
Rim Size 0.574 0.1 to 0.9 Diameter of the rim, as a fraction of the foot. Smaller values make a smaller bowl on a broad mound; larger values make a wide bowl with a short outer slope.
Terrace Count 2 0 to 2 Number of terrace steps on the inner wall. 0 gives a smooth bowl.
Central Rise 0.28 0 to 1 Height of the mound in the middle of the floor, as a fraction of Floor Depth.
Roughness 15 0 and up, meters Height of a noise on the surface. It makes the crater look natural and, more importantly, gives erosion something to work on: a perfectly smooth surface erodes in regular, comb like patterns.
Irregularity 0.082 0 to 1 How far the outline bends away from a circle, as a fraction of the biome width. Higher values need a smaller Size to keep the crater inside the biome.

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.
Resolution How detailed this node's result is, in texels across the biome. Crater has no input, so Relative To Main Input (default) and Relative To Graph both follow the biome's Canvas Resolution, times the multiplier below. Absolute sets an exact size. The terrace edges and roughness need enough resolution to stay crisp. Absolute is limited to 32 to 512 in Vista Personal and 32 to 4096 in Vista Indie and Pro.
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.
Bypass Skips the node. It has no input to pass through, so nothing comes out, and the nodes after it receive empty, flat ground.

Examples

All examples show the Height output as terrain in the graph editor's 3D viewport, on a 1024 × 1024 m biome with a terrain height of 400 m. Seed 128; values not listed are the defaults. The default heights are meant for a biome of about 2 km, so on this 1 km biome the walls are steeper than they would be in a real crater biome.

Default settings

Crater with rim, two terraces and a small central rise

A raised rim, two terraces stepping down the inner wall, a floor 140 m below the ground with a small rise in the middle, and a rough outer slope.

Variations

No terraces Strong central rise
Smooth bowl without terraces Tall central peak
Terrace Count 0: a smooth bowl. Central Rise 0.8: a tall central peak, as in large impact craters.
Irregular outline No roughness
Crater with a strongly bent, broken outline Perfectly smooth crater surfaces
Irregularity 0.3 and Size 0.75: an older, broken looking crater. Roughness 0: clean, smooth surfaces. Erosion on these makes regular patterns, so keep some roughness.

Texturing masks

Masks in color: outer slope green, rim red, wall orange, floor blue

The four masks together: Outer Slope (green), Rim (red), Wall (orange) and Floor (blue). They meet without gaps, so they can be used directly as weights for four texture layers.

Rim Wall Floor Outer Slope
Rim mask: a thin ring Wall mask: a thick ring Floor mask: the middle Outer slope mask: a wide ring

Recipes

  • Crater biome: Crater → Hydraulic Erosion 2 → Height Output, with the biome's height blend set to Raise and the surrounding ground higher than Floor Depth. The AI workflow recipe crater-base-shape explains this route and the alternative built from basic nodes.
  • Crater texturing: Rim → bare rock layer, Wall → rubble layer, Floor → sediment layer, Outer Slope → ejecta layer, all in Weight Blend or as weights of Texture Output nodes.
  • Field of craters: Crater Height as the stamp of Splatter 2, fed by Scatter with Spread Count 0. Recipe moon-surface.
Warning

Height is signed. Set the biome's Blending > Height Map to Raise so the bowl digs into the ground below it. The bowl can only go as deep as the ground allows: on ground lower than Floor Depth, it bottoms out at the terrain's floor. Raise the ground or lower Floor Depth.

Note

The heights are in meters and do not change with the biome size, while the outline does. The defaults suit a biome of about 2 km; on a much smaller biome, lower Rim Height, Floor Depth and Roughness together, or the walls get very steep.

Note

Roughness adds to the heights, so the deepest and highest points go a little past Floor Depth and Rim Height (about 150 m instead of 140 m at the defaults).

Tip

In the 2D viewport the crater looks almost black, because most of it is at or below 0. Check it in the 3D viewport, or look at its masks.

Performance

Fast: two noise passes for the outline and roughness and one pass per output, all on the GPU. Masks that nothing reads are skipped.

For AI agents

  • Type name: CraterNode. Outputs: Height = 100 (signed), Rim = 101, Wall = 102, Floor = 103, Outer Slope = 104. No inputs.
  • Properties: seed (random on creation), rimHeight, floorDepth, roughness (meters), size (0.1 to 1), rimSize (0.1 to 0.9), terraceCount (0 to 2), centralRise (0 to 1), irregularity (0 to 1).
  • Measured at the defaults on a 400 m terrain: Height from about -0.38 to 0.21 (-153 m to +85 m).
  • Biome setting: vista_lpb_settings_set --settings '{"blendOptions":{"heightMapBlendMode":"Raise"}}'.
  • Preview a mask without connecting it: vista_graphitor_capture --target viewport2d --slot 102.