Minecraft:Loot context

A loot context is a set of parameters available to Minecraft:loot tables, Minecraft:predicates, Minecraft:item modifiers, and Minecraft: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 Template:Nbt of a loot table.

Loot context type	When it is used	Loot context parameters that are supplied	Loot context parameters that may be supplied
Template:Cd	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:Cd	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:Cd	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:Cd	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:Cd	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:Cd	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:Cd	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:Cd	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:Cd	Minecraft:Bartering with piglins.	Template:Cd entity: The piglin bartered with.
Template:Cd	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:Cd	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:Cd	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:Cd	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:Cd	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:Cd	Harvesting a Template:BlockLink, Template:BlockLink, or Template:BlockLink Carving a Template:BlockLink. Tilling Template:BlockLink.Template:Upcoming	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. Template:Cd: 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:predicates, Minecraft:item modifiers, Minecraft:slot sourcesTemplate:Upcoming, and Minecraft:number providersTemplate:Upcoming.

Loot context type	When it is used	Loot context parameters that are supplied	Loot context parameters that may be supplied
Template:Cd	Used internally 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:CdTemplate:Upcoming	Used internally 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:Cd	Used internally by the Template:Cd target selector argument.	Origin: The position of the entity being checked. Template:Cd entity: The entity being checked.
Template:Cd	Used internally 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:Cd	Used internally 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: Template:Upcoming Any block entity data of the block at the location, if it was a block entity.
Template:Cd	Used internally 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:CdTemplate:Upcoming	Used internally 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:Cd	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:Cd		Tool: The item enchanted with the evaluated enchantment. Enchantment level: The level of the enchantment currently evaluated
Template:Cd		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:Cd		Template:Cd entity: The attacked entity. Enchantment level: The level of the enchantment currently evaluated Origin: Position of the event Template:More info
Template:Cd		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:Cd	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.