Minecraft:Advancement definition - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-24T11:02:03Z

Sync: updated from Minecraft

SyncBot: Sync: updated from Minecraft

2026-10-15T11:03:23Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 15 October 2026
Line 323:		Line 323:

	=== minecraft:brewed_potion ===		=== minecraft:brewed_potion ===
	Triggers after the player takes any item out of a [[Minecraft:brewing stand]]. Available extra conditions:		Triggers after the player takes any item out of one of the potion slots of a [[Minecraft:brewing stand]]. Available extra conditions:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|conditions}}:		* {{nbt\|compound\|conditions}}:
	** {{nbt\|~~string~~\|potion}}: A [[Minecraft:~~Potion~~#~~Item data~~\|~~brewed~~ potion ID]].		** {{nbt\|compound\|potion}}: A [[Minecraft:Data_component_predicate#potion_contents\|potion contents data component predicate]].
	</div>		</div>
	<div class="collapsible collapsed collapsetoggle-inline" data-expandtext="show" data-collapsetext="hide">		<div class="collapsible collapsed collapsetoggle-inline" data-expandtext="show" data-collapsetext="hide">
Line 336:		Line 336:
	"trigger": "minecraft:brewed_potion",		"trigger": "minecraft:brewed_potion",
	"conditions": {		"conditions": {
	"potion": "minecraft:strong_swiftness"		"potion": {
			"potions": "minecraft:strong_swiftness"
			}
	}		}
	}		}

SyncBot: Sync: updated from Minecraft

2026-10-10T11:03:45Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 10 October 2026
Line 1,306:		Line 1,306:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|conditions}}:		* {{nbt\|compound\|conditions}}:
	** {{nbt\|~~list~~\|location}}: ~~Specifies a list of~~ [[Minecraft:predicate]]s that must pass in order for the criterion to be granted. The origin is the location of the block placed, the block state belongs to that block, and the tool is the item used to place the block. The {{cd\|this}} entity is the player that would get the advancement.		** {{nbt\|compound\|location}}: A [[Minecraft:predicate]] that must pass in order for the criterion to be granted. The origin is the location of the block placed, the block state belongs to that block, and the tool is the item used to place the block. The {{cd\|this}} entity is the player that would get the advancement.
	*** {{nbt\|compound}}: A single [[Minecraft:predicate]].
	</div>		</div>
	<div class="collapsible collapsed collapsetoggle-inline" data-expandtext="show" data-collapsetext="hide">		<div class="collapsible collapsed collapsetoggle-inline" data-expandtext="show" data-collapsetext="hide">
Line 1,317:		Line 1,316:
	"trigger": "minecraft:placed_block",		"trigger": "minecraft:placed_block",
	"conditions": {		"conditions": {
	"location": [		"location": {
	{		"condition": "location_check",
	"condition": "location_check",		"predicate": {
	"predicate": {		"block": {
	"block": {		"blocks": "wall_torch",
	"blocks": "wall_torch",		"state": {
	"state": {		"facing": "west"
	"facing": "west"		}
	}		},
	},		"position": {
	"position": {		"x": 10,
	"x": 10,		"z": 14
	"z": 14		},
	},		"biome": "minecraft:plains"
	"biome": "minecraft:plains"
	}
	}		}
	]		}
	}		}
	}		}

SyncBot: Sync: updated from Minecraft

2026-09-27T11:05:03Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 27 September 2026
Line 3:		Line 3:
	{{TOC\|none\|limit=2}}		{{TOC\|none\|limit=2}}

	== ~~File~~ format ==		== Definition ==
			An advancement file is defined with the [[Minecraft:JSON]] format.

			Advancement files are part of the data pack directory structure, highlighted below:
			{{Data pack directory\|advancement\|<nowiki><name>.json</nowiki>}}

			== JSON format ==
	All advancement JSON files are structured according to the following format.		All advancement JSON files are structured according to the following format.

SyncBot: Sync: updated from Minecraft

2026-09-16T11:05:16Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 16 September 2026
Line 238:		Line 238:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|conditions}}:		* {{nbt\|compound\|conditions}}:
	** {{nbt\|string\|block}}{{until\|je 26.2}}'''blocks'''{{upcoming\|je 26.3}}: Checks the block that was destroyed. Accepts block IDs.
	** {{nbt\|compound\|item}}: The item used to break the block.		** {{nbt\|compound\|item}}: The item used to break the block.
	*** {{Nbt inherit/conditions/item}}		*** {{Nbt inherit/conditions/item}}
Line 2,312:		Line 2,311:
	\|{{HistoryLine\|\|1.21.6\|dev=pre3\|Added {{Code\|player_sheared_equipment}} trigger.}}		\|{{HistoryLine\|\|1.21.6\|dev=pre3\|Added {{Code\|player_sheared_equipment}} trigger.}}
	\|{{HistoryLine\|\|1.21.11\|dev=25w45a\|Added {{Code\|spear_mobs}} trigger.}}		\|{{HistoryLine\|\|1.21.11\|dev=25w45a\|Added {{Code\|spear_mobs}} trigger.}}
	~~\|{{HistoryLine\|upcoming java}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap4\|The {{cd\|loot}} sub-field in the {{cd\|rewards}} field now accepts 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:loot_table}} type.\|Multiple trigger fields that accepted a list of loot conditions (AKA predicates) are now stricter.\|Changed several triggers: {{cd\|minecraft:any_block_use}}, {{cd\|minecraft:bee_nest_destroyed}}, {{cd\|minecraft:bred_animals}}, {{cd\|minecraft:brewed_potion}}, {{cd\|minecraft:channeled_lightning}}, {{cd\|minecraft:cured_zombie_villager}}, {{cd\|minecraft:default_block_use}}, {{cd\|minecraft:effects_changed}}, {{cd\|minecraft:enter_block}}, {{cd\|minecraft:fall_after_explosion}}, {{cd\|minecraft:fishing_rod_hooked}}, {{cd\|minecraft:placed_block}}, {{cd\|minecraft:item_used_on_block}}, {{cd\|minecraft:allay_drop_item_on_block}}, {{cd\|minecraft:player_killed_entity}}, {{cd\|minecraft:entity_killed_player}}, {{cd\|minecraft:kill_mob_near_sculk_catalyst}}, {{cd\|minecraft:lightning_strike}}, {{cd\|minecraft:player_generates_container_loot}}, {{cd\|minecraft:thrown_item_picked_up_by_player}}, {{cd\|minecraft:thrown_item_picked_up_by_entity}}, {{cd\|minecraft:player_hurt_entity}}, {{cd\|minecraft:entity_hurt_player}}, {{cd\|minecraft:player_interacted_with_entity}}, {{cd\|minecraft:player_sheared_equipment}}, {{cd\|minecraft:crafter_recipe_crafted}}, {{cd\|minecraft:recipe_crafted}}, {{cd\|minecraft:recipe_unlocked}}, {{cd\|minecraft:slide_down_block}}, {{cd\|minecraft:summoned_entity}}, {{cd\|minecraft:tame_animal}}, {{cd\|minecraft:target_hit}}, {{cd\|minecraft:villager_trade}}.}}		\|{{HistoryLine\|\|26.3\|dev=snap4\|The {{cd\|loot}} sub-field in the {{cd\|rewards}} field now accepts 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:loot_table}} type.\|Multiple trigger fields that accepted a list of loot conditions (AKA predicates) are now stricter.\|Changed several triggers: {{cd\|minecraft:any_block_use}}, {{cd\|minecraft:bee_nest_destroyed}}, {{cd\|minecraft:bred_animals}}, {{cd\|minecraft:brewed_potion}}, {{cd\|minecraft:channeled_lightning}}, {{cd\|minecraft:cured_zombie_villager}}, {{cd\|minecraft:default_block_use}}, {{cd\|minecraft:effects_changed}}, {{cd\|minecraft:enter_block}}, {{cd\|minecraft:fall_after_explosion}}, {{cd\|minecraft:fishing_rod_hooked}}, {{cd\|minecraft:placed_block}}, {{cd\|minecraft:item_used_on_block}}, {{cd\|minecraft:allay_drop_item_on_block}}, {{cd\|minecraft:player_killed_entity}}, {{cd\|minecraft:entity_killed_player}}, {{cd\|minecraft:kill_mob_near_sculk_catalyst}}, {{cd\|minecraft:lightning_strike}}, {{cd\|minecraft:player_generates_container_loot}}, {{cd\|minecraft:thrown_item_picked_up_by_player}}, {{cd\|minecraft:thrown_item_picked_up_by_entity}}, {{cd\|minecraft:player_hurt_entity}}, {{cd\|minecraft:entity_hurt_player}}, {{cd\|minecraft:player_interacted_with_entity}}, {{cd\|minecraft:player_sheared_equipment}}, {{cd\|minecraft:crafter_recipe_crafted}}, {{cd\|minecraft:recipe_crafted}}, {{cd\|minecraft:recipe_unlocked}}, {{cd\|minecraft:slide_down_block}}, {{cd\|minecraft:summoned_entity}}, {{cd\|minecraft:tame_animal}}, {{cd\|minecraft:target_hit}}, {{cd\|minecraft:villager_trade}}.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-08-21T11:02:03Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 21 August 2026
Line 2,329:		Line 2,329:
	[[Minecraft:de:Fortschrittsdefinition]]		[[Minecraft:de:Fortschrittsdefinition]]
	[[Minecraft:fr:Définition de progrès]]		[[Minecraft:fr:Définition de progrès]]
	[[Minecraft:ja:~~進捗/JSONフォーマット~~]]		[[Minecraft:ja:進捗のカスタマイズ]]
	[[Minecraft:pt:Definição de progressos]]		[[Minecraft:pt:Definição de progressos]]
	[[Minecraft:ru:Достижение (Java Edition)/Формат JSON]]		[[Minecraft:ru:Достижение (Java Edition)/Формат JSON]]
	[[Minecraft:zh:进度定义格式]]		[[Minecraft:zh:进度定义格式]]

SyncBot: Sync: updated from Minecraft

2026-08-17T11:07:10Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:07, 17 August 2026
Line 437:		Line 437:
	"minecraft:enchanted_golden_apple"		"minecraft:enchanted_golden_apple"
	],		],
	"~~nbt~~": "~~{display~~:~~{Name~~:\"~~Example\~~"}}"		"components": {"minecraft:custom_name":"Enchanted apple"}
	}		}
	}		}

SyncBot: Sync: updated from Minecraft

2026-07-30T11:04:48Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 30 July 2026
Line 23:		Line 23:
	*** {{nbt\|boolean\|show_toast}}: Whether to show a toast to the player when this advancement has been completed. Defaults to {{cd\|true}}.		*** {{nbt\|boolean\|show_toast}}: Whether to show a toast to the player when this advancement has been completed. Defaults to {{cd\|true}}.
	*** {{nbt\|boolean\|announce_to_chat}}: Whether to announce in the chat when this advancement has been completed. Defaults to {{cd\|true}}.		*** {{nbt\|boolean\|announce_to_chat}}: Whether to announce in the chat when this advancement has been completed. Defaults to {{cd\|true}}.
	*** {{nbt\|boolean\|hidden}}: Whether to hide this advancement and all its children from the advancement screen until this advancement ~~have~~ been completed. Has no effect on root advancements themselves, but still affects all their children. Defaults to {{cd\|false}}.		*** {{nbt\|boolean\|hidden}}: Whether to hide this advancement and all its children from the advancement screen until this advancement has been completed. Has no effect on root advancements themselves, but still affects all their children. Defaults to {{cd\|false}}.
	** {{nbt\|compound\|criteria}}<span style="color:red;">*</span>: The criteria to be tracked by this advancement.		** {{nbt\|compound\|criteria}}<span style="color:red;">*</span>: The criteria to be tracked by this advancement.
	*** {{nbt\|compound\|<criterionName>}}: The key is a unique name given to the criterion. Can be any valid text.		*** {{nbt\|compound\|<criterionName>}}: The key is a unique name given to the criterion. Can be any valid text.

SyncBot: Sync: updated from Minecraft

2026-07-29T11:02:45Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 29 July 2026
Line 1,337:		Line 1,337:

	=== minecraft:player_generates_container_loot ===		=== minecraft:player_generates_container_loot ===
	Triggers when the player generates the contents of a container with a loot table set. Available extra conditions:		Triggers when the player generates the contents of a container ([[Minecraft:Block_entity\|container block]], [[Minecraft:minecart with chest]], [[Minecraft:minecart with hopper]], [[Minecraft:boat with chest]] and [[Minecraft:Brush#Suspicious_blocks\|suspicious block]]) with a loot table set. Available extra conditions:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|conditions}}:		* {{nbt\|compound\|conditions}}:

SyncBot: Sync: updated from Minecraft

2026-07-23T11:00:34Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:00, 23 July 2026
Line 921:		Line 921:

	=== minecraft:inventory_changed ===		=== minecraft:inventory_changed ===
	Triggers after any changes happen to the player's [[Minecraft:inventory]]. Available extra conditions:		Triggers after any changes happen to a slot in the player's [[Minecraft:inventory]], except for the {{code\|player.cursor}} and {{code\|player.crafting.*}} slots. Available extra conditions:
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound\|conditions}}:		* {{nbt\|compound\|conditions}}:

← Older revision		Revision as of 11:04, 30 July 2026
Line 23:		Line 23:
	*** {{nbt\|boolean\|show_toast}}: Whether to show a toast to the player when this advancement has been completed. Defaults to {{cd\|true}}.		*** {{nbt\|boolean\|show_toast}}: Whether to show a toast to the player when this advancement has been completed. Defaults to {{cd\|true}}.
	*** {{nbt\|boolean\|announce_to_chat}}: Whether to announce in the chat when this advancement has been completed. Defaults to {{cd\|true}}.		*** {{nbt\|boolean\|announce_to_chat}}: Whether to announce in the chat when this advancement has been completed. Defaults to {{cd\|true}}.
	*** {{nbt\|boolean\|hidden}}: Whether to hide this advancement and all its children from the advancement screen until this advancement ~~have~~ been completed. Has no effect on root advancements themselves, but still affects all their children. Defaults to {{cd\|false}}.		*** {{nbt\|boolean\|hidden}}: Whether to hide this advancement and all its children from the advancement screen until this advancement has been completed. Has no effect on root advancements themselves, but still affects all their children. Defaults to {{cd\|false}}.
	** {{nbt\|compound\|criteria}}<span style="color:red;">*</span>: The criteria to be tracked by this advancement.		** {{nbt\|compound\|criteria}}<span style="color:red;">*</span>: The criteria to be tracked by this advancement.
	*** {{nbt\|compound\|<criterionName>}}: The key is a unique name given to the criterion. Can be any valid text.		*** {{nbt\|compound\|<criterionName>}}: The key is a unique name given to the criterion. Can be any valid text.