Minecraft:Loot context - Revision history

SyncBot: Sync: updated from Minecraft

2026-08-27T11:15:05Z

Sync: updated from Minecraft

SyncBot: Sync: updated from Minecraft

2026-08-26T11:15:34Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:15, 26 August 2026
Line 148:		Line 148:
	\|-		\|-
	\| {{cd\|command}} \|\|		\| {{cd\|command}} \|\|
	* Used ~~internally~~ to evaluate [[Minecraft:predicate]]s and [[Minecraft:item modifier]]s by commands such as {{cmd\|item modify}} or {{cmd\|execute (if{{!}}unless) predicate}}.		* Used to evaluate [[Minecraft:predicate]]s and [[Minecraft:item modifier]]s by commands such as {{cmd\|item modify}} or {{cmd\|execute (if{{!}}unless) predicate}}.
	\|		\|
	* '''Origin:''' The position where the command is run.		* '''Origin:''' The position where the command is run.
	\|		\|
	* '''{{cd\|this}} entity:''' The entity that is {{cd\|@s}} when the command is run.		* '''{{cd\|this}} entity:''' The entity that is {{cd\|@s}} when the command is run.
			\|-
			\| {{cd\|command_compute_default}}{{upcoming\|java 26.3}} \|\|
			* Used to evaluate [[Minecraft:number provider]]s by {{command\|compute default}}.
			\|
			* '''Origin:''' The position where the command is run.
			\|
			* '''{{cd\|this}} entity:''' The entity that is {{cd\|@s}} when the command is run.
			\|-
			\| {{cd\|command_compute_entity}}{{upcoming\|java 26.3}} \|\|
			* Used to evaluate [[Minecraft:number provider]]s by {{command\|compute entity}}.
			\|
			* '''Origin:''' The position where the command is run.
			* '''{{cd\|target_entity}}:''' The entity passed to {{command\|compute entity}}.
			\|
			* '''{{cd\|this}} entity:''' The entity that is {{cd\|@s}} when the command is run.
			\|-
			\| {{cd\|command_compute_position}}{{upcoming\|java 26.3}} \|\|
			* Used to evaluate [[Minecraft:number provider]]s by {{command\|compute block}}.
			\|
			* '''Origin:''' The position where the command is run.
			* '''Block state:''' The current state of the block at the position passed to {{command\|compute block}}.
			\|
			* '''{{cd\|this}} entity:''' The entity that is {{cd\|@s}} when the command is run.
			* '''Block entity:''' The block entity of the block passed to {{command\|compute block}}, if it was a block entity.
	\|-		\|-
	\| {{cd\|command_slot_source}}{{upcoming\|java 26.3}} \|\|		\| {{cd\|command_slot_source}}{{upcoming\|java 26.3}} \|\|
	* Used ~~internally~~ to evaluate [[Minecraft:slot sources]] by commands such as {{cmd\|item}} or {{cmd\|execute (if{{!}}unless) item}}.		* Used to evaluate [[Minecraft:slot sources]] by commands such as {{cmd\|item}} or {{cmd\|execute (if{{!}}unless) item}}.
	\|		\|
	* '''Origin:''' The position where the command is run.		* '''Origin:''' The position where the command is run.
Line 163:		Line 187:
	\|-		\|-
	\| {{cd\|selector}} \|\|		\| {{cd\|selector}} \|\|
	* Used ~~internally~~ by the {{cd\|predicate}} [[Minecraft:Target selectors\|target selector]] argument.		* Used by the {{cd\|predicate}} [[Minecraft:Target selectors\|target selector]] argument.
	\|		\|
	* '''Origin:''' The position of the entity being checked.		* '''Origin:''' The position of the entity being checked.
Line 170:		Line 194:
	\|-		\|-
	\| {{cd\|advancement_entity}} \|\|		\| {{cd\|advancement_entity}} \|\|
	* Used ~~internally~~ when an advancement invokes a predicate on an entity.		* Used when an advancement invokes a predicate on an entity.
	\|		\|
	* '''{{cd\|this}} entity:''' The entity being checked.		* '''{{cd\|this}} entity:''' The entity being checked.
Line 177:		Line 201:
	\|-		\|-
	\| {{cd\|advancement_location}}\|\|		\| {{cd\|advancement_location}}\|\|
	* Used ~~internally~~ when an advancement invokes a predicate on the location of a block where an item was used on.		* Used when an advancement invokes a predicate on the location of a block where an item was used on.
	\|		\|
	* '''{{cd\|this}} entity:''' The player to gain the advancement.		* '''{{cd\|this}} entity:''' The player to gain the advancement.
Line 187:		Line 211:
	\|-		\|-
	\| {{cd\|block_use}}\|\|		\| {{cd\|block_use}}\|\|
	* Used ~~internally~~ when an advancement invokes a predicate on {{cd\|default_block_use}} trigger.		* Used when an advancement invokes a predicate on {{cd\|default_block_use}} trigger.
	\|		\|
	* '''{{cd\|this}} entity:''' The player to gain the advancement.		* '''{{cd\|this}} entity:''' The player to gain the advancement.
Line 195:		Line 219:
	\|-		\|-
	\| {{cd\|container_process}}{{upcoming\|java 26.3}} \|\|		\| {{cd\|container_process}}{{upcoming\|java 26.3}} \|\|
	* Used ~~internally~~ by [[Minecraft:smelting]] blocks and [[Minecraft:brewing stand]]s to evaluate [[Minecraft:Data component format#cooking_fuel\|{{cd\|cooking_fuel}}]] and [[Minecraft:Data component format#brewing_fuel\|{{cd\|brewing_fuel}}]] respectively.		* Used by [[Minecraft:smelting]] blocks and [[Minecraft:brewing stand]]s to evaluate [[Minecraft:Data component format#cooking_fuel\|{{cd\|cooking_fuel}}]] and [[Minecraft:Data component format#brewing_fuel\|{{cd\|brewing_fuel}}]] respectively.
	\|		\|
	* '''Origin:''' The center of the workstation block.		* '''Origin:''' The center of the workstation block.

SyncBot: Sync: updated from Minecraft

2026-07-29T11:14:17Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 29 July 2026
Line 132:		Line 132:
	\|		\|
	* '''Block state:''' The block that was interacted with.		* '''Block state:''' The block that was interacted with.
			* '''Origin:''' The center of the block that was interacted with.{{upcoming\|java 26.3}}
	\|		\|
	* '''Block entity:''' Any block entity data of the block that was interacted with, if it is a block entity.		* '''Block entity:''' Any block entity data of the block that was interacted with, if it is a block entity.

SyncBot: Sync: updated from Minecraft

2026-07-27T11:08:25Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 27 July 2026
Line 129:		Line 129:
	* Harvesting a {{BlockLink\|beehive}}, {{BlockLink\|cave vines}}, or {{BlockLink\|sweet berry bush}}		* Harvesting a {{BlockLink\|beehive}}, {{BlockLink\|cave vines}}, or {{BlockLink\|sweet berry bush}}
	* Carving a {{BlockLink\|pumpkin}}.		* Carving a {{BlockLink\|pumpkin}}.
	* ~~Till a~~ {{BlockLink\|rooted dirt}}.{{Upcoming\|Java 26.3}}		* Tilling {{BlockLink\|rooted dirt}}.{{Upcoming\|Java 26.3}}
	\|		\|
	* '''Block state:''' The block that was interacted with.		* '''Block state:''' The block that was interacted with.
Line 247:		Line 247:
	* '''Origin''': The position of the villager or wandering trader		* '''Origin''': The position of the villager or wandering trader
	* '''{{cd\|this}} entity:''' The villager or wandering trader.		* '''{{cd\|this}} entity:''' The villager or wandering trader.
			\|
			* '''Additional cost component allowed''': Unit context. When present, causes the item modifier enchant_with_levels to generate the component {{DCL\|additional_trade_cost}} on the item.
	\|}		\|}

SyncBot: Sync: updated from Minecraft

2026-07-20T11:50:49Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:50, 20 July 2026
Line 147:		Line 147:
	\|-		\|-
	\| {{cd\|command}} \|\|		\| {{cd\|command}} \|\|
	* Used internally by commands such as {{cmd\|item modify}} or {{cmd\|execute (if{{!}}unless) predicate}}.		* Used internally to evaluate [[Minecraft:predicate]]s and [[Minecraft:item modifier]]s by commands such as {{cmd\|item modify}} or {{cmd\|execute (if{{!}}unless) predicate}}.
	\|		\|
	* '''Origin:''' The position where the command is run.		* '''Origin:''' The position where the command is run.

SyncBot: Sync: updated from Minecraft

2026-07-18T11:11:26Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 18 July 2026
Line 1:		Line 1:
	{{exclusive\|java}}		{{exclusive\|java}}

	A '''loot context''' is a set of parameters available to [[Minecraft:loot table]]s, [[Minecraft:predicate]]s, [[Minecraft:item modifier]]s, and number ~~providers~~. As different uses have different available parameters, a loot context is used to determine if a given loot table or predicate is valid to that use case, allowing this check to be done when the data pack is loaded, rather than at runtime.		A '''loot context''' is a set of parameters available to [[Minecraft:loot table]]s, [[Minecraft:predicate]]s, [[Minecraft:item modifier]]s, and [[Minecraft:number provider]]s. As different uses have different available parameters, a loot context is used to determine if a given loot table or predicate is valid to that use case, allowing this check to be done when the data pack is loaded, rather than at runtime.

	== Loot context types and uses ==		== Loot context types and uses ==
Line 129:		Line 129:
	* Harvesting a {{BlockLink\|beehive}}, {{BlockLink\|cave vines}}, or {{BlockLink\|sweet berry bush}}		* Harvesting a {{BlockLink\|beehive}}, {{BlockLink\|cave vines}}, or {{BlockLink\|sweet berry bush}}
	* Carving a {{BlockLink\|pumpkin}}.		* Carving a {{BlockLink\|pumpkin}}.
			* Till a {{BlockLink\|rooted dirt}}.{{Upcoming\|Java 26.3}}
	\|		\|
	* '''Block state:''' The block that was interacted with.		* '''Block state:''' The block that was interacted with.

SyncBot: Sync: new page from Minecraft

2026-07-17T11:11:27Z

Sync: new page from Minecraft

New page

{{exclusive|java}}

A '''loot context''' is a set of parameters available to [[Minecraft:loot table]]s, [[Minecraft:predicate]]s, [[Minecraft:item modifier]]s, and number providers. As different uses have different available parameters, a loot context is used to determine if a given loot table or predicate is valid to that use case, allowing this check to be done when the data pack is loaded, rather than at runtime.

== Loot context types and uses ==

=== Used in loot tables ===
These loot context types are used in [[Minecraft:loot tables]] and can be set as the {{nbt|string|type}} of a loot table.
{| class="wikitable" data-description="Invocation methods for predicates and loot functions"
! scope="col" | Loot context type
! scope="col" | When it is used
! scope="col" | Loot context parameters that ''are'' supplied
! scope="col" | Loot context parameters that ''may be'' supplied
|-
| {{cd|empty}} ||
* Used only by the hardcoded empty loot table. Supplies no loot context parameters.
* Specifying {{cd|"type":"empty"}} means no context parameters can be used in this loot table.
| None || None
|-
| {{cd|chest}} ||
* Opening of a container with loot table (can be {{BlockLink|barrel}}, {{BlockLink|chest}}, {{BlockLink|trapped chest}}, {{BlockLink|hopper}}, {{EntityLink|minecart with chest}}, {{EntityLink|id=oak boat with chest|boat with chest}}, {{EntityLink|minecart with hopper}}, {{BlockLink|dispenser}}, {{BlockLink|dropper}}, {{BlockLink|shulker box}}, {{BlockLink|id=shulker boxes|link=Dyed Shulker Box|dyed shulker box}}, and {{BlockLink|decorated pot}}).
* The command {{cmd|loot … loot <loot_table>}}.
|
* '''Origin:''' The center of the chest.
|
* '''{{cd|this}} entity:''' The entity that opened the chest.
|-
| {{cd|fishing}} ||
* [[Minecraft:Fishing]].
* The command {{cmd|loot … fish <loot_table>}}.
|
* '''Origin:''' The position of the fishing bobber.
* '''Tool:''' The fishing rod item that the player cast
|
* '''{{cd|this}} entity:''' The fishing bobber.
|-
| {{cd|entity}} ||
* Loot from a living entity's death.
* The command {{cmd|loot … kill <target>}}.
|
* '''{{cd|this}} entity:''' The entity that died.
* '''Origin:''' The location of the entity's death.
* '''Damage source:''' The source of the damage that caused the entity to die.
|
* '''{{cd|attacker}} entity:''' The entity that was the source of the final damage to the victim entity.
* '''{{cd|direct_attacker}} entity:''' The entity that directly contacted the victim entity to kill them.
* '''{{cd|attacking_player}} entity:''' The player that most recently damaged the victim entity.
|-
| {{cd|equipment}} ||
* Used when equipping mobs spawned from a [[Minecraft:Monster Spawner]], [[Minecraft:Minecart with Monster Spawner]] or [[Minecraft:Trial Spawner]].
|
* '''Origin:''' The position of the entity being spawned.
* '''{{cd|this}} entity:''' The entity being spawned.
|
|-
| {{cd|archaeology}} ||
* Using a [[Minecraft:brush]] on [[Minecraft:suspicious sand]] or [[Minecraft:suspicious gravel]] that has a loot table.
|
* '''Origin:''' The center of the suspicious block.
* '''{{cd|this}} entity:''' The entity that used the brush on the suspicious block.
* '''Tool:''' The tool used for brushing.
|
|-
| {{cd|vault}} ||
* Display of items inside of a {{BlockLink|vault}}.
* Opening of a {{BlockLink|vault}}.
|
* '''Origin:''' The center of the vault.
|
* '''{{cd|this}} entity:''' The entity that opened the vault. Not present for item display inside vaults.
* '''Tool:''' The item used as a key.
|-
| {{cd|gift}} ||
* Gift from a cat, villager or sniffer.
* Item laid by a chicken.
|
* '''Origin:''' The cat, villager or sniffer's location.
* '''{{cd|this}} entity:''' The cat, villager or sniffer that gave the gift. / The chicken that laid the item.
|
|-
| {{cd|barter}} ||
* [[Minecraft:Bartering]] with piglins.
|
* '''{{cd|this}} entity:''' The piglin bartered with.
|
|-
| {{cd|advancement_reward}} ||
* Loot table set as an [[Minecraft:Advancement/JSON_format|advancement's reward]].
|
* '''{{cd|this}} entity:''' The player that gained the advancement.
* '''Origin:''' The player's location when they gained the advancement.
|
|-
| {{cd|generic}} ||
* Not used. Supplies all loot context parameters.
* Specifying {{cd|"type":"generic"}} or omitting it means no checking for context parameters in this loot table when loading the data pack.
| N/A || N/A
|-
| {{cd|block}} ||
* Loot from mining a block.
* Loot from a block being exploded.
* The command {{cmd|loot … mine <pos>}}.
|
* '''Block state:''' The block that was broken.
* '''Origin:''' The center of the broken block.
* '''Tool:''' The tool used to mine the block.
|
* '''{{cd|this}} entity:''' The player that mined the block, or the entity that caused the explosion.
* '''Block entity:''' Any block entity data of the block that was broken, if it was a block entity.
* '''Explosion radius:''' The radius of the explosion that broke the block, if broken via an explosion.
|-
| {{cd|shearing}} ||
* Shearing a {{EntityLink|bogged}}, {{EntityLink|sheep}}, {{EntityLink|mooshroom}} or {{EntityLink|snow golem}}.
|
* '''Origin:''' The position of the entity being sheared.
* '''{{cd|this}} entity:''' The entity being sheared.
* '''Tool:''' The tool used for the interaction.
|
|-
| {{cd|entity_interact}} ||
* Using a [[Minecraft:brush]] on an {{EntityLink|armadillo}}.
|
* '''{{cd|target_entity}}:''' The entity being interacted with.
* '''Tool:''' The tool used for the interaction.
|
* '''{{cd|interacting_entity}}:''' The player or entity that interacted.
|-
| {{cd|block_interact}} ||
* Harvesting a {{BlockLink|beehive}}, {{BlockLink|cave vines}}, or {{BlockLink|sweet berry bush}}
* Carving a {{BlockLink|pumpkin}}.
|
* '''Block state:''' The block that was interacted with.
|
* '''Block entity:''' Any block entity data of the block that was interacted with, if it is a block entity.
* '''{{cd|interacting_entity}}:''' The player or entity that interacted.
* '''Tool:''' The tool used for the interaction.
|}

=== Only used in predicates ===
These loot contexts cannot be set at type of a loot table. Instead, they are used for other invocation of [[Minecraft:predicate]]s, [[Minecraft:item modifier]]s, [[Minecraft:slot sources]]{{upcoming|java 26.3}}, and [[Minecraft:number provider]]s{{upcoming|java 26.3}}.
{| class="wikitable" data-description="Invocation methods for predicates"
! scope="col" | Loot context type
! scope="col" | When it is used
! scope="col" | Loot context parameters that ''are'' supplied
! scope="col" | Loot context parameters that ''may be'' supplied
|-
| {{cd|command}} ||
* Used internally by commands such as {{cmd|item modify}} or {{cmd|execute (if{{!}}unless) predicate}}.
|
* '''Origin:''' The position where the command is run.
|
* '''{{cd|this}} entity:''' The entity that is {{cd|@s}} when the command is run.
|-
| {{cd|command_slot_source}}{{upcoming|java 26.3}} ||
* Used internally to evaluate [[Minecraft:slot sources]] by commands such as {{cmd|item}} or {{cmd|execute (if{{!}}unless) item}}.
|
* '''Origin:''' The position where the command is run.
* '''Container:''' The container or inventory being evaluated.
|
* '''{{cd|this}} entity:''' The entity that is {{cd|@s}} when the command is run.
|-
| {{cd|selector}} ||
* Used internally by the {{cd|predicate}} [[Minecraft:Target selectors|target selector]] argument.
|
* '''Origin:''' The position of the entity being checked.
* '''{{cd|this}} entity:''' The entity being checked.
|
|-
| {{cd|advancement_entity}} ||
* Used internally when an advancement invokes a predicate on an entity.
|
* '''{{cd|this}} entity:''' The entity being checked.
* '''Origin:''' The position of the player who triggers this advancement criterion.
|
|-
| {{cd|advancement_location}}||
* Used internally when an advancement invokes a predicate on the location of a block where an item was used on.
|
* '''{{cd|this}} entity:''' The player to gain the advancement.
* '''Origin:''' The center of the block that was interacted with.
* '''Tool:''' The item used to interact with the block.
* '''Block state:''' The block that was interacted with.
|
* '''Block entity:''' {{upcoming|java 26.3}} Any block entity data of the block at the location, if it was a block entity.
|-
| {{cd|block_use}}||
* Used internally when an advancement invokes a predicate on {{cd|default_block_use}} trigger.
|
* '''{{cd|this}} entity:''' The player to gain the advancement.
* '''Origin:''' The center of the block that was interacted with.
* '''Block state:''' The block that was interacted with.
|
|-
| {{cd|container_process}}{{upcoming|java 26.3}} ||
* Used internally by [[Minecraft:smelting]] blocks and [[Minecraft:brewing stand]]s to evaluate [[Minecraft:Data component format#cooking_fuel|{{cd|cooking_fuel}}]] and [[Minecraft:Data component format#brewing_fuel|{{cd|brewing_fuel}}]] respectively.
|
* '''Origin:''' The center of the workstation block.
* '''Block state:''' The state of the workstation block.
* '''Block entity:''' The block entity data of the workstation block.
* '''Container:''' The inventory of the workstation block.
|
|-
| {{cd|enchanted_damage}} || rowspan="5"|
* Used by enchantments invoking predicates, see {{slink|Custom enchantment|Effect components}}
|
* '''{{cd|this}} entity:''' The attacked entity.
* '''Enchantment level''': The level of the enchantment currently evaluated
* '''Origin''': Position of the event {{more info}}
* '''Damage source''': The damage source of the attack that caused the enchantment to trigger
|
* '''{{cd|attacker}} entity:''' The attacking entity.
* '''{{cd|direct_attacker}} entity:''' The projectile entity used in the attack.
|-
| {{cd|enchanted_item}}
|
* '''Tool:''' The item enchanted with the evaluated enchantment.
* '''Enchantment level''': The level of the enchantment currently evaluated
|
|-
| {{cd|enchanted_location}}
|
* '''{{cd|this}} entity:''' The attacked entity.
* '''Enchantment level''': The level of the enchantment currently evaluated
* '''Origin''': Position of the event {{more info}}
* '''Enchantment active status''': Whether the enchantment was already active before the current evaluation
|
|-
| {{cd|enchanted_entity}}
|
* '''{{cd|this}} entity:''' The attacked entity.
* '''Enchantment level''': The level of the enchantment currently evaluated
* '''Origin''': Position of the event {{more info}}
|
|-
| {{cd|hit_block}}
|
* '''{{cd|this}} entity:''' The entity that hit the block.
* '''Enchantment level''': The level of the enchantment currently evaluated
* '''Origin''': Center of the block that was hit
* '''Block state''': The block that was hit
|
|-
| {{cd|villager_trade}}
| Used for evaluating [[Minecraft:villager trade definition|villager trades]].
|
* '''Origin''': The position of the villager or wandering trader
* '''{{cd|this}} entity:''' The villager or wandering trader.
|}

== Navigation ==
{{Navbox Java Edition technical|general}}

[[Category:Data packs]]

[[Minecraft:de:Beutekontext]]
[[Minecraft:fr:Contexte de butin]]
[[Minecraft:ja:ルート文脈]]
[[Minecraft:pt:Contexto de saque]]
[[Minecraft:zh:战利品上下文]]