Minecraft:Block state provider: Difference between revisions

Revision as of 11:05, 20 September 2026

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_provider

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_provider
- 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.

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.

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.

History

Template:Info needed section Template:HistoryTable

Navigation

Template:Navbox Java Edition technical

Minecraft:fr:Génération du monde personnalisée/Fournisseur d'état de bloc Minecraft:ja:ブロック状態プロバイダー Minecraft:ko:블록 상태 제공자 Minecraft:pt:Geração de mundo personalizado/provedor de estado de bloco Minecraft:ru:Натуральные декорации/Провайдер состояний блока Minecraft:uk:Постачальник стану блока Minecraft:zh:方块状态提供器

@@ Line 21: / Line 21: @@
 </div>
-=== dual_noise_provider ===
+=== dual_noise ===
 Randomly chooses a block state according to two noise values.
 <div class="treeview">
@@ Line 43: / Line 43: @@
 </div>
-=== noise_provider ===
+=== noise ===
 Randomly chooses a block state according to a noise value.
 <div class="treeview">
@@ Line 56: / Line 56: @@
 </div>
-=== noise_threshold_provider ===
+=== noise_threshold ===
 Uses different block states when a noise value above or below the threshold.
 <div class="treeview">
@@ Line 76: / Line 76: @@
 </div>
-=== random_block_provider ===
+=== random_block ===
 Returns the default block state for a randomly chosen block.
 <div class="treeview">
@@ Line 85: / Line 85: @@
 </div>
-=== randomized_int_state_provider ===
+=== randomized_int ===
 Assigns a random value to an integer block property.
 <div class="treeview">
@@ Line 97: / Line 97: @@
 </div>
-=== rotated_block_provider ===
+=== rotated ===
 Randomly rotates any block with {{cd|axis}} or {{cd|facing}} properties.
 <div class="treeview">
@@ Line 107: / Line 107: @@
 </div>
-=== rule_based_state_provider ===
+=== rule_based ===
 Provides a block state depending on the current block(s) by matching a sequence of rules.
 <div class="treeview"><section begin="json format" />
@@ Line 122: / Line 122: @@
 </div>
-=== simple_state_provider ===
+=== simple ===
 Specifies a single block state directly
 <div class="treeview">
@@ Line 131: / Line 131: @@
 </div>
-=== weighted_state_provider ===
+=== weighted ===
 Chooses a block state from a weighted list.
 <div class="treeview">