Locator

When defined in a FEATURE config, distributors determine what Y levels a structure can be placed at.

Locators iterate through each block within a column of blocks in the world (typically within a constrained Y level range defined by the specific locator), and return either true or false if structures should generate at that position or not.

Types

Different types of Locator provide different behaviours and may have additional parameters for configuring that behavior.

The type is specified by setting the type parameter to the name of the type. If the same name is used by two different addons, you can prefix the name with ADDON_NAME: to specify which one to use.

A list of available types for Locator are listed below:

---

SURFACE

^{*Type requires the ‘config-locators’ addon to use}

range Range

---

TOP

^{*Type requires the ‘config-locators’ addon to use}

range Range

---

RANDOM

^{*Type requires the ‘config-locators’ addon to use}

amount Range

height Range

salt Integer

Default: 0

---

GAUSSIAN_RANDOM

^{*Type requires the ‘config-locators’ addon to use}

amount Range

height Range

standard-deviation Float

salt Integer

Default: 0

---

PATTERN

^{*Type requires the ‘config-locators’ addon to use}

pattern Pattern

range Range

---

ADJACENT_PATTERN

^{*Type requires the ‘config-locators’ addon to use}

pattern Pattern

range Range

match-all Boolean

Default: false

---

SAMPLER

^{*Type requires the ‘config-locators’ addon to use}

samplers List<NoiseSampler>

---

SAMPLER_3D

^{*Type requires the ‘config-locators’ addon to use}

sampler NoiseSampler

---

AND

^{*Type requires the ‘config-locators’ addon to use}

locators List<Locator>

---

OR

^{*Type requires the ‘config-locators’ addon to use}

locators List<Locator>

---

XOR

^{*Type requires the ‘config-locators’ addon to use}

locators List<Locator>

Uses

Used by 4 parameters:

• In XOR in Locator:

  locators List<Locator>

• In base in FEATURE:

  locator Locator

• In AND in Locator:

  locators List<Locator>

• In OR in Locator:

  locators List<Locator>