Loot tables are upcoming technical JSON tables that represent what items should be in a naturally generated chest, what items should drop when killing a mob, or what items can be fished.
Usage
The loot tables are structured as a String tag which determines the table to use, and a Long tag determining the seed. Chests or mobs with the same seed and table will drop the same items. Loot tables do not determine which slot of a chest is used; that is randomly determined based on the seed.
For Chests, Trapped Chests and Storage Minecarts:
-
- LootTable: Loot table to be used to fill the chest when it is next opened, or the items are otherwise interacted with. When the chest is part of a double chest, only the half corresponding to the tagged single-chest will be affected.
- LootTableSeed: Seed for generating the loot table. 0 or omitted will use a random seed.
These tags will be removed once the items have been interacted with (by opening the chest, breaking the chest, etc.), and only then will items be put in the chest.
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. 0 or omitted will use a random seed.
The loot tables of Mobs and Chests can be altered with /entitydata and /blockdata.
Tags
Loot tables are defined using the JSON format. Below are a list of tags used.
- The root tag
- pools: A list of all pools for this entity. Each pool used will generate items from its list of items based on the number of rolls. Pools are applied in order.
- A pool
- conditions: Determines conditions for this pool to be used. If multiple conditions are specified, all must pass.
- A condition
- condition: Name of condition. Valid conditions are described below.
- A condition
- rolls: Specifies the exact number of rolls on the pool.
- rolls: Specifies a random number of rolls within a range.
- min: Minimum number of rolls.
- max: Maximum number of rolls.
- 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: Determines conditions for this entry to be used. If multiple conditions are specified, all must pass.
- A condition
- condition: Name of condition. Valid conditions are described below.
- A condition
- type: Type of entry. Can be
itemfor item entries,loot_tableto produce items from another loot table, oremptyfor an entry that generates nothing. - name:
- For type 'item', ID name of the item to be produced, e.g.
minecraft:diamond. The default, if not changed byfunctions, is a stack of 1 of the default instance of the item. - For type 'loot_table', loot table to be used, e.g.
minecraft:gameplay/fishing/junk.
- For type 'item', ID name of the item to be produced, e.g.
- functions: For type 'item', applies functions to the item stack being produced. Functions are applied in order, so for example
looting_enchantmust be afterset_countto work correctly. - weight: Determines how often this entry will be chosen out of all the entries in the pool. Entries with higher weights will be used more often (chance is this entry's weight⁄total of all considered entries' weights).
- luck: Unused, but set in the built-in fishing.json. Possibly intended to be
luck_multiplier. - luck_multiplier: Increases the entry's
weightbased on luck being applied to this application of the loot table, formula isfloor( weight + weight * luck_multiplier * luck ). Currently, luck is only set (to the level of the Luck of the Sea enchantment) when fishing, and is not passed throughloot_tableentries.
- conditions: Determines conditions for this entry to be used. If multiple conditions are specified, all must pass.
- An entry
- conditions: Determines conditions for this pool to be used. If multiple conditions are specified, all must pass.
- A pool
- pools: A list of all pools for this entity. Each pool used will generate items from its list of items based on the number of rolls. Pools are applied in order.
Functions
Loot tables use various functions to change the item stack being produced, such as adjusting the stack size or adding enchantments. Below are a list of valid functions, and the tags used by them. The tags are placed in the same function object as function:.
- enchant_with_levels - Enchants the item, with the specified enchantment level (roughly equivalent to using an enchantment table at that level).
- treasure: Determines whether treasure enchantments are allowed on this item.
- levels: Specifies the exact enchantment level to use.
- levels: Specifies a random enchantment level within a range.
- min: Minimum level to use.
- max: Maximum level to use.
- furnace_smelt - Smelts the item as it would be in a furnace. Used in combination with the
entity_propertiescondition to cook food for animals on death. - looting_enchant - Adjusts the stack size based on the level of the Looting enchantment on the
killerentity.- count: Specifies an exact number of additional items per level of looting.
- count: Specifies a random number (within a range) of additional items per level of looting. Note the random number generated may be fractional, and will be rounded after multiplying by the looting level.
- min: Minimum increase.
- max: Maximum increase.
- set_count - Sets the stack size.
- count: Specifies the exact stack size to set.
- count: Specifies a random stack size within a range.
- min: Minimum stack size.
- max: Maximum stack size.
- set_damage - Sets the item's damage value (durability) for tools.
- damage: Specifies the damage fraction to set (1.0 is undamaged, 0.0 is zero durability left).[verify]
- damage: Specifies a random damage fraction within a range.
- min: Minimum value.
- max: Maximum value.
- set_data - Sets the item data value of the item.
- data: Specifies the exact value to set.
- data: Specifies a random value within a range.
- min: Minimum value.
- max: Maximum value.
- set_nbt - Adds NBT data to an item.
- tag: Tag string to add, similar to those used by commands. Note that the first bracket is required and quotation marks need to be escaped using a backslash (
\).
- tag: Tag string to add, similar to those used by commands. Note that the first bracket is required and quotation marks need to be escaped using a backslash (
Conditions
Loot tables use various conditions which add requirements to a drop, pool, or function. Below are a list of valid conditions, and the tags used by them. The tags are placed in the same condition object as condition:.
- entity_properties - Test properties of an entity.
- entity: Specifies the entity to check for the condition. Set to
thisto use the entity that died,killerfor the killer, orkiller_playerfor a killer that is a player. - properties: Properties to be checked.
- on_fire: Test whether the entity is or is not on fire.
- entity: Specifies the entity to check for the condition. Set to
- entity_scores - Test the scoreboard scores of an entity.
- entity: Specifies the entity to check for the condition. Set to
thisto use the entity that died,killerfor the killer, orkiller_playerfor a killer that is a player. - scores: Scores to check. All specifies scores must pass for the condition to pass.
- A score: Key name is the objective while the value is the exact score value required for the condition to pass. Note that this is broken as of 15w43b.[verify]
- A score: Key name is the objective while the value specifies a range of score values required for the condition to pass. Note that only the minimum score works as of 15w43b.[verify]
- min: Minimum score.
- max: Maximum score.
- entity: Specifies the entity to check for the condition. Set to
- killed_by_player - Test if a
killer_playerentity is available.- inverse: If true, the condition passes if
killer_playeris not available.
- inverse: If true, the condition passes if
- random_chance - Test if a random number 0.0–1.0 is less than a specified value.
- chance: Success rate as a number 0.0–1.0.
- random_chance_with_looting - Test if a random number 0.0–1.0 is less than a specified value, affected by the level of Looting on the
killerentity.- chance: Base success rate.
- looting_multiplier: Looting adjustment to the base success rate. Formula is
chance + looting_level * looting_multiplier.
List of 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.
- loot_tables
- chests - Items from loot chests
- abandoned_mineshaft - Minecarts with chests found in abandoned mine shafts
- 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
- nether_bridge - Chests found in Nether Fortresses
- 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
- village_blacksmith - The chest found in the Blacksmith's house in a Village
- 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, also inherited by colored sheep
- black
- blue
- brown
- cyan
- gray
- green
- light_blue
- lime
- magenta
- orange
- pink
- purple
- red
- silver
- white
- yellow
- bat
- blaze
- cave_spider
- chicken
- cow
- creeper
- elder_guardian
- enderman
- endermite
- ghast
- giant
- guardian
- horse
- iron_golem
- magma_cube
- mushroom_cow
- ocelot
- pig
- rabbit
- sheep - Sheep without wool
- shulker
- silverfish
- skeleton
- skeleton_horse
- slime
- snowman - Snow golems
- spider
- squid
- wolf
- zombie
- zombie_horse
- zombie_pigman
- sheep - Sheep with wool, also inherited by colored sheep
- gameplay
- fishing
- fish.json
- junk.json
- treasure.json
- fishing.json - Loads the three tables from the fishing folder, applying luck to each one
- fishing
- empty - Contains no items
- chests - Items from loot chests
History
| u | |||||
|---|---|---|---|---|---|
1.9{{Extension DPL}}<ul><li>[[Iron Nugget|Iron Nugget]]<br/>{{About|the nugget|the ore|Iron Ore|the item|Iron Ingot|the mineral block|Block of Iron}}
{{Item
| image = Iron Nugget.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Iron nuggets''' are pieces of iron that can be obtained by [[smelting]] iron [[tools]]/[[Sword|weapons]] or iron/chainmail [[armor]]. One iron nugget is worth one-ninth of an [[iron ingot]].
== Obtaining ==
=== Crafting ===
{{Crafting
|Iron Ingot
|Output= Iron Nugget,9
|type=Material
}}
=== Smelting ===
{{Smelting
|Iron Sword; {Any iron tools}; {Any iron armor}; {Any chainmail armor}; Iron Horse Armor
|Iron Nugget
|0,1
}}
[[Item durability|Durability]] and [[enchantments]] do not affect the ability to smelt iron tools, weapons, or armor into iron nuggets.
=== Bartering ===
[[Piglins]] may [[barter]] 9–36 iron nuggets when given a [[gold ingot]].
=== Chest loot ===
{{LootChestItem|iron-nugget}}
== Usage ==
Iron nuggets are used to craft [[iron ingot]]s, [[lantern]]s, [[soul lantern]]s, and [[chain]]s.
=== Crafting ingredient ===
{{crafting usage}}
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Iron Nugget
|spritetype=item
|nameid=iron_nugget
|form=item
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Iron Nugget
|spritetype=item
|nameid=iron_nugget
|id=569
|form=item
|foot=1}}
== History ==
{{History|java}}
{{History||1.11.1|snap=16w50a|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets.
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this item's numeral ID was 452.}}
{{History|||snap=18w11a|Iron nuggets now generate in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w46a|Iron nuggets are now used to craft [[lantern]]s.}}
{{History|||snap=18w50a|Iron nuggets can now be found in chests in [[taiga]] [[village]] houses.}}
{{History||1.16|snap=20w06a|Iron nuggets are now used to craft [[soul fire lantern]]s.}}
{{History|||snap=20w10a|Iron nuggets now have a {{frac|10|411}} (~2.43%) chance of being given by [[piglin]]s when [[bartering]], in a stack size of 9–36.}}
{{History|||snap=20w16a|Iron nuggets are now used to craft [[chain]]s.|Iron nuggets now generate in [[ruined portal]] and [[bastion remnant]] [[chest]]s.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets.
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|Iron nuggets can now be found in some [[shipwreck]] [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Iron nuggets are now used to craft [[lantern]]s.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron nugget can now be found in [[taiga]] [[village]] house chests.}}
{{History||1.16.0|snap=beta 1.16.0.51|Iron nuggets are now used to craft [[soul fire lantern]]s.}}
{{History|||snap=beta 1.16.0.57|Iron nuggets now have a {{frac|10|411}} (~2.43%) chance of being given by [[piglin]]s when [[bartering]], in a stack size of 9–36.
|Iron nuggets now generate in [[ruined portal]] and [[bastion remnant]] [[chest]]s.}}
{{History|||snap=beta 1.16.0.59|Iron nuggets are now used to craft [[chain]]s.}}
{{History||1.16.100|snap=beta 1.16.100.50|Iron nuggets can now be used as fuel in a [[furnace]].<ref>{{bug|MCPE-114216}}</ref>}}
{{History||1.18.30|snap=beta 1.18.30.26|Iron nuggets can no longer be used as fuel in a furnace.}}
{{History|console}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets.
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|Iron nuggets are now used to craft [[lantern]]s}}
{{History|new 3ds}}
{{History||1.9.19|[[File:Iron Nugget JE1 BE1.png|32px]] Added iron nuggets.
|Iron nuggets can be used to craft [[iron ingot]]s.
|Iron nuggets are obtained from [[smelting]] iron [[tool]]s and [[armor]].}}
{{History|foot}}
== Issues ==
{{issue list}}
==Gallery==
<gallery>
Pocket Edition Iron Nugget.jpg|First image of an iron nugget in ''Bedrock Edition''.
</gallery>
== See also ==
*[[Gold Nugget]]
*[[Iron]]
== References ==
{{Reflist}}
{{Items}}
[[de:Eisenklumpen]]
[[fr:Pépite de fer]]
[[ja:鉄塊]]
[[ko:철 조각]]
[[nl:IJzerklompje]]
[[pl:Bryłka żelaza]]
[[pt:Pepita de ferro]]
[[ru:Кусочек железа]]
[[uk:Залізний самородок]]
[[zh:铁粒]]
[[Category:Renewable resources]]</li><li>[[:Category:Combat|Category:Combat]]<br/>[[Category:Items]]
[[fr:Catégorie:Combat]]
[[zh:Category:武器]]</li></ul> | 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 | |||||
| Help | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Menu screens |
| ||||||||||||||||||
| Game customization | |||||||||||||||||||
| Editions |
| ||||||||||||||||||
| Miscellaneous | |||||||||||||||||||