Minecraft:Block state provider

Template:Exclusive A block state provider is used to provide a (potentially randomized) Minecraft:block and Minecraft:block state to be placed by Minecraft:configured features.

JSON format

Block state providers are defined using the following format:

• Template:Nbt: A block state provider<section begin="json format" />
  • Template:Nbt: The type of the block state provider, see Template:Slink for option.
  • Additional fields based on Template:Nbt, see Template:Slink.<section end="json format" />

Types

The following block state provider types exist.

copy_properties

Copies common block state properties from the block at the evaluated position to the resulting state.

• Template:Nbt: A block state provider
  • Template:Nbt: copy_properties
  • Template:Nbt: Provides the block state which the copied properties are copied on top of. Only properties common between both the source and the target blocks will be copied
    • Template:Nbt: block id
    • Template:Nbt: block properties

dual_noise

Randomly chooses a block state according to two noise values.

• Template:Nbt: A block state provider
  • Template:Nbt: dual_noise
  • Template:Nbt: The seed of the noise.
  • Template:Nbt: A noise.
  • Template:Nbt: Horizontal scale of noise. Must be a positive value.
  • Template:Nbt: The noise used for the first selection.
  • Template:Nbt: Horizontal scale of the slow noise. Must be a positive value.
  • Template:Nbt: The number of block states that selected out by slow noise.
    • Template:Nbt: The min number of block states after selection by slow noise. Must be an integer equal to or greater than 1.
    • Template:Nbt: The max number of block states after selection by slow noise. Must be an integer equal to or less than 64, and must be greater than Template:Nbt.
  • Template:Nbt: Shorthand version of Template:Nbt.
    • Template:Nbt: Min number. Must be an integer equal to or greater than 1.
    • Template:Nbt: Max number. Must be an integer equal to or less than 64, and must be greater than the min number.
  • Template:Nbt: Shorthand version of Template:Nbt when the min equals to the max. Value between 1 and 64 (both inclusive).
  • Template:Nbt: List of block states to choose from.
    • Template:Nbt: A block state.
      • Template:Nbt inherit/block state

noise

Randomly chooses a block state according to a noise value.

• Template:Nbt: A block state provider
  • Template:Nbt: noise
  • Template:Nbt: The seed of the noise.
  • Template:Nbt: A noise.
  • Template:Nbt: Horizontal scale of the noise. Must be a positive value.
  • Template:Nbt: (Cannot be empty) List of optional block states.
    • Template:Nbt: A block state.
      • Template:Nbt inherit/block state

noise_threshold

Uses different block states when a noise value above or below the threshold.

• Template:Nbt: A block state provider
  • Template:Nbt: noise_threshold
  • Template:Nbt: The seed of the noise.
  • Template:Nbt: A noise.
  • Template:Nbt: Horizontal scale of noise. Must be a positive value.
  • Template:Nbt: Value between -1.0 and 1.0 (inclusive). The threshold of the noise value. If the noise value is lower than this value, the block states in Template:Cd will be selected.
  • Template:Nbt: Value between 0.0 and 1.0 (inclusive). If the noise value is higher than the threshold, the block states in Template:Cd will be selected with a probability of high_chance.
  • Template:Nbt: Default block state. These block states is used when the noise value is higher than Template:Cd but high_states is not selected according to high_chance.
    • Template:Nbt inherit/block state
  • Template:Nbt: (Cannot be empty) List of block states to choose from when lower than threshold.
    • Template:Nbt: A block state.
      • Template:Nbt inherit/block state
  • Template:Nbt: (Cannot be empty) List of block states to choose from when higher than threshold.
    • Template:Nbt: A block state.
      • Template:Nbt inherit/block state

random_block

Returns the default block state for a randomly chosen block.

• Template:Nbt: A block state provider
  • Template:Nbt: random_block
  • Template:NbtTemplate:NbtTemplate:Nbt: Template:Json ref; Cannot be empty — Blocks to choose from.
    • Template:Nbt inherit/block state

randomized_int

Assigns a random value to an integer block property.

• Template:Nbt: A block state provider
  • Template:Nbt: randomized_int
  • Template:Nbt: The name of a block property.
  • Template:NbtTemplate:Nbt: The value of the block property.
    • Template:Nbt inherit/int provider
  • Template:Nbt: Another block state provider that specifies the source of the block state.
    • Template:Nbt inherit/block state provider

rotated

Randomly rotates any block with Template:Cd or Template:Cd properties.

• Template:Nbt: A block state provider
  • Template:Nbt: rotated
  • Template:Nbt: A block state provider
  • Template:Nbt: Optional. Describes the direction to set. If omitted, a random direction is chosen.
    • Template:Nbt inherit/block state

rule_based

Provides a block state depending on the current block(s) by matching a sequence of rules.

<section begin="json format" />

• Template:Nbt: A block state provider
  • Template:Nbt: rule_based
  • Template:Nbt The block to use when no rules' predicates match. This field is optional. If unspecified and no rules' predicates match, then no block is placed.
    • Template:Nbt inherit/block state provider
  • Template:Nbt (Required, but can be empty) Rules of the block to use.
    • Template:Nbt One rule.
      • Template:Nbt The Minecraft:block predicate of this rule.
        • Template:List indent
      • Template:Nbt The block to use when the predicate is passed.
        • Template:Nbt inherit/block state provider<section end="json format" />

simple

Specifies a single block state directly

• Template:Nbt: A block state provider
  • Template:Nbt: simple
  • Template:Nbt: The block state to use.
    • Template:Nbt inherit/block state

weighted

Chooses a block state from a weighted list.

• Template:Nbt: A block state provider
  • Template:Nbt: weighted
  • Template:Nbt: (Cannot be empty) A weighted list of block state entries.
    • Template:Nbt A block state and its corresponding weight.
      • Template:Nbt: The block state to use.
        • Template:Nbt inherit/block state
      • Template:Nbt: The weight of this entry.