Minecraft:Predicate - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-04T11:17:13Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:17, 4 October 2026
Line 274:		Line 274:
	\|{{HistoryLine\|\|26.3\|dev=pre1\|[[Minecraft:Number provider]]s were split into {{cd\|context_int_provider}} and {{cd\|context_float_provider}} registries:		\|{{HistoryLine\|\|26.3\|dev=pre1\|[[Minecraft:Number provider]]s were split into {{cd\|context_int_provider}} and {{cd\|context_float_provider}} registries:
	* Fields for condition types {{cd\|entity_scores}}, {{cd\|random_chance}} and {{cd\|time_check}} now call for a specific type of number provider and allow them in more places.		* Fields for condition types {{cd\|entity_scores}}, {{cd\|random_chance}} and {{cd\|time_check}} now call for a specific type of number provider and allow them in more places.
	* Removed {{cd\|value_check}} condition type, now split into {{cd\|int_value_check}} and {{cd\|float_value_check}}.		* Removed {{cd\|value_check}} condition type, now split into {{cd\|int_value_check}} and {{cd\|float_value_check}}.}}
	}}		\|{{HistoryLine\|java upcoming}}
			\|{{HistoryLine\|\|26.4\|dev=snap2\|Added {{cd\|below_heightmap}}.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-10-02T11:14:24Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 2 October 2026
Line 271:		Line 271:
	\|Removed the {{cd\|reference}} condition type.		\|Removed the {{cd\|reference}} condition type.
	\|Removed the {{cd\|block_state_property}} condition type. It has been fully replaced by {{cd\|match_block}}.		\|Removed the {{cd\|block_state_property}} condition type. It has been fully replaced by {{cd\|match_block}}.
			}}
			\|{{HistoryLine\|\|26.3\|dev=pre1\|[[Minecraft:Number provider]]s were split into {{cd\|context_int_provider}} and {{cd\|context_float_provider}} registries:
			* Fields for condition types {{cd\|entity_scores}}, {{cd\|random_chance}} and {{cd\|time_check}} now call for a specific type of number provider and allow them in more places.
			* Removed {{cd\|value_check}} condition type, now split into {{cd\|int_value_check}} and {{cd\|float_value_check}}.
	}}		}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-09-27T11:15:23Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-22T11:11:59Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 22 September 2026
Line 121:		Line 121:
	*** {{nbt\|float}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The minimum value.		*** {{nbt\|float}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The minimum value.
	*** {{nbt\|float}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The maximum value.		*** {{nbt\|float}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The maximum value.
	** {{nbt\|float\|test}}: Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|float}}{{nbt\|compound\|value}} against a single float only~~. Number providers cannot be used in this shorthand form~~.		** {{nbt\|float}}{{nbt\|compound\|test}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|float}}{{nbt\|compound\|value}} against a single float only.
	</div>		</div>

Line 130:		Line 130:
	*** {{nbt\|int}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The minimum value.		*** {{nbt\|int}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The minimum value.
	*** {{nbt\|int}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The maximum value.		*** {{nbt\|int}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The maximum value.
	** {{nbt\|int\|test}}: Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single int only~~. Number providers cannot be used in this shorthand form~~.		** {{nbt\|int}}{{nbt\|compound\|test}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single int only.
	</div>		</div>

SyncBot: Sync: updated from Minecraft

2026-09-21T11:14:41Z

Sync: updated from Minecraft

@@ Line 113: / Line 113: @@
 **** {{nbt|int}}{{nbt|compound|max}}: An inline value or a namespaced ID of a {{cd|minecraft:number_provider}} type. Maximum score. Optional.
 *** {{nbt|int|A score}}: Shorthand version of the other syntax above, to check the score against a single number only. Key name is the objective while the value is the required score.
 </div>
@@ Line 178: / Line 196: @@
 ** {{nbt|int|value}}: Shorthand version of {{nbt|compound|value}} above, used to check for a single value only. Number providers cannot be used in this shorthand form.
 ** {{nbt|int|period}}: If present, the day time is first reduced modulo the given number before being checked against {{nbt|compound}}{{nbt|int|value}}. For example, setting this to 24000 causes the checked time to be equal to the current daytime.
 </div>

SyncBot: Sync: updated from Minecraft

2026-09-18T11:25:34Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:25, 18 September 2026
Line 37:		Line 37:
	=== Example 1: Check if player is holding a diamond sword ===		=== Example 1: Check if player is holding a diamond sword ===
	<pre>{		<pre>{
	"~~condition~~": "minecraft:entity_properties",		"type": "minecraft:entity_properties",
	"entity": "this",		"entity": "this",
	"predicate": {		"predicate": {
Line 50:		Line 50:
	=== Example 2: Only run if it’s daytime ===		=== Example 2: Only run if it’s daytime ===
	<pre>{		<pre>{
	"~~condition~~": "minecraft:time_check",		"type": "minecraft:time_check",
	"value": { "min": 0, "max": 12000 },		"value": { "min": 0, "max": 12000 },
	"period": 24000		"period": 24000
Line 57:		Line 57:
	=== Example 3: Nested example using any_of ===		=== Example 3: Nested example using any_of ===
	<pre>{		<pre>{
	"~~condition~~": "minecraft:any_of",		"type": "minecraft:any_of",
	"terms": [		"terms": [
	{ "~~condition~~": "minecraft:random_chance", "chance": 0.25 },		{ "type": "minecraft:random_chance", "chance": 0.25 },
	{ "~~condition~~": "minecraft:weather_check", "raining": true }		{ "type": "minecraft:weather_check", "raining": true }
	]		]
	}</pre>These snippets can be placed inside {{cd\|data/{{ph\|namespace}}/predicate/}} within a data pack, then referenced using commands such as:<pre>/execute if predicate my_pack:daytime_check run say Good morning!</pre>		}</pre>These snippets can be placed inside {{cd\|data/{{ph\|namespace}}/predicate/}} within a data pack, then referenced using commands such as:<pre>/execute if predicate my_pack:daytime_check run say Good morning!</pre>

SyncBot: Sync: updated from Minecraft

2026-09-17T11:20:04Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:20, 17 September 2026
Line 69:		Line 69:
	<div class="treeview" style="margin-block-end: 1em;">		<div class="treeview" style="margin-block-end: 1em;">
	* {{nbt\|list}}{{nbt\|compound}}: The root element of the predicate.		* {{nbt\|list}}{{nbt\|compound}}: The root element of the predicate.
	** ~~{{nbt\|string\|condition}}{{until\|JE 26.3}} /~~ {{nbt\|string\|type}}: The [[Minecraft:resource location]] of the condition type to check.		** {{nbt\|string\|type}}: The [[Minecraft:resource location]] of the condition type to check.
	** Other parts of the predicate, specified below. In lists each element must evaluate to true for the predicate to pass.		** Other parts of the predicate, specified below. In lists each element must evaluate to true for the predicate to pass.
	</div>		</div>

	The possible values for {{nbt\|string\|~~condition~~}} and associated extra contents:		The possible values for {{nbt\|string\|type}} and associated extra contents:

	<div class="treeview" id="condition_all_of" style="margin-block-end: 1em;">		<div class="treeview" id="condition_all_of" style="margin-block-end: 1em;">
	* '''all_of''' — Evaluates a list of predicates and passes if all of them pass. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''all_of''' — Evaluates a list of predicates and passes if all of them pass. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|list\|terms}}: ~~The list of predicates to evaluate.{{until\|JE 26.3}} / an~~ inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.		** {{nbt\|list\|terms}}: An inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.
	*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively.		*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively.
	</div>		</div>
Line 83:		Line 83:
	<div class="treeview" id="condition_alternative" style="margin-block-end: 1em;">		<div class="treeview" id="condition_alternative" style="margin-block-end: 1em;">
	* '''any_of''' — Evaluates a list of predicates and passes if any one of them passes. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''any_of''' — Evaluates a list of predicates and passes if any one of them passes. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|list\|terms}}: ~~The list of predicates to evaluate.{{until\|JE 26.3}} / an~~ inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.		** {{nbt\|list\|terms}}: An inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.
	*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively. Note that ''any_of'' only applies to {{nbt\|list\|terms}}, nested lists are ''all_of''.		*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively. Note that ''any_of'' only applies to {{nbt\|list\|terms}}, nested lists are ''all_of''.
	~~</div>~~

	~~<div class="treeview" id="condition_block_state_property" style="margin-block-end: 1em;">~~
	* '''block_state_property'''{{until\|JE 26.3}} — Checks the mined block and its [[Minecraft:block states]]. Requires <b><span style="color:#00af89">block state</span></b> provided by [[Minecraft:loot context]], and always <b><span style="color:#d33">fails</span></b> if not provided.
	** {{nbt\|string\|block}}: A block ID. The test fails if the block doesn't match.
	** {{nbt\|compound\|properties}}: ''(Optional)'' A map of block state names to values. Errors if the block doesn't have these properties.
	*** {{nbt\|string\|''name''}}: A block state and an exact value. The value is a string.
	*** {{nbt\|compound\|''name''}}: A block state name and a ranged value to match.
	**** {{nbt\|string\|min}}: The min value.
	**** {{nbt\|string\|max}}: The max value.
	</div>		</div>

Line 120:		Line 110:
	** {{nbt\|compound\|scores}}: Scores to check. All specified scores must pass for the condition to pass.		** {{nbt\|compound\|scores}}: Scores to check. All specified scores must pass for the condition to pass.
	*** {{nbt\|compound\|A score}}: Key name is the objective while the value specifies a range of score values required for the condition to pass.		*** {{nbt\|compound\|A score}}: Key name is the objective while the value specifies a range of score values required for the condition to pass.
	**** {{nbt\|int}}{{nbt\|compound\|min}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Minimum score. Optional.		**** {{nbt\|int}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Minimum score. Optional.
	**** {{nbt\|int}}{{nbt\|compound\|max}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Maximum score. Optional.		**** {{nbt\|int}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Maximum score. Optional.
	*** {{nbt\|int\|A score}}: Shorthand version of the other syntax above, to check the score against a single number only. Key name is the objective while the value is the required score.		*** {{nbt\|int\|A score}}: Shorthand version of the other syntax above, to check the score against a single number only. Key name is the objective while the value is the required score.
	</div>		</div>
Line 127:		Line 117:
	<div class="treeview" id="condition_inverted" style="margin-block-end: 1em;">		<div class="treeview" id="condition_inverted" style="margin-block-end: 1em;">
	* '''inverted''' — Inverts another predicate condition. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''inverted''' — Inverts another predicate condition. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|compound\|term}}: ~~The condition to be negated, following the same structure as outlined here, recursively.{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:predicate}} type.		** {{nbt\|compound\|term}}: An inline value or a namespaced ID of a {{cd\|minecraft:predicate}} type.
	</div>		</div>

Line 160:		Line 150:
	<div class="treeview" id="condition_random_chance" style="margin-block-end: 1em;">		<div class="treeview" id="condition_random_chance" style="margin-block-end: 1em;">
	* '''random_chance''' — Generates a random number between 0.0 and 1.0, and checks if it is less than a specified value. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''random_chance''' — Generates a random number between 0.0 and 1.0, and checks if it is less than a specified value. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|float}}{{nbt\|compound\|chance}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Success rate as a number 0.0 – 1.0.		** {{nbt\|float}}{{nbt\|compound\|chance}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Success rate as a number 0.0 – 1.0.
	</div>		</div>

Line 168:		Line 158:
	** {{nbt\|float}}{{nbt\|compound\|enchanted_chance}}: [[Minecraft:level-based value]]. The success rate based on the level when then enchantment is present; 0.0–1.0.		** {{nbt\|float}}{{nbt\|compound\|enchanted_chance}}: [[Minecraft:level-based value]]. The success rate based on the level when then enchantment is present; 0.0–1.0.
	** {{nbt\|string\|enchantment}}: {{json ref/enchantment}}. The enchantment whose level to use for the chance calculation. If the enchantment is not present, uses {{cd\|0}} as level.		** {{nbt\|string\|enchantment}}: {{json ref/enchantment}}. The enchantment whose level to use for the chance calculation. If the enchantment is not present, uses {{cd\|0}} as level.
	~~</div>~~

	~~<div class="treeview" id="condition_reference" style="margin-block-end: 1em;">~~
	* '''reference'''{{until\|JE 26.3}} — Invokes a predicate file and returns its result. Invokable from <b><span style="color:#00af89">any context</span></b>. Cannot be used in [[Minecraft:Enchantment_definition#Effect_components\|enchantment definitions]].
	** {{nbt\|string\|name}}: The [[Minecraft:resource location]] of the predicate to invoke. A cyclic reference causes a parsing failure.
	</div>		</div>

Line 189:		Line 174:
	** {{nbt\|string\|clock}}: {{json ref\|world clock}} to check the time of.		** {{nbt\|string\|clock}}: {{json ref\|world clock}} to check the time of.
	** {{nbt\|compound\|value}}: The time to compare the day time against.		** {{nbt\|compound\|value}}: The time to compare the day time against.
	*** {{nbt\|int}}{{nbt\|compound\|min}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The minimum value.		*** {{nbt\|int}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The minimum value.
	*** {{nbt\|int}}{{nbt\|compound\|max}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The maximum value.		*** {{nbt\|int}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The maximum value.
	** {{nbt\|int\|value}}: Shorthand version of {{nbt\|compound\|value}} above, used to check for a single value only. Number providers cannot be used in this shorthand form.		** {{nbt\|int\|value}}: Shorthand version of {{nbt\|compound\|value}} above, used to check for a single value only. Number providers cannot be used in this shorthand form.
	** {{nbt\|int\|period}}: If present, the day time is first reduced modulo the given number before being checked against {{nbt\|compound}}{{nbt\|int\|value}}. For example, setting this to 24000 causes the checked time to be equal to the current daytime.		** {{nbt\|int\|period}}: If present, the day time is first reduced modulo the given number before being checked against {{nbt\|compound}}{{nbt\|int\|value}}. For example, setting this to 24000 causes the checked time to be equal to the current daytime.
Line 197:		Line 182:
	<div class="treeview" id="condition_value_check" style="margin-block-end: 1em;">		<div class="treeview" id="condition_value_check" style="margin-block-end: 1em;">
	* '''value_check''' — Compares a number against another number or range of numbers. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''value_check''' — Compares a number against another number or range of numbers. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|int}}{{nbt\|compound\|value}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The number to test.		** {{nbt\|int}}{{nbt\|compound\|value}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The number to test.
	** {{nbt\|compound\|range}}: The range of numbers to compare {{nbt\|int}}{{nbt\|compound\|value}} against.		** {{nbt\|compound\|range}}: The range of numbers to compare {{nbt\|int}}{{nbt\|compound\|value}} against.
	*** {{nbt\|int}}{{nbt\|compound\|min}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The minimum value.		*** {{nbt\|int}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The minimum value.
	*** {{nbt\|int}}{{nbt\|compound\|max}}: ~~A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an~~ inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The maximum value.		*** {{nbt\|int}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The maximum value.
	** {{nbt\|int\|range}}: Shorthand version of {{nbt\|compound\|range}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single number only. Number providers cannot be used in this shorthand form.		** {{nbt\|int\|range}}: Shorthand version of {{nbt\|compound\|range}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single number only. Number providers cannot be used in this shorthand form.
	</div>		</div>

SyncBot: Sync: updated from Minecraft

2026-09-16T11:32:40Z

Sync: updated from Minecraft

SyncBot: Sync: updated from Minecraft

2026-08-08T11:29:02Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:29, 8 August 2026
Line 255:		Line 255:
	* added {{cd\|movement}} sub-predicate.		* added {{cd\|movement}} sub-predicate.
	* added {{cd\|periodic_ticks}} sub-predicate.\|		* added {{cd\|periodic_ticks}} sub-predicate.\|
	Renamed loot context entities: {{cd\|killer}} renamed to {{cd\|attacker}}; {{cd\|direct_killer}} renamed to {{cd\|direct_attacker}}; {{cd\|killer_player}} renamed to {{cd\|~~attacking player~~}}.}}		Renamed loot context entities: {{cd\|killer}} renamed to {{cd\|attacker}}; {{cd\|direct_killer}} renamed to {{cd\|direct_attacker}}; {{cd\|killer_player}} renamed to {{cd\|attacking_player}}.}}
	\|{{HistoryLine\|\|\|dev=24w19a\|Added {{cd\|is_direct}} field to damage type predicates.}}		\|{{HistoryLine\|\|\|dev=24w19a\|Added {{cd\|is_direct}} field to damage type predicates.}}
	\|{{HistoryLine\|\|\|dev=24w21a\|Added {{cd\|jukebox_playable}} item predicate.\|		\|{{HistoryLine\|\|\|dev=24w21a\|Added {{cd\|jukebox_playable}} item predicate.\|

SyncBot: Sync: updated from Minecraft

2026-07-31T11:14:47Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 31 July 2026
Line 146:		Line 146:
	* '''match_block'''{{upcoming\|JE 26.3}} — Matches block state and optionally block entity data and components (if present).		* '''match_block'''{{upcoming\|JE 26.3}} — Matches block state and optionally block entity data and components (if present).
	** {{nbt\|string}}{{nbt\|list\|blocks}}: Optional; Can be a single block ID, a list of namespaced block IDs, or a hash-prefixed block tag to match.		** {{nbt\|string}}{{nbt\|list\|blocks}}: Optional; Can be a single block ID, a list of namespaced block IDs, or a hash-prefixed block tag to match.
	**** {{nbt\|compound\|state}}: Optional; The block state property keys to values to match.		** {{nbt\|compound\|state}}: Optional; The block state property keys to values to match.
	**** {{nbt\|compound\|nbt}}: Optional; [[Minecraft:Block entity]] NBT to match. See [[Minecraft:Block entity format]]. Match will fail if the field is present, but the block entity is not available in context.		** {{nbt\|compound\|nbt}}: Optional; [[Minecraft:Block entity]] NBT to match. See [[Minecraft:Block entity format]]. Match will fail if the field is present, but the block entity is not available in context.
	**** {{nbt\|compound\|components}}: Optional; Map of exact components to match. Match will fail if the field is present, but the block entity is not available in context.		** {{nbt\|compound\|components}}: Optional; Map of exact components to match. Match will fail if the field is present, but the block entity is not available in context.
	**** {{nbt\|compound\|predicates}}: Optional; Map of component predicates to match. Match will fail if the field is present, but the block entity is not available in context.		** {{nbt\|compound\|predicates}}: Optional; Map of component predicates to match. Match will fail if the field is present, but the block entity is not available in context.
	</div>		</div>

← Older revision		Revision as of 11:17, 4 October 2026
Line 274:		Line 274:
	\|{{HistoryLine\|\|26.3\|dev=pre1\|[[Minecraft:Number provider]]s were split into {{cd\|context_int_provider}} and {{cd\|context_float_provider}} registries:		\|{{HistoryLine\|\|26.3\|dev=pre1\|[[Minecraft:Number provider]]s were split into {{cd\|context_int_provider}} and {{cd\|context_float_provider}} registries:
	* Fields for condition types {{cd\|entity_scores}}, {{cd\|random_chance}} and {{cd\|time_check}} now call for a specific type of number provider and allow them in more places.		* Fields for condition types {{cd\|entity_scores}}, {{cd\|random_chance}} and {{cd\|time_check}} now call for a specific type of number provider and allow them in more places.
	* Removed {{cd\|value_check}} condition type, now split into {{cd\|int_value_check}} and {{cd\|float_value_check}}.		* Removed {{cd\|value_check}} condition type, now split into {{cd\|int_value_check}} and {{cd\|float_value_check}}.}}
	}}		\|{{HistoryLine\|java upcoming}}
			\|{{HistoryLine\|\|26.4\|dev=snap2\|Added {{cd\|below_heightmap}}.}}
	}}		}}

← Older revision		Revision as of 11:11, 22 September 2026
Line 121:		Line 121:
	*** {{nbt\|float}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The minimum value.		*** {{nbt\|float}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The minimum value.
	*** {{nbt\|float}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The maximum value.		*** {{nbt\|float}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. The maximum value.
	** {{nbt\|float\|test}}: Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|float}}{{nbt\|compound\|value}} against a single float only~~. Number providers cannot be used in this shorthand form~~.		** {{nbt\|float}}{{nbt\|compound\|test}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_float_provider}} type. Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|float}}{{nbt\|compound\|value}} against a single float only.
	</div>		</div>

Line 130:		Line 130:
	*** {{nbt\|int}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The minimum value.		*** {{nbt\|int}}{{nbt\|compound\|min}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The minimum value.
	*** {{nbt\|int}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The maximum value.		*** {{nbt\|int}}{{nbt\|compound\|max}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. The maximum value.
	** {{nbt\|int\|test}}: Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single int only~~. Number providers cannot be used in this shorthand form~~.		** {{nbt\|int}}{{nbt\|compound\|test}}: An inline value or a namespaced ID of a {{cd\|minecraft:context_int_provider}} type. Shorthand version of {{nbt\|compound\|test}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single int only.
	</div>		</div>

← Older revision		Revision as of 11:29, 8 August 2026
Line 255:		Line 255:
	* added {{cd\|movement}} sub-predicate.		* added {{cd\|movement}} sub-predicate.
	* added {{cd\|periodic_ticks}} sub-predicate.\|		* added {{cd\|periodic_ticks}} sub-predicate.\|
	Renamed loot context entities: {{cd\|killer}} renamed to {{cd\|attacker}}; {{cd\|direct_killer}} renamed to {{cd\|direct_attacker}}; {{cd\|killer_player}} renamed to {{cd\|~~attacking player~~}}.}}		Renamed loot context entities: {{cd\|killer}} renamed to {{cd\|attacker}}; {{cd\|direct_killer}} renamed to {{cd\|direct_attacker}}; {{cd\|killer_player}} renamed to {{cd\|attacking_player}}.}}
	\|{{HistoryLine\|\|\|dev=24w19a\|Added {{cd\|is_direct}} field to damage type predicates.}}		\|{{HistoryLine\|\|\|dev=24w19a\|Added {{cd\|is_direct}} field to damage type predicates.}}
	\|{{HistoryLine\|\|\|dev=24w21a\|Added {{cd\|jukebox_playable}} item predicate.\|		\|{{HistoryLine\|\|\|dev=24w21a\|Added {{cd\|jukebox_playable}} item predicate.\|

← Older revision		Revision as of 11:14, 31 July 2026
Line 146:		Line 146:
	* '''match_block'''{{upcoming\|JE 26.3}} — Matches block state and optionally block entity data and components (if present).		* '''match_block'''{{upcoming\|JE 26.3}} — Matches block state and optionally block entity data and components (if present).
	** {{nbt\|string}}{{nbt\|list\|blocks}}: Optional; Can be a single block ID, a list of namespaced block IDs, or a hash-prefixed block tag to match.		** {{nbt\|string}}{{nbt\|list\|blocks}}: Optional; Can be a single block ID, a list of namespaced block IDs, or a hash-prefixed block tag to match.
	**** {{nbt\|compound\|state}}: Optional; The block state property keys to values to match.		** {{nbt\|compound\|state}}: Optional; The block state property keys to values to match.
	**** {{nbt\|compound\|nbt}}: Optional; [[Minecraft:Block entity]] NBT to match. See [[Minecraft:Block entity format]]. Match will fail if the field is present, but the block entity is not available in context.		** {{nbt\|compound\|nbt}}: Optional; [[Minecraft:Block entity]] NBT to match. See [[Minecraft:Block entity format]]. Match will fail if the field is present, but the block entity is not available in context.
	**** {{nbt\|compound\|components}}: Optional; Map of exact components to match. Match will fail if the field is present, but the block entity is not available in context.		** {{nbt\|compound\|components}}: Optional; Map of exact components to match. Match will fail if the field is present, but the block entity is not available in context.
	**** {{nbt\|compound\|predicates}}: Optional; Map of component predicates to match. Match will fail if the field is present, but the block entity is not available in context.		** {{nbt\|compound\|predicates}}: Optional; Map of component predicates to match. Match will fail if the field is present, but the block entity is not available in context.
	</div>		</div>

← Older revision		Revision as of 11:32, 16 September 2026
Line 69:		Line 69:
	<div class="treeview" style="margin-block-end: 1em;">		<div class="treeview" style="margin-block-end: 1em;">
	* {{nbt\|list}}{{nbt\|compound}}: The root element of the predicate.		* {{nbt\|list}}{{nbt\|compound}}: The root element of the predicate.
	** {{nbt\|string\|condition}}{{until\|JE 26.3}} / {{nbt\|string\|type~~}}{{upcoming\|JE 26.3~~}}: The [[Minecraft:resource location]] of the condition type to check.		** {{nbt\|string\|condition}}{{until\|JE 26.3}} / {{nbt\|string\|type}}: The [[Minecraft:resource location]] of the condition type to check.
	** Other parts of the predicate, specified below. In lists each element must evaluate to true for the predicate to pass.		** Other parts of the predicate, specified below. In lists each element must evaluate to true for the predicate to pass.
	</div>		</div>
Line 77:		Line 77:
	<div class="treeview" id="condition_all_of" style="margin-block-end: 1em;">		<div class="treeview" id="condition_all_of" style="margin-block-end: 1em;">
	* '''all_of''' — Evaluates a list of predicates and passes if all of them pass. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''all_of''' — Evaluates a list of predicates and passes if all of them pass. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|list\|terms}}: The list of predicates to evaluate.{{until\|JE 26.3}} / an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.~~{{upcoming\|JE 26.3}}~~		** {{nbt\|list\|terms}}: The list of predicates to evaluate.{{until\|JE 26.3}} / an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.
	*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively.		*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively.
	</div>		</div>
Line 83:		Line 83:
	<div class="treeview" id="condition_alternative" style="margin-block-end: 1em;">		<div class="treeview" id="condition_alternative" style="margin-block-end: 1em;">
	* '''any_of''' — Evaluates a list of predicates and passes if any one of them passes. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''any_of''' — Evaluates a list of predicates and passes if any one of them passes. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|list\|terms}}: The list of predicates to evaluate.{{until\|JE 26.3}} / an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.~~{{upcoming\|JE 26.3}}~~		** {{nbt\|list\|terms}}: The list of predicates to evaluate.{{until\|JE 26.3}} / an inline value, a single namespaced ID, a list of namespaced IDs, a list of inline values, or a hash-prefixed tag ID of a {{cd\|minecraft:predicate}} type.
	*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively. Note that ''any_of'' only applies to {{nbt\|list\|terms}}, nested lists are ''all_of''.		*** {{nbt\|list}}{{nbt\|compound}} A predicate, following this structure recursively. Note that ''any_of'' only applies to {{nbt\|list\|terms}}, nested lists are ''all_of''.
	</div>		</div>
Line 120:		Line 120:
	** {{nbt\|compound\|scores}}: Scores to check. All specified scores must pass for the condition to pass.		** {{nbt\|compound\|scores}}: Scores to check. All specified scores must pass for the condition to pass.
	*** {{nbt\|compound\|A score}}: Key name is the objective while the value specifies a range of score values required for the condition to pass.		*** {{nbt\|compound\|A score}}: Key name is the objective while the value specifies a range of score values required for the condition to pass.
	**** {{nbt\|int}}{{nbt\|compound\|min}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ Minimum score. Optional.		**** {{nbt\|int}}{{nbt\|compound\|min}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Minimum score. Optional.
	**** {{nbt\|int}}{{nbt\|compound\|max}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ Maximum score. Optional.		**** {{nbt\|int}}{{nbt\|compound\|max}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Maximum score. Optional.
	*** {{nbt\|int\|A score}}: Shorthand version of the other syntax above, to check the score against a single number only. Key name is the objective while the value is the required score.		*** {{nbt\|int\|A score}}: Shorthand version of the other syntax above, to check the score against a single number only. Key name is the objective while the value is the required score.
	</div>		</div>
Line 127:		Line 127:
	<div class="treeview" id="condition_inverted" style="margin-block-end: 1em;">		<div class="treeview" id="condition_inverted" style="margin-block-end: 1em;">
	* '''inverted''' — Inverts another predicate condition. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''inverted''' — Inverts another predicate condition. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|compound\|term}}: The condition to be negated, following the same structure as outlined here, recursively.{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:predicate}} type.~~{{upcoming\|JE 26.3}}~~		** {{nbt\|compound\|term}}: The condition to be negated, following the same structure as outlined here, recursively.{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:predicate}} type.
	</div>		</div>

Line 144:		Line 144:

	<div class="treeview" id="condition_match_tool" style="margin-block-end: 1em;">		<div class="treeview" id="condition_match_tool" style="margin-block-end: 1em;">
	* '''match_block'''~~{{upcoming\|JE 26.3}}~~ — Matches block state and optionally block entity data and components (if present).		* '''match_block''' — Matches block state and optionally block entity data and components (if present).
	** {{nbt\|string}}{{nbt\|list\|blocks}}: Optional; Can be a single block ID, a list of namespaced block IDs, or a hash-prefixed block tag to match.		** {{nbt\|string}}{{nbt\|list\|blocks}}: Optional; Can be a single block ID, a list of namespaced block IDs, or a hash-prefixed block tag to match.
	** {{nbt\|compound\|state}}: Optional; The block state property keys to values to match.		** {{nbt\|compound\|state}}: Optional; The block state property keys to values to match.
Line 160:		Line 160:
	<div class="treeview" id="condition_random_chance" style="margin-block-end: 1em;">		<div class="treeview" id="condition_random_chance" style="margin-block-end: 1em;">
	* '''random_chance''' — Generates a random number between 0.0 and 1.0, and checks if it is less than a specified value. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''random_chance''' — Generates a random number between 0.0 and 1.0, and checks if it is less than a specified value. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|float}}{{nbt\|compound\|chance}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ Success rate as a number 0.0 – 1.0.		** {{nbt\|float}}{{nbt\|compound\|chance}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. Success rate as a number 0.0 – 1.0.
	</div>		</div>

Line 189:		Line 189:
	** {{nbt\|string\|clock}}: {{json ref\|world clock}} to check the time of.		** {{nbt\|string\|clock}}: {{json ref\|world clock}} to check the time of.
	** {{nbt\|compound\|value}}: The time to compare the day time against.		** {{nbt\|compound\|value}}: The time to compare the day time against.
	*** {{nbt\|int}}{{nbt\|compound\|min}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ The minimum value.		*** {{nbt\|int}}{{nbt\|compound\|min}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The minimum value.
	*** {{nbt\|int}}{{nbt\|compound\|max}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ The maximum value.		*** {{nbt\|int}}{{nbt\|compound\|max}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The maximum value.
	** {{nbt\|int\|value}}: Shorthand version of {{nbt\|compound\|value}} above, used to check for a single value only. Number providers cannot be used in this shorthand form.		** {{nbt\|int\|value}}: Shorthand version of {{nbt\|compound\|value}} above, used to check for a single value only. Number providers cannot be used in this shorthand form.
	** {{nbt\|int\|period}}: If present, the day time is first reduced modulo the given number before being checked against {{nbt\|compound}}{{nbt\|int\|value}}. For example, setting this to 24000 causes the checked time to be equal to the current daytime.		** {{nbt\|int\|period}}: If present, the day time is first reduced modulo the given number before being checked against {{nbt\|compound}}{{nbt\|int\|value}}. For example, setting this to 24000 causes the checked time to be equal to the current daytime.
Line 197:		Line 197:
	<div class="treeview" id="condition_value_check" style="margin-block-end: 1em;">		<div class="treeview" id="condition_value_check" style="margin-block-end: 1em;">
	* '''value_check''' — Compares a number against another number or range of numbers. Invokable from <b><span style="color:#00af89">any context</span></b>.		* '''value_check''' — Compares a number against another number or range of numbers. Invokable from <b><span style="color:#00af89">any context</span></b>.
	** {{nbt\|int}}{{nbt\|compound\|value}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ The number to test.		** {{nbt\|int}}{{nbt\|compound\|value}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The number to test.
	** {{nbt\|compound\|range}}: The range of numbers to compare {{nbt\|int}}{{nbt\|compound\|value}} against.		** {{nbt\|compound\|range}}: The range of numbers to compare {{nbt\|int}}{{nbt\|compound\|value}} against.
	*** {{nbt\|int}}{{nbt\|compound\|min}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ The minimum value.		*** {{nbt\|int}}{{nbt\|compound\|min}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The minimum value.
	*** {{nbt\|int}}{{nbt\|compound\|max}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type.~~{{upcoming\|JE 26.3}}~~ The maximum value.		*** {{nbt\|int}}{{nbt\|compound\|max}}: A [[Minecraft:Loot table#Number provider\|number provider]].{{until\|JE 26.3}} / an inline value or a namespaced ID of a {{cd\|minecraft:number_provider}} type. The maximum value.
	** {{nbt\|int\|range}}: Shorthand version of {{nbt\|compound\|range}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single number only. Number providers cannot be used in this shorthand form.		** {{nbt\|int\|range}}: Shorthand version of {{nbt\|compound\|range}} above, used to compare {{nbt\|int}}{{nbt\|compound\|value}} against a single number only. Number providers cannot be used in this shorthand form.
	</div>		</div>
Line 273:		Line 273:
	\|{{HistoryLine\|\|26.2\|dev=snap3\|The entity predicate format has changed from a structure with multiple optional fields to one similar to data component maps.\|Added {{cd\|minecraft:entity_tags}} entity sub-predicate.}}		\|{{HistoryLine\|\|26.2\|dev=snap3\|The entity predicate format has changed from a structure with multiple optional fields to one similar to data component maps.\|Added {{cd\|minecraft:entity_tags}} entity sub-predicate.}}
	\|{{HistoryLine\|\|\|dev=snap4\|The entity sub-predicate {{cd\|slime}} has been renamed to {{cd\|cube_mob}}.}}		\|{{HistoryLine\|\|\|dev=snap4\|The entity sub-predicate {{cd\|slime}} has been renamed to {{cd\|cube_mob}}.}}
	~~\|{{HistoryLine\|upcoming java}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap3\|New entries added to previously empty {{cd\|minecraft:predicate}}: {{cd\|minecraft:tool/can_silk_touch}}, {{cd\|minecraft:tool/can_shear}}.\|The {{cd\|minecraft:potion_contents}} data component predicate has been changed to allow matching on specific potion effects.}}		\|{{HistoryLine\|\|26.3\|dev=snap3\|New entries added to previously empty {{cd\|minecraft:predicate}}: {{cd\|minecraft:tool/can_silk_touch}}, {{cd\|minecraft:tool/can_shear}}.\|The {{cd\|minecraft:potion_contents}} data component predicate has been changed to allow matching on specific potion effects.}}
	\|{{HistoryLine\|\|\|dev=snap4\|Added the {{cd\|match_block}} condition type.		\|{{HistoryLine\|\|\|dev=snap4\|Added the {{cd\|match_block}} condition type.