Minecraft:Block predicate: Difference between revisions

Revision as of 11:06, 28 September 2026

A block predicate (also known as a placement condition) is a test for the state of a block at a given position in the world. They are used by placement modifiers in Minecraft:placed features, numerous Minecraft:configured features, and enchantments.

JSON Format

Block predicates are defined using the following format:

Template:Nbt: a block predicate<section begin="json format" />
- Template:Nbt: The type of the block predicate. See Template:Slink for options.
- additional fields depending on Template:Nbt. See Template:Slink.<section end="json format" />

Types

The following block predicate types exist:

all_of

Combined multiple block predicates. Matches if all specified block predicates match.

Template:Nbt: a block predicate
- Template:Nbt: all_of
- Template:Nbt: (Can be empty) The child predicates.
  - Template:Nbt: A block predicate.

any_of

Combined multiple block predicates. Matches if at least one of the specified block predicates matches.

Template:Nbt: a block predicate
- Template:Nbt: any_of
- Template:Nbt: (Can be empty) The child predicates.
  - Template:Nbt: A block predicate.

has_sturdy_face

Checks if the block at the specified offset has a full block supporting surface in the specified direction.

Template:Nbt: a block predicate
- Template:Nbt: has_sturdy_face
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
  - Template:Nbt: Value between -16 and 16 (inclusive).
- Template:Nbt: The direction of the block to check if it is sturdy.

height_range

Checks the height of the position against a given range.

Template:Nbt: a block predicate
- Template:Nbt: height_range
- Template:Nbt: Vertical anchor describing the minimum height required.
- Template:Nbt: Vertical anchor describing the maximum height required.

inside_world_bounds

Checks if the positions y-level (with specified offset) is within the height limits of the world.

Template:Nbt: a block predicate
- Template:Nbt: inside_world_bounds
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
  - Template:Nbt: Value between -16 and 16 (inclusive).

matching_biomes

Checks if the biome at the position is one of the specified biomes.

Template:Nbt: a block predicate
- Template:Nbt: matching_biomes
- Template:Nbt Template:Nbt: Template:Json ref that will match.

matching_block_tag

Checks if the block at the specified offset is in the given block tag.

Template:Nbt: a block predicate
- Template:Nbt: matching_block_tag
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
- Template:Nbt: The block tag without # to check for.

matching_blocks

Checks if the block at the specified offset is one of the specified blocks.

Template:Nbt: a block predicate
- Template:Nbt: matching_blocks
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
- Template:Nbt Template:Nbt: Template:Json ref that will match.

matching_fluids

Checks if the fluid at the specified offset is one of the specified fluid.

Template:Nbt: a block predicate
- Template:Nbt: matching_fluids
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
- Template:Nbt Template:Nbt: Template:Json ref that will match.

not

Inverts a given block predicate. Matches if the specified other block predicate does not match.

Template:Nbt: a block predicate
- Template:Nbt: not
- Template:Nbt: The block predicate to invert.

replaceable

Checks if the block at the specified offset can be replaced by placing blocks.

Template:Nbt: a block predicate
- Template:Nbt: replaceable
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
  - Template:Nbt: Value between -16 and 16 (inclusive).

solid

Checks if the block at the specified offset is solid.

Template:Nbt: a block predicate
- Template:Nbt: solid
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
  - Template:Nbt: Value between -16 and 16 (inclusive).

true

Always matches, independent of the block.

Template:Nbt: a block predicate
- Template:Nbt: true

unobstructed

Checks if the position (with the specified offset) is unobstructed (no block collision).

Template:Nbt: a block predicate
- Template:Nbt: unobstructed
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.

volume_match

Checks that every block within a volume, defined by minimum and maximum offsets, matches the given block predicate.

Template:Nbt: a block predicate
- Template:Nbt: volume_match
- Template:Nbt: A list of 3 integers specifying the minimum [X, Y, Z] offset of the volume.
  - Template:Nbt: Value between -16 and 16 (inclusive).
- Template:Nbt: A list of 3 integers specifying the maximum [X, Y, Z] offset of the volume.
  - Template:Nbt: Value between -16 and 16 (inclusive).
- Template:Nbt: The block predicate that must match at every position in the volume.

would_survive

Checks if a specified Minecraft:block state is a valid placement at the given offset.

Template:Nbt: a block predicate
- Template:Nbt: would_survive
- Template:Nbt: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
  - Template:Nbt: Value between -16 and 16 (inclusive).
- Template:Nbt: The blockstate to test.
  - Template:Nbt inherit/block state

History

Template:Info needed section Template:HistoryTable

Navigation

Template:Navbox Java Edition technical

Minecraft:de:Block-Prädikate Minecraft:fr:Génération du monde personnalisée/Prédicat de bloc Minecraft:ja:ワールド生成のカスタマイズ/block predicate Minecraft:pt:Geração de mundo personalizado/predicado de bloco Minecraft:zh:编码格式/Worldgen#方块谓词

@@ Line 60: / Line 60: @@
 ** {{nbt|list|offset}}: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
 *** {{nbt|int}}: Value between -16 and 16 (inclusive).
+</div>
+=== matching_biomes ===
+Checks if the biome at the position is one of the specified biomes.
+<div class="treeview">
+* {{nbt|compound}}: a block predicate
+** {{nbt|string|type}}: <code>matching_biomes</code>
+** {{nbt|string}}{{nbt|list|biomes}}: {{json_ref|biome|tag=1|tag_link=biome tag (Java Edition)}} that will match.
 </div>
@@ Line 122: / Line 130: @@
 * {{nbt|compound}}: a block predicate
 ** {{nbt|string|type}}: <code>true</code>
+</div>
+=== unobstructed ===
+Checks if the position (with the specified offset) is unobstructed (no block collision).
+<div class="treeview">
+* {{nbt|compound}}: a block predicate
+** {{nbt|string|type}}: <code>unobstructed</code>
+** {{nbt|list|offset}}: (optional, defaults to [0,0,0]) A list of 3 integers specifying an [X, Y, Z] block position offset to check.
+</div>
+=== volume_match ===
+Checks that every block within a volume, defined by minimum and maximum offsets, matches the given block predicate.
+<div class="treeview">
+* {{nbt|compound}}: a block predicate
+** {{nbt|string|type}}: <code>volume_match</code>
+** {{nbt|list|min}}: A list of 3 integers specifying the minimum [X, Y, Z] offset of the volume.
+*** {{nbt|int}}: Value between -16 and 16 (inclusive).
+** {{nbt|list|max}}: A list of 3 integers specifying the maximum [X, Y, Z] offset of the volume.
+*** {{nbt|int}}: Value between -16 and 16 (inclusive).
+** {{nbt|compound|match}}: The block predicate that must match at every position in the volume.
 </div>