Table of Contents

Weight Blend Node

  • Category: General
  • Edition: All editions
  • Output type: 2 to 100 masks
  • Typical place in a graph: between the texturing masks and the Texture Output nodes

Weight Blend turns a stack of texturing masks into layer weights that always add up to 1, the way painting textures by hand works: each layer is painted over the ones below it. Leave Layer 0 empty and it becomes the base that covers everything; each next layer covers what is under it wherever its mask is bright. Send each output to its Texture Output, and the terrain never turns dark or washed out from weights that do not add up.

Three layers packed into one image: base in red, low ground in green, steep slopes in blue on top

When to use it

  • Every texturing setup with more than one layer: grass, sand, rock, snow, each from its own mask.
  • Decide which texture wins where masks overlap: the higher layer.
  • Not for: blending heights (use Combine); color maps (use Color Blend).

Inputs

Slot Type Required What to connect
Layer 0 Mask No The base layer. Leave it empty to make it cover everything (it reads as 1).
Layer 1 to Layer N Mask No Each layer's mask: where it covers the layers below. Empty layers read as 0 and cover nothing.

Outputs

Slot Type What it holds
Layer 0 to Layer N Mask Each layer's final weight. At every spot the outputs add up to 1, as long as Layer 0 is full there.

Properties

Property Default Range What it does
Layer Count 4 2 to 100 The number of layers, and of inputs and outputs.

How the layers stack

Layers are painted in order, from Layer 0 up. Each layer takes its mask's share of the spot and pushes the layers below down by the same share, so the total stays the same. A higher layer always wins where its mask is full. Masks are cut to 0 to 1 first.

Put first what gets covered (soil, sediment), then what grows over it (grass, moss), and last what stands on top (rock on steep slopes, snow).

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. Relative To Main Input (default) matches the mask connected to Layer 0 (or the biome's Canvas Resolution when it is empty), times the multiplier below it. Relative To Graph follows the biome's Canvas Resolution instead. Absolute sets an exact size. 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. Each input passes straight to its matching output, without blending, so the weights no longer add up to 1.

Example

The image above packs the three outputs of a 3 layer Weight Blend with RGBA Merge: Layer 0 left empty (red), Layer 1 a Height Mask of the low ground (green), Layer 2 a Slope Mask of steep ground (blue). Steep ground is blue even where it is low, since the slope layer is on top; everything else is base. Measured average weights 0.27, 0.26 and 0.47: together exactly 1.

Recipes

  • Grass and rock: Layer 0 empty → grass; Slope Mask → Layer 1 → rock. See Texture Output.
  • Mountain set: soil base, sediment from erosion, grass by height and slope, rock by slope, snow by height on top. Recipe mountain-texturing-layers.
Tip

Leave Layer 0 empty. Connecting a mask there leaves spots where nothing is full, and the weights there add up to less than 1.

Performance

Very cheap: one quick GPU step per layer. Outputs that are not connected are skipped.

For AI agents

  • Type name: WeightBlendNode. Inputs Layer i = i; outputs Layer i = 100 + i (Masks).
  • Property: layerCount (2 to 100; not exposable).
  • Missing Layer 0 reads 1, other missing layers 0. Painting: for each layer i in order, weights below are lerped toward 0 by layer i's mask and layer i gets the mask's share; sum stays 1 when Layer 0 is full. Measured with 3 layers: means 0.269 + 0.263 + 0.469 = 1.0.