Loot tables are technical JSON files that are used to dictate what items should generate in various situations, such as what items should be in naturally generated containers, what items should drop when breaking a block or killing a mob, what items can be fished, and more. It does not affect dropped experience, or dropped non-item entities such as slimes from larger slimes or silverfish from infested blocks.
Contents
Usage[]
The loot tables are structured as a String tag that determines the table to use, and a Long tag determining the seed. Containers or mobs with the same seed and table drop the same items. Loot tables do not determine the container's slot to be used; that is randomly determined based on the seed.
For chests, trapped chests, hoppers, storage minecarts, minecarts with hoppers, dispensers, droppers, shulker boxes and barrels:
-
- LootTable: Loot table to be used to fill the container when it is next opened, or the items are otherwise interacted with. When the container is a chest that is part of a double chest, only the half corresponding to the tagged single-chest is affected.
- LootTableSeed: Seed for generating the loot table. Works similarly to the seeds for worlds. 0 or omitted uses a random seed.
These tags are removed once the items have been interacted with (by opening the container, breaking the container, etc.), and only then are items put in the container.
For mobs:
- The root tag.
- DeathLootTable: Loot table to be used for the items that drop when the entity is killed.
- DeathLootTableSeed: Seed for generating the loot table. Works similarly to the seeds for worlds. 0 or omitted uses a random seed.
The loot tables of mobs and containers can be altered with /execute store
and /data merge
. The player could also grant a loot table to an entity or drop it in the world with /loot
.
Tags[]
Loot tables are defined using the JSON format. Below are a list of tags used.
- Root tag
- type: Optional, specifies the context in which the loot table will be invoked by. All loot functions and conditions are then validated to ensure the context type specified here will cover all requirements of the functions and conditions, and prints a warning message in the output log if any function or condition requires a context parameter that is not covered. Valid loot context types are described below.
- functions: Invokes loot functions, in order, upon all item stacks produced by this table.
- A loot function. The JSON structure of this object is described on the Item modifiers page.
- pools: A list of all pools for this loot table. Each pool used generates items from its list of items based on the number of rolls. Pools are applied in order.
- A pool.
- conditions: A list of loot conditions that must all pass for this pool to be used.
- A loot condition. The JSON structure of this object is described on the Predicates page.
- functions: Invokes loot functions, in order, to all item stacks produced by this pool.
- A loot function. The JSON structure of this object is described on the Item modifiers page.
- rolls: A Number Provider. Specifies the number of rolls on the pool.
- bonus_rolls: A Number Provider. Specifies the number of bonus rolls on the pool per point of luck. Rounded down after multiplying.
- entries: A list of all things that can be produced by this pool. One entry is chosen per roll as a weighted random selection from all entries without failing conditions.
- An entry.
- conditions: A list of loot conditions that must all pass for this entry to be used.
- A loot condition. The JSON structure of this object is described on the Predicates page.
- functions: Invokes loot functions to the item stack(s) being produced by this entry.
- A loot function. The JSON structure of this object is described on the Item modifiers page.
- type: Namespaced ID of the type of entry. Set to one of the following values:
item
for an entry that drops a single item stack.tag
for an entry that drops item(s) from an item tag.loot_table
to produce items from another loot table.group
for a group of child entries of which all are dropped. Can be used for convenience, e.g. if one condition applies for multiple entries.alternatives
for a group of child entries of which only the first successful entry in order is dropped.sequence
for a group of child entries that are dropped in sequential order, continuing until an entry cannot be dropped, then dropping no more entries from the children.dynamic
for loot tables of typeblock
only, an entry that generates block-specific drops.empty
for an entry that generates nothing.
- name: The value of this tag depends on the type of this entry:
- For type
item
, the resource location of the item to be produced, e.g.minecraft:diamond
. The default, if not changed by loot functions, is a stack of 1 of the default instance of the item. - For type
tag
, the resource location of the item tag to query, e.g.minecraft:arrows
. - For type
loot_table
, the resource location of the loot table to be used, e.g.minecraft:gameplay/fishing/junk
. - For type
dynamic
, can becontents
to drop block entity contents orself
for banners and player skulls.
- For type
- children: A list of child entries. Can only be used when type is set to
group
,alternatives
, orsequence
. The behavior of the child entries depends on the type of the parent entry, described above.- An entry.
- expand: For type
tag
, if set totrue
, chooses one item listed in the tag, each with the same weight and quality. Iffalse
, generates one of every listing in the tag. Required when type istag
. - weight: Determines how often this entry is chosen out of all the entries in the pool. Entries with higher weights are used more often. The chance of an entry being chosen is [this entry's weight ÷ total of all considered entries' weights].
- quality: Modifies the entry's
weight
based on the luck attribute of thekiller_entity
(for loot tables of typeentity
) or thethis
entity for all other loot table types. Formula isfloor(weight + (quality × generic.luck))
.
- conditions: A list of loot conditions that must all pass for this entry to be used.
- An entry.
- conditions: A list of loot conditions that must all pass for this pool to be used.
- A pool.
Recurring JSON structures within loot tables and other data pack files[]
Loot conditions[]
Loot conditions are JSON structures that are used within loot tables to add requirements to a drop, pool, or function. They can also be used in standalone files called predicate, where they can be called upon from multiple different contexts.
The specific structure of a loot condition is shown on the Predicates page.
Loot functions[]
Loot functions are used within loot tables to apply modifications to the item stack being produced, such as adjusting the stack size or adding enchantments. They can also be used in standalone files called Item modifiers, where they can be called upon to modify items in an already existing item slot within a block or entity's inventory.
The specific structure of a loot function is shown on the Item modifiers page.
Number Providers[]
Loot tables use number providers in some places that accept an int or float. They can either be defined as a constant value or as an object.
- : Constant number provider.
- : The root tag.
- type: The number provider type.
The possible values for type and associated extra contents:
- constant—A constant value.
- value: The exact value.
- uniform—A random number following a uniform distribution between two values (inclusive).
- min: Number provider. The minimum value.
- max: Number provider. The maximum value.
- binomial—A random number following a binomial distribution
- n: Number provider. The amount of trials.
- p: Number provider. The probability of success on an individual trial.
- score—To query and use a scoreboard value.
- target: To choose which player name or entity UUID to query.
- type: Set to
fixed
to manually specify a player name or UUID. Set tocontext
to use an entity from loot context. - name: Included only if type is set to
fixed
. Specifies the name of the player, or the entity's UUID (in hypenated hexadecimal format) whose score to query. - target: Included only if type is set to
context
. Specifies an entity from loot context to query the score of. Usethis
for the invoking entity,killer
for the entity that killed the invoking entity,direct_killer
for the entity that directy killed the invoking entity, orplayer_killer
to select the killer only if they are a player.
- type: Set to
- score: The scoreboard objective to query on the selected player name or UUID.
- scale: Optional. Scale to multiply the score before returning it.
- target: To choose which player name or entity UUID to query.
Loot context types[]
Loot tables, loot conditions, and loot functions all receive context parameters upon being invoked. Depending on the method of invocation, different parameters may be supplied to them. Below is a list of all possible methods of invocation for a loot table/condition/function, and the parameter:
Loot context type | When it is used | Loot context parameters that are supplied | Loot context parameters that may be supplied |
---|---|---|---|
empty |
Supplies no loot context parameters. | None | None |
chest |
|
|
|
command |
|
| |
selector |
|
|
|
fishing |
|
||
entity |
|
|
|
gift |
|
|
|
barter |
|
|
|
advancement_reward |
|
|
|
advancement_entity |
|
| |
generic |
Not used. Supplies all loot context parameters. | N/A | N/A |
block |
|
|
|
List of vanilla loot tables[]
Below is a list of all loot tables that exist by default. More tables can be added in the world save for use with custom maps. Note that some blocks, such as bedrock, end portals and other blocks unbreakable in survival do not have loot tables, some blocks share loot tables (namely wall and floor variants of blocks) and that certain drops, namely head drops from charged creepers and the wither's nether star, are currently not covered by loot tables.[1]
- loot_tables
- blocks - items dropped when a block is broken.
- acacia_button
- acacia_door
- acacia_fence
- acacia_fence_gate
- acacia_leaves
- acacia_log
- acacia_planks
- acacia_pressure_plate
- acacia_sapling
- acacia_sign
- acacia_slab
- acacia_stairs
- acacia_trapdoor
- acacia_wood
- activator_rail
- allium
- ancient_debris
- andesite
- andesite_slab
- andesite_stairs
- andesite_wall
- anvil
- attached_melon_stem
- attached_pumpkin_stem
- azure_bluet
- bamboo
- bamboo_sapling
- barrel
- basalt
- beacon
- beehive
- bee_nest
- beetroots
- bell
- birch_button
- birch_door
- birch_fence
- birch_fence_gate
- birch_leaves
- birch_log
- birch_planks
- birch_pressure_plate
- birch_sapling
- birch_sign
- birch_slab
- birch_stairs
- birch_trapdoor
- birch_wood
- blackstone
- blackstone_slab
- blackstone_stairs
- blackstone_wall
- black_banner
- black_bed
- black_carpet
- black_concrete
- black_concrete_powder
- black_glazed_terracotta
- black_shulker_box
- black_stained_glass
- black_stained_glass_pane
- black_terracotta
- black_wool
- blast_furnace
- blue_banner
- blue_bed
- blue_carpet
- blue_concrete
- blue_concrete_powder
- blue_glazed_terracotta
- blue_ice
- blue_orchid
- blue_shulker_box
- blue_stained_glass
- blue_stained_glass_pane
- blue_terracotta
- blue_wool
- bone_block
- bookshelf
- brain_coral
- brain_coral_block
- brain_coral_fan
- brewing_stand
- brick_slab
- brick_stairs
- brick_wall
- bricks
- brown_banner
- brown_bed
- brown_carpet
- brown_concrete
- brown_concrete_powder
- brown_glazed_terracotta
- brown_mushroom
- brown_mushroom_block
- brown_shulker_box
- brown_stained_glass
- brown_stained_glass_pane
- brown_terracotta
- brown_wool
- bubble_coral
- bubble_coral_block
- bubble_coral_fan
- cactus
- cake
- campfire
- carrots
- cartography_table
- carved_pumpkin
- cauldron
- chest
- chipped_anvil
- chiseled_nether_bricks
- chiseled_polished_blackstone
- chiseled_quartz_block
- chiseled_red_standstone
- chiseled_sandstone
- chiseled_stone_brick
- chorus_flower
- chorus_plant
- clay
- coal_block
- coal_ore
- coarse_dirt
- cobblestone
- cobblestone_slab
- cobblestone_stairs
- cobblestone_wall
- cobweb
- cocoa
- comparator
- conduit
- cornflower
- cracked_nether_bricks
- cracked_polished_blackstone_bricks
- cracked_stone_bricks
- crafting_table
- creeper_head
- crimson_button
- crimson_door
- crimson_fence
- crimson_fence_gate
- crimson_fungus
- crimson_hyphae
- crimson_nylium
- crimson_planks
- crimson_pressure_plate
- crimson_roots
- crimson_sign
- crimson_slab
- crimson_stairs
- crimson_stem
- crimson_trapdoor
- crying_obsidian
- cut_red_sandstone
- cut_red_sandstone_slab
- cut_sandstone
- cut_sandstone_slab
- cyan_banner
- cyan_bed
- cyan_carpet
- cyan_concrete
- cyan_concrete_powder
- cyan_glazed_terracotta
- cyan_shulker_box
- cyan_stained_glass
- cyan_stained_glass_pane
- cyan_terracotta
- cyan_wool
- damaged_anvil
- dandelion
- dark_oak_button
- dark_oak_door
- dark_oak_fence
- dark_oak_fence_gate
- dark_oak_leaves
- dark_oak_log
- dark_oak_planks
- dark_oak_pressure_plate
- dark_oak_sapling
- dark_oak_sign
- dark_oak_slab
- dark_oak_stairs
- dark_oak_trapdoor
- dark_oak_wood
- dark_prismarine
- dark_prismarine_slab
- dark_prismarine_stairs
- daylight_detector
- dead_brain_coral
- dead_brain_coral_block
- dead_brain_coral_fan
- dead_bubble_coral
- dead_bubble_coral_block
- dead_bubble_coral_fan
- dead_bush
- dead_fire_coral
- dead_fire_coral_block
- dead_fire_coral_fan
- dead_horn_coral
- dead_horn_coral_block
- dead_horn_coral_fan
- dead_tube_coral
- dead_tube_coral_block
- dead_tube_coral_fan
- detector_rail
- diamond_block
- diamond_ore
- diorite
- diorite_slab
- diorite_stairs
- diorite_wall
- dirt
- dispenser
- dragon_egg
- dragon_head
- dried_kelp_block
- dropper
- emerald_block
- emerald_ore
- enchanting_table
- end_rod
- end_stone
- end_stone_bricks
- end_stone_brick_slab
- end_stone_brick_stairs
- end_stone_brick_wall
- ender_chest
- farmland
- fern
- fire_coral
- fire_coral_block
- fire_coral_fan
- fletching_table
- flower_pot
- frosted_ice
- furnace
- glass
- glass_pane
- glowstone
- gold_block
- gold_ore
- granite
- granite_slab
- granite_stairs
- granite_wall
- grass
- grass_block
- grass_path
- gravel
- gray_banner
- gray_bed
- gray_carpet
- gray_concrete
- gray_concrete_powder
- gray_glazed_terracotta
- gray_shulker_box
- gray_stained_glass
- gray_stained_glass_pane
- gray_terracotta
- gray_wool
- green_banner
- green_bed
- green_carpet
- green_concrete
- green_concrete_powder
- green_glazed_terracotta
- green_shulker_box
- green_stained_glass
- green_stained_glass_pane
- green_terracotta
- green_wool
- grindstone
- hay_block
- heavy_weighted_pressure_plate
- honey_block
- honeycomb_block
- hopper
- horn_coral
- horn_coral_block
- horn_coral_fan
- ice
- infested_chiseled_stone_bricks
- infested_cobblestone
- infested_cracked_stone_bricks
- infested_mossy_stone_bricks
- infested_stone
- infested_stone_bricks
- iron_bars
- iron_block
- iron_door
- iron_ore
- iron_trapdoor
- jack_o_lantern
- jukebox
- jungle_button
- jungle_door
- jungle_fence
- jungle_fence_gate
- jungle_leaves
- jungle_log
- jungle_planks
- jungle_pressure_plate
- jungle_sapling
- jungle_sign
- jungle_slab
- jungle_stairs
- jungle_trapdoor
- jungle_wood
- kelp
- kelp_plant
- ladder
- lantern
- lapis_block
- lapis_ore
- large_fern
- lectern
- lever
- light_blue_banner
- light_blue_bed
- light_blue_carpet
- light_blue_concrete
- light_blue_concrete_powder
- light_blue_glazed_terracotta
- light_blue_shulker_box
- light_blue_stained_glass
- light_blue_stained_glass_pane
- light_blue_terracotta
- light_blue_wool
- light_gray_banner
- light_gray_bed
- light_gray_carpet
- light_gray_concrete
- light_gray_concrete_powder
- light_gray_glazed_terracotta
- light_gray_shulker_box
- light_gray_stained_glass
- light_gray_stained_glass_pane
- light_gray_terracotta
- light_gray_wool
- light_weighted_pressure_plate
- lilac
- lily_of_the_valley
- lily_pad
- lime_banner
- lime_bed
- lime_carpet
- lime_concrete
- lime_concrete_powder
- lime_glazed_terracotta
- lime_shulker_box
- lime_stained_glass
- lime_stained_glass_pane
- lime_terracotta
- lime_wool
- lodestone
- loom
- magenta_banner
- magenta_bed
- magenta_carpet
- magenta_concrete
- magenta_concrete_powder
- magenta_glazed_terracotta
- magenta_shulker_box
- magenta_stained_glass
- magenta_stained_glass_pane
- magenta_terracotta
- magenta_wool
- magma_block
- melon
- melon_stem
- mossy_cobblestone
- mossy_cobblestone_slab
- mossy_cobblestone_stairs
- mossy_cobblestone_wall
- mossy_stone_bricks
- mossy_stone_brick_slab
- mossy_stone_brick_stairs
- mossy_stone_brick_wall
- mushroom_stem
- mycelium
- netherite_block
- netherrack
- nether_bricks
- nether_brick_fence
- nether_brick_slab
- nether_brick_stairs
- nether_brick_wall
- nether_gold_ore
- nether_portal
- nether_quartz_ore
- nether_sprouts
- nether_wart
- nether_wart_block
- note_block
- oak_button
- oak_door
- oak_fence
- oak_fence_gate
- oak_leaves
- oak_log
- oak_planks
- oak_pressure_plate
- oak_sapling
- oak_sign
- oak_slab
- oak_stairs
- oak_trapdoor
- oak_wood
- observer
- obsidian
- orange_banner
- orange_bed
- orange_carpet
- orange_concrete
- orange_concrete_powder
- orange_glazed_terracotta
- orange_shulker_box
- orange_stained_glass
- orange_stained_glass_pane
- orange_terracotta
- orange_tulip
- orange_wool
- oxeye_daisy
- packed_ice
- peony
- petrified_oak_slab
- pink_banner
- pink_bed
- pink_carpet
- pink_concrete
- pink_concrete_powder
- pink_glazed_terracotta
- pink_shulker_box
- pink_stained_glass
- pink_stained_glass_pane
- pink_terracotta
- pink_tulip
- pink_wool
- piston
- player_head
- podzol
- polished_andesite
- polished_andesite_slab
- polished_andesite_stairs
- polished_basalt
- polished_blackstone
- polished_blackstone_bricks
- polished_blackstone_brick_slab
- polished_blackstone_brick_stairs
- polished_blackstone_brick_wall
- polished_blackstone_button
- polished_blackstone_pressure_plate
- polished_blackstone_slab
- polished_blackstone_stairs
- polished_blackstone_wall
- polished_diorite
- polished_diorite_slab
- polished_diorite_stairs
- polished_granite
- polished_granite_slab
- polished_granite_stairs
- poppy
- potatoes
- potted_acacia_sapling
- potted_allium
- potted_azure_bluet
- potted_bamboo
- potted_birch_sapling
- potted_blue_orchid
- potted_brown_mushroom
- potted_cactus
- potted_cornflower
- potted_crimson_fungus
- potted_crimson_roots
- potted_dandelion
- potted_dark_oak_sapling
- potted_dead_bush
- potted_fern
- potted_jungle_sapling
- potted_lily_of_the_valley
- potted_oak_sapling
- potted_orange_tulip
- potted_oxeye_daisy
- potted_pink_tulip
- potted_poppy
- potted_red_mushroom
- potted_red_tulip
- potted_spruce_sapling
- potted_warped_fungus
- potted_warped_roots
- potted_white_tulip
- potted_wither_rose
- powered_rail
- prismarine
- prismarine_bricks
- prismarine_brick_slab
- prismarine_brick_stairs
- prismarine_slab
- prismarine_stairs
- prismarine_wall
- pumpkin
- pumpkin_stem
- purple_banner
- purple_bed
- purple_carpet
- purple_concrete
- purple_concrete_powder
- purple_glazed_terracotta
- purple_shulker_box
- purple_stained_glass
- purple_stained_glass_pane
- purple_terracotta
- purple_wool
- purpur_block
- purpur_pillar
- purpur_slab
- purpur_stairs
- quartz_block
- quartz_bricks
- quartz_pillar
- quartz_slab
- quartz_stairs
- rail
- red_banner
- red_bed
- red_carpet
- red_concrete
- red_concrete_powder
- red_glazed_terracotta
- red_mushroom
- red_mushroom_block
- red_nether_bricks
- red_nether_brick_slab
- red_nether_brick_stairs
- red_nether_brick_wall
- red_sand
- red_sandstone
- red_sandstone_slab
- red_sandstone_stairs
- red_sandstone_wall
- red_shulker_box
- red_stained_glass
- red_stained_glass_pane
- red_terracotta
- red_tulip
- red_wool
- redstone_block
- redstone_lamp
- redstone_ore
- redstone_torch
- redstone_wire
- repeater
- respawn_anchor
- rose_bush
- sand
- sandstone
- sandstone_slab
- sandstone_stairs
- sandstone_wall
- scaffolding
- seagrass
- sea_lantern
- sea_pickle
- shroomlight
- shulker_box
- skeleton_skull
- slime_block
- smithing_table
- smoker
- smooth_quartz
- smooth_quartz_slab
- smooth_quartz_stairs
- smooth_red_sandstone
- smooth_red_sandstone_slab
- smooth_red_sandstone_stairs
- smooth_sandstone'
- smooth_sandstone_slab
- smooth_sandstone_stairs
- smooth_stone
- smooth_stone_slab
- snow
- snow_block
- soul_campfire
- soul_fire
- soul_lantern
- soul_sand
- soul_soil
- soul_torch
- spawner
- sponge
- spruce_button
- spruce_door
- spruce_fence
- spruce_fence_gate
- spruce_leaves
- spruce_log
- spruce_planks
- spruce_pressure_plate
- spruce_sapling
- spruce_sign
- spruce_slab
- spruce_stairs
- spruce_trapdoor
- spruce_wood
- sticky_piston
- stone
- stonecutter
- stone_bricks
- stone_brick_slab
- stone_brick_stairs
- stone_brick_wall
- stone_button
- stone_pressure_plate
- stone_slab
- stone_stairs
- stripped_acacia_log
- stripped_acacia_wood
- stripped_birch_log
- stripped_birch_wood
- stripped_crimson_hyphae
- stripped_crimson_stem
- stripped_dark_oak_log
- stripped_dark_oak_wood
- stripped_jungle_log
- stripped_jungle_wood
- stripped_oak_log
- stripped_oak_wood
- stripped_spruce_log
- stripped_spruce_wood
- stripped_warped_hyphae
- stripped_warped_stem
- sugar_cane
- sunflower
- sweet_berry_bush
- tall_grass
- tall_seagrass
- terracotta
- tnt
- torch
- trapped_chest
- tripwire
- tripwire_hook
- tube_coral
- tube_coral_block
- tube_coral_fan
- turtle_egg
- twisting_vines
- twisting_vines_plant
- vine
- warped_button
- warped_door
- warped_fence
- warped_fence_gate
- warped_fungus
- warped_hyphae
- warped_nylium
- warped_planks
- warped_pressure_plate
- warped_roots
- warped_sign
- warped_slab
- warped_stairs
- warped_stem
- warped_trapdoor
- warped_wart_block
- weeping_vines
- weeping_vines_plant
- wet_sponge
- wheat
- white_banner
- white_bed
- white_carpet
- white_concrete
- white_concrete_powder
- white_glazed_terracotta
- white_shulker_box
- white_stained_glass
- white_stained_glass_pane
- white_terracotta
- white_tulip
- white_wool
- wither_rose
- wither_skeleton_skull
- yellow_banner
- yellow_bed
- yellow_carpet
- yellow_concrete
- yellow_concrete_powder
- yellow_glazed_terracotta
- yellow_shulker_box
- yellow_stained_glass
- yellow_stained_glass_pane
- yellow_terracotta
- yellow_wool
- zombie_head
- chests - Items from loot chests
- abandoned_mineshaft - Minecarts with chests found in mineshafts
- bastion_bridge - Chest found in the bridge variant of the Bastion Remnant
- bastion_hoglin_stable - Chest found in the hoglin stables variant of the Bastion Remnant
- bastion_other - The generic Bastion Remnant chest
- bastion_treasure - Chest found in the treasure variant of the Bastion Remnant
- buried_treasure - Chests found by following buried treasure explorer maps
- desert_pyramid - Chests found in the treasure room inside desert temples
- end_city_treasure - Chests found in End cities
- igloo_chest - The chest that appears in the basements in igloos
- jungle_temple - Chests found inside jungle temples
- jungle_temple_dispenser - Dispensers found inside jungle temples
- nether_bridge - Chests found in Nether fortresses
- pillager_outpost Chests found at the top of Pillager outposts
- ruined_portal - Chest found accompanying Ruined Portals
- shipwreck_map - Chests found in shipwrecks that can include a treasure map
- shipwreck_supply - Supply chests found in shipwrecks
- shipwreck_treasure - Treasure chests found in shipwrecks
- simple_dungeon - Dungeon chests
- spawn_bonus_chest - Bonus chests that appear in a new world when bonus chests are enabled
- stronghold_corridor - Chests found on slab altars in corridors in strongholds
- stronghold_crossing - The chest in the upper level of store rooms in strongholds
- stronghold_library - Chests found in a library in strongholds
- underwater_ruin_big - Chests found in the big variant of underwater ruins
- underwater_ruin_small - Chests found in the small variant of underwater ruins
- woodland_mansion - chests found in a woodland mansion.
- village - Chests found in villages since the Village & Pillage update.
- village_armorer - Chest found in a village armorer house.
- village_butcher - Chest found in a village butcher house.
- village_cartographer - Chest found in a village cartographer house.
- village_mason - Chest found in a village mason house.
- village_shepherd - Chest found in a village shepherd house.
- village_tannery - Chest found in a village tannery house.
- village_weaponsmith - Chest found in a village weaponsmith house.
- village_desert_house- Chest found in a village desert house.
- village_plains_house - Chest found in a village plains house.
- village_savanna_house Chest found in a savanna village house.
- village_snowy_house - Chest found in a snowy village house.
- village_taiga_house - Chest found in a taiga village house.
- village_fisher
- village_fletcher
- village_temple
- village_toolsmith
- entities - Items dropped from entities. May cause issues when applied to chests, due to some items spawning in stacks of 0
- sheep - Sheep with wool
- black
- blue
- brown
- cyan
- gray
- green
- light_blue
- light_gray
- lime
- magenta
- orange
- pink
- purple
- red
- white
- yellow
- armor_stand
- bat
- blaze
- cat
- cave_spider
- chicken
- cod
- cow
- creeper
- donkey
- dolphin
- drowned
- elder_guardian
- ender_dragon
- enderman
- endermite
- evoker
- ghast
- giant
- guardian
- hoglin
- horse
- husk
- illusioner
- iron_golem
- llama
- magma_cube
- mooshroom
- mule
- ocelot
- panda
- parrot
- phantom
- pig
- piglin
- pillager
- player
- polar_bear
- pufferfish
- rabbit
- ravager
- salmon
- sheep - Sheep without wool, also inherited by sheep with wool
- shulker
- silverfish
- skeleton
- skeleton_horse
- slime
- snow_golem
- spider
- squid
- stray
- strider
- trader_llama
- tropical_fish
- turtle
- vex
- villager
- vindicator
- wandering_trader
- witch
- wither
- wither_skeleton
- wolf
- zoglin
- zombie
- zombie_horse
- zombie_villager
- zombified_piglin
- sheep - Sheep with wool
- gameplay
- cat_morning_gift
- fishing
- fish - Also inherited by guardians and elder guardians
- junk
- treasure
- fishing - Used to determine loot from fishing by loading the three tables from the fishing folder and applying luck to each one
- hero_of_the_village
- armorer_gift
- butcher_gift
- cartographer_gift
- cleric_gift
- farmer_gift
- fisherman_gift
- fletcher_gift
- leatherworker_gift
- librarian_gift
- mason_gift
- shepherd_gift
- toolsmith_gift
- weaponsmith_gift
- piglin_bartering
- blocks - items dropped when a block is broken.
Data packs[]
Custom data packs use loot tables to change what loot can spawn in containers or drop by mobs. They can either change existing loot tables or create new ones. This is the file structure:
- world save folder
- datapacks
- data pack
- data
- minecraft
- loot_tables
- custom_namespace
- loot_tables
- loot table name.json
- loot_tables
- minecraft
- data
- data pack
- datapacks
The JSON files go in this folder. Vanilla loot tables are grouped into 4 categories: gameplay
(fishing), entities
, blocks
, and chests
, with some tables being in subfolders of those. For example, the file for zombies would go in datapacks/pack name/data/minecraft/loot_tables/entities/zombie.json
. This makes every zombie in that world use the datapack's loot table rather than the default zombie loot table.
Loot tables are namespaced. To create a custom loot table, first create a new folder for the custom namespace, and then create loot tables within following a similar structure. Then, summon the mob with the data tag DeathLootTable set to the name of the directory and file (without the .json extension), such as DeathLootTable:"custom_namespace:path/to/table"
.
History[]
Java Edition | |||||
---|---|---|---|---|---|
1.9 | October 19, 2015 | Dinnerbone announces loot tables. | |||
15w43a | Added loot tables. | ||||
15w43b | Added condition entity_scores. | ||||
15w43c | Renamed "villager_golem.json" to "iron_golem.json" | ||||
Added fishing loot tables, sheep without wool, and zombie and skeleton horses. | |||||
Renamed the tag item: to name:, and the tag items: to entries: | |||||
Added the tag type: and support to load a loot table instead of an item. | |||||
Added the tag luck: to default files, though it currently does nothing in the code. | |||||
Added the function set_damage. | |||||
15w44a | Added the function enchant_randomly and set_attributes. | ||||
15w44b | Added the quality tag. | ||||
Removed luck and luck_multiplier tags. | |||||
Added the bonus_rolls tag. | |||||
15w51a | A player in spectator mode no longer triggers a container to use its loot table to generate loot. | ||||
1.9.1 | pre1 | Loot tables now work with dispensers and droppers. | |||
Added default table chests/jungle_temple_dispenser . | |||||
1.11 | 16w32a | Donkeys, mules, husks and zombie villagers now each draw from their own loot tables, rather than drawing from the horse and zombie loot tables, respectively | |||
16w43a | Villagers, vexes and ender dragons are now able to draw from their own loot tables. | ||||
1.13 | 17w43a | Custom loot tables have been moved into data packs. | |||
1.14 | 18w43a | Block drops have been changed to use loot tables too. | |||
Loot tables received a bunch of new options. | |||||
Setting entity to "this" now refers to the player in chest and block loot tables. | |||||
18w44a | Added loot tables for cats, cat_morning_gift, players and withers. | ||||
Added loot tables for new blocks. | |||||
Added the function set_lore. | |||||
18w46a | Added loot table for illusioners. | ||||
18w48a | Added more loot tables for villages, some of which are currently unused. | ||||
Removed loot table: village_blacksmith. | |||||
18w49a | village_savanna_house and village_snowy_house loot tables are now used. | ||||
Added more loot tables for villages. | |||||
18w50a | village_desert_house and village_taiga_house loot tables are now used, making all previously unused loot tables no longer unused. | ||||
? | Empty loot table is now hardcoded. | ||||
1.15 | 19w34a | Added the function copy_state. | |||
1.16 | 20w12a | Added fishing_hook sub-predicate to check properties of the fishing hook. |
Issues[]
Issues relating to "Loot table" are maintained on the bug tracker. Report issues there.
References[]
Components |
|
---|---|
Data packs | |
Tutorials |