Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Defines the loot that can be generated when an entity is killed, a chest is opened, fishing is performed, or other gameplay events occur. Loot tables consist of one or more pools, each containing entries with items or references to other loot tables.
Loot Table Properties
| Name | Default Value | Type | Description |
|---|---|---|---|
| pools | not set | Array of Pools items | A list of loot pools. Each pool is rolled independently to select entries. |
Loot Pool
Defines a pool of loot entries that can be rolled one or more times.
Loot Pool Properties
JSON path: pools
| Name | Default Value | Type | Description |
|---|---|---|---|
| bonus_rolls | 0 | Integer number | Additional rolls added based on luck attribute. Can be fixed or range. |
| conditions | not set | Array of Conditions items | Array of conditions that must be met for this pool to be rolled. |
| entries | not set | Array of Entries items | Array of possible entries to select from when rolling this pool. |
| rolls | 1 | Integer number | Number of times to roll this pool. Can be a fixed number or a range object with min/max. |
| rolls (as Object) | not set | Rolls (Rolls Range) item | |
| tiers | not set | Tiers item | Tiered entry selection configuration. |
Loot Condition
Defines a condition that must be met for a loot table entry or function to apply.
Loot Condition Properties
JSON path: pools > conditions
| Name | Default Value | Type | Description |
|---|---|---|---|
| chance | not set | Decimal number | For 'random_chance' and 'random_chance_with_looting': the base probability (0.0-1.0). |
| condition | not set | String | The condition type. |
| default_chance | not set | Decimal number | For 'random_difficulty_chance': default probability if difficulty not matched. |
| easy | not set | Decimal number | For 'random_difficulty_chance': probability on easy difficulty. |
| entity | not set | String | For 'entity_properties': which entity to check ('this', 'attacker', or 'attacking_player'). |
| hard | not set | Decimal number | For 'random_difficulty_chance': probability on hard difficulty. |
| looting_multiplier | not set | Decimal number | For 'random_chance_with_looting': additional chance per looting level. |
| match_tool | not set | Match Tool item | For 'match_tool': the tool item properties to match. Item tag references in the 'item' property are available without an experimental toggle in 1.21.70. |
| normal | not set | Decimal number | For 'random_difficulty_chance': probability on normal difficulty. |
| peaceful | not set | Decimal number | For 'random_difficulty_chance': probability on peaceful difficulty. |
| properties | not set | Properties item | For 'entity_properties': the entity properties to match. |
| value | not set | Integer number | For 'has_mark_variant' or 'has_variant': the variant value to match. |
condition
The condition type. Common values: 'killed_by_player', 'killed_by_player_or_pets', 'random_chance', 'random_chance_with_looting', 'has_mark_variant', 'has_variant', 'entity_properties', 'match_tool', 'random_difficulty_chance'.
Match Tool
Tool Match Properties
JSON path: pools > conditions > match_tool
| Name | Default Value | Type | Description |
|---|---|---|---|
| enchantments | not set | Array of Enchantments items | |
| item | not set | String |
Enchantments
Tool Enchant Properties
JSON path: pools > conditions > match_tool > enchantments
| Name | Default Value | Type | Description |
|---|---|---|---|
| enchantment | not set | String | |
| levels | not set | Levels item |
Levels
Enchant Levels Properties
JSON path: pools > conditions > match_tool > enchantments > levels
| Name | Default Value | Type | Description |
|---|---|---|---|
| min | not set | Integer number |
Properties
Entity Props Properties
JSON path: pools > conditions > properties
| Name | Default Value | Type | Description |
|---|---|---|---|
| on_fire | not set | Boolean true/false | |
| on_ground | not set | Boolean true/false |
Loot Table Entry
Defines an entry in a loot table pool that can be selected when the pool rolls.
Loot Table Entry Properties
JSON path: pools > entries
| Name | Default Value | Type | Description |
|---|---|---|---|
| conditions | not set | Array of Conditions items | Array of conditions that must be met for this entry to be considered. |
| functions | not set | Array of Functions items | Array of functions to apply to the item when selected. |
| name | not set | String | The item identifier (for type 'item') or loot table path (for type 'loot_table'). |
| pools | not set | Array of Pools items | Nested pools for type 'loot_table'. Allows inline loot table definition. |
| type | not set | String | The type of entry. Valid values: 'item' (drops an item), 'loot_table' (references another loot table), 'empty' (drops nothing). |
| weight | 1 | Integer number | The relative weight of this entry being selected. Higher weights are more likely. Default is 1. |
Loot Function
Defines a function that modifies a loot table entry when selected.
Loot Function Properties
JSON path: pools > entries > functions
| Name | Default Value | Type | Description |
|---|---|---|---|
| conditions | not set | Array of Conditions items | Conditions that must be met for this function to apply. |
| count (Count Range) | not set | Count item | For 'set_count' and 'looting_enchant': the count value or range. |
| count (as Integer number) | not set | Integer number | |
| damage | not set | Damage item | For 'set_damage': the damage percentage or range (0.0-1.0). |
| data | not set | Data item | For 'set_data': the data value or range to set. |
| destination | not set | String | For 'exploration_map': the structure destination type. |
| function | not set | String | The function type. |
| id | not set | String | For 'set_actor_id': the entity identifier. |
| levels | not set | Levels item | For 'enchant_with_levels': the enchantment level or range. |
| treasure | not set | Boolean true/false | For 'enchant_randomly': whether to include treasure enchantments. |
function
The function type. Common values: 'set_count', 'set_data', 'set_damage', 'set_nbt', 'enchant_randomly', 'enchant_with_levels', 'looting_enchant', 'furnace_smelt', 'set_actor_id', 'set_book_contents', 'fill_container', 'exploration_map', 'set_banner_details', 'set_armor_trim'.
Count
Count Range Properties
JSON path: pools > entries > functions > count
| Name | Default Value | Type | Description |
|---|---|---|---|
| max | not set | Integer number | |
| min | not set | Integer number |
Damage
Damage Range Properties
JSON path: pools > entries > functions > damage
| Name | Default Value | Type | Description |
|---|---|---|---|
| max | not set | Decimal number | |
| min | not set | Decimal number |
Data
Same structure as Count.
Loot Pool
Rolls (Rolls Range)
Rolls Range Properties
JSON path: pools > rolls
| Name | Default Value | Type | Description |
|---|---|---|---|
| max | 1 | Integer number | |
| min | 1 | Integer number |
Tiers
Pool Tiers Properties
JSON path: pools > tiers
| Name | Default Value | Type | Description |
|---|---|---|---|
| bonus_chance | not set | Decimal number | |
| bonus_rolls | not set | Integer number | |
| initial_range | not set | Integer number |