Color Sampler Configuration

A color sampler is a config defined function that assigns a color for every XZ coordinate pair. Color samplers are typically used to distribute things across the entire world by utilizing color data, for example using a heightmap to shape terrain, or an image to draw where biomes should go.

Color samplers differ from Image Configuration s in that they can provide colors for any XZ coordinate, whereas Image s only work with a set size.

Color Sampler Categories

Generative Color Samplers

Color samplers that provide color data.

Image Color Samplers

Color samplers that source color data from image(s).

Mutator Color Samplers

Color samplers that take other samplers as inputs and manipulate their outputs in some way.

Color Sampler Types

COLOR

Provides the same color for any input.

color Color The color to output.

SINGLE_IMAGE

Outputs the pixels of an Image, colors for coordinates outside the bounds of the image are provided by a ‘fallback’ color sampler, which typically will be the COLOR type.

image Image

align String

Default: NONE

Alignment Types

  • NONE No coordinate offset, world coordinates match the image coordinates. The top left of images is considered (0,0).

  • CENTER Offsets the image such that the center of the image will be at (0,0).

outside-sampler ColorSampler The sampler that provides colors for coordinates outside the bounds of the Image .

TILED_IMAGE

Outputs a repeating grid of pixels sourced from the provided Image .

image Image

align String

Default: NONE

Alignment Types

  • NONE No coordinate offset, world coordinates match the image coordinates. The top left of images is considered (0,0).

  • CENTER Offsets the image such that the center of the image will be at (0,0).

ROTATE

color-sampler ColorSampler The color sampler to mutate.

angle Float

TRANSLATE

color-sampler ColorSampler The color sampler to mutate.

x Integer

y Integer