Minecraft:Loot context

A loot context is a set of parameters available to Minecraft:loot tables, Minecraft:predicates, Minecraft:item modifiers, Minecraft:number providers, and Minecraft:slot sources.

When evaluating these data types in different situations, different parameters will be available. For example, a loot table that runs when the player mines a block would get a tool parameter if the player used an item to do it, but a loot table that populates a treasure chest would never get a tool parameter. Loot contexts are Minecraft:identifiers describing which parameters are available in specific situations. If one is set as the Template:Nbt of a loot table, it can be used to check whether the loot table depends on parameters that will never be available in its intended use case, allowing the game to report a problem when the Minecraft:data pack is loaded.

Loot context types and uses

Used for loot tables

These loot context types are used for evaluating Minecraft:loot tables, and other data types when they appear inside of loot tables.

Loot context type	When it is used	Loot context parameters that are supplied	Loot context parameters that may be supplied
Template:Cdanchor	Used only by the hardcoded empty loot table. Supplies no loot context parameters. Specifying Template:Cd means no context parameters can be used in this loot table.	None	None
Template:Cdanchor	Opening of a container with loot table (can be Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:EntityLink, Template:EntityLink, Template:EntityLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, Template:BlockLink, and Template:BlockLink). The command Template:Cmd.	Origin: The center of the chest.	Template:Cd entity: The entity that opened the chest.
Template:Cdanchor	Minecraft:Fishing. The command Template:Cmd.	Origin: The position of the fishing bobber. Tool: The fishing rod item that the player cast	Template:Cd entity: The fishing bobber.
Template:Cdanchor	Loot from a living entity's death. The command Template:Cmd.	Template:Cd 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.	Template:Cd entity: The entity that was the source of the final damage to the victim entity. Template:Cd entity: The entity that directly contacted the victim entity to kill them. Template:Cd entity: The player that most recently damaged the victim entity.
Template:Cdanchor	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. Template:Cd entity: The entity being spawned.
Template:Cdanchor	Using a Minecraft:brush on Minecraft:suspicious sand or Minecraft:suspicious gravel that has a loot table.	Origin: The center of the suspicious block. Template:Cd entity: The entity that used the brush on the suspicious block. Tool: The tool used for brushing.
Template:Cdanchor	Display of items inside of a Template:BlockLink. Opening of a Template:BlockLink.	Origin: The center of the vault.	Template:Cd entity: The entity that opened the vault. Not present for item display inside vaults. Tool: The item used as a key.
Template:Cdanchor	Gift from a cat, villager or sniffer. Item laid by a chicken.	Origin: The cat, villager or sniffer's location. Template:Cd entity: The cat, villager or sniffer that gave the gift. / The chicken that laid the item.
Template:Cdanchor	Minecraft:Bartering with piglins.	Template:Cd entity: The piglin bartered with.
Template:Cdanchor	Loot table set as an advancement's reward.	Template:Cd entity: The player that gained the advancement. Origin: The player's location when they gained the advancement.
Template:Cdanchor	Not used. Supplies all loot context parameters. Specifying Template:Cd or omitting it means no checking for context parameters in this loot table when loading the data pack.	N/A	N/A
Template:Cdanchor	Loot from mining a block. Loot from a block being exploded. The command Template:Cmd.	Block state: The block that was broken. Origin: The center of the broken block. Tool: The tool used to mine the block.	Template:Cd 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.
Template:Cdanchor	Shearing a Template:EntityLink, Template:EntityLink, Template:EntityLink or Template:EntityLink.	Origin: The position of the entity being sheared. Template:Cd entity: The entity being sheared. Tool: The tool used for the interaction.
Template:Cdanchor	Using a Minecraft:brush on an Template:EntityLink.	Template:Cd: The entity being interacted with. Tool: The tool used for the interaction.	Template:Cd: The player or entity that interacted.
Template:Cdanchor	Harvesting a Template:BlockLink, Template:BlockLink, or Template:BlockLink Carving a Template:BlockLink. Tilling Template:BlockLink.	Block state: The block that was interacted with. Origin: The center of 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. Template:Cd: The player or entity that interacted. Tool: The tool used for the interaction.

Not used in loot tables

These loot contexts are not used to evaluate loot tables. Instead, they are used for other invocations of Minecraft:predicates, Minecraft:item modifiers, Minecraft:slot sources, and Minecraft:number providers.

Loot context type	When it is used	Loot context parameters that are supplied	Loot context parameters that may be supplied
Template:Cdanchor	Used to evaluate Minecraft:predicates and Minecraft:item modifiers by commands such as Template:Cmd or Template:Cmd.	Origin: The position where the command is run.	Template:Cd entity: The entity that is Template:Cd when the command is run.
Template:Cdanchor	Used to evaluate Minecraft:number providers by Template:Command.	Origin: The position where the command is run.	Template:Cd entity: The entity that is Template:Cd when the command is run.
Template:Cdanchor	Used to evaluate Minecraft:number providers by Template:Command.	Origin: The position where the command is run. Template:Cd: The entity passed to Template:Command.	Template:Cd entity: The entity that is Template:Cd when the command is run.
Template:Cdanchor	Used to evaluate Minecraft:number providers by Template:Command.	Origin: The position where the command is run. Block state: The current state of the block at the position passed to Template:Command.	Template:Cd entity: The entity that is Template:Cd when the command is run. Block entity: The block entity of the block passed to Template:Command, if it was a block entity.
Template:Cdanchor	Used to evaluate Minecraft:slot sources by commands such as Template:Cmd or Template:Cmd.	Origin: The position where the command is run. Container: The container or inventory being evaluated.	Template:Cd entity: The entity that is Template:Cd when the command is run.
Template:Cdanchor	Used by the Template:Cd target selector argument.	Origin: The position of the entity being checked. Template:Cd entity: The entity being checked.
Template:Cdanchor	Used when an advancement invokes a predicate on an entity.	Template:Cd entity: The entity being checked. Origin: The position of the player who triggers this advancement criterion.
Template:Cdanchor	Used when an advancement invokes a predicate on the location of a block where an item was used on.	Template:Cd 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: Any block entity data of the block at the location, if it was a block entity.
Template:Cdanchor	Used when an advancement invokes a predicate on Template:Cd trigger.	Template:Cd 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.
Template:Cdanchor	Used by Minecraft:smelting blocks and Minecraft:brewing stands to evaluate [[Minecraft:Data component format#cooking_fuel|Template:Cd]] and [[Minecraft:Data component format#brewing_fuel|Template:Cd]] 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.
Template:Cdanchor	Used by enchantments invoking predicates, see Template:Slink	Template:Cd entity: The attacked entity. Enchantment level: The level of the enchantment currently evaluated Origin: Position of the event Template:More info Damage source: The damage source of the attack that caused the enchantment to trigger	Template:Cd entity: The attacking entity. Template:Cd entity: The projectile entity used in the attack.
Template:Cdanchor		Tool: The item enchanted with the evaluated enchantment. Enchantment level: The level of the enchantment currently evaluated
Template:Cdanchor		Template:Cd entity: The attacked entity. Enchantment level: The level of the enchantment currently evaluated Origin: Position of the event Template:More info Enchantment active status: Whether the enchantment was already active before the current evaluation
Template:Cdanchor		Template:Cd entity: The attacked entity. Enchantment level: The level of the enchantment currently evaluated Origin: Position of the event Template:More info
Template:Cdanchor		Template:Cd 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
Template:Cdanchor	Used for evaluating villager trades.	Origin: The position of the villager or wandering trader Template:Cd 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 Template:DCL on the item.