Custom Drops (Lootables)

Explanation of lootables.

About

Lootables are a system that allows you to edit the drop tables for every living entity in the game.

Editing A Lootable

In order to edit the loot tables you need to have a basic understanding of how to work with the JSON storage format. You should be able to modify the tables from the preexisting configuration and you can also use an online JSON editor to help you write valid JSON such as this one here.

Loot Tables

The loot tables are split into two objects, those being: Lootables and Loot. Lootables are the parent object which hold all of the loot for that entity and Loot is what a child object that is held by the Lootables object.

The Loot options are:

  • Type - The material used for this drop.

  • Command - The command used for this drop. Commands are compatible with the placeholder %player% it should be noted that if the entity is not killed by a player and this placeholder is being used in a command the command will not run.

  • Data - The data value that corresponds with the material type. It should be noted that this is unsupported and unused in 1.13+

  • Name - The name applied to the dropped loot.

  • Lore - The lore applied to the dropped loot.

  • Enchantments - The enchantments applied to the dropped loot.

  • Burned Type - Material used if the entity died while on fire.

  • Chance - The chance that this drop will take place.

  • Min - The minimum amount of materials dropped or commands ran.

  • Max - The maximum amount of materials dropped or commands ran.

  • Looting - Will the looting enchantment be usable for this loot?

  • Looting Chance Increase - By how much will each level of looting advance the max drop count.

  • Only Drop For - Should this drop only be applicable for specific entities?

  • Child Loot - Should this loot house child loot?

  • Child Loot Drop Count Min - What is the minimum amount of child loot that should drop?

  • Child Loot Drop Count Max - What is the maximum amount of child loot that should drop?

Examples

In this example pigs will drop 1 - 3 white wool, 1 - 3 red wool and run a command 1 - 3 times.

{
"Type": "PIG",
"Loot": [
{
"Type": "WHITE_WOOL",
"Chance": 100,
"Min": 1,
"Max": 3,
"Looting": true
},
{
"Type": "RED_WOOL",
"Chance": 100,
"Min": 1,
"Max": 3,
"Looting": true
},
{
"Command": "say %player% killed a pig.",
"Chance": 100,
"Min": 1,
"Max": 3,
"Looting": true
}
]
}

In this example pigs will drop white wool 50% of the time while dropping red wool if the pig dies while on fire. Pigs also have a 100% chance of dropping either yellow or green wool.

{
"Type": "PIG",
"Loot": [
{
"Type": "WHITE_WOOL",
"Burned Type": "RED_WOOL",
"Chance": 50,
"Min": 1,
"Max": 3,
"Looting": true
},
{
"Chance": 100,
"Min": 1,
"Max": 1,
"Looting": true,
"Child Loot Drop Count Min": 1,
"Child Loot Drop Count Max": 1,
"Child Loot": [
{
"Type": "YELLOW_WOOL",
"Chance": 50,
"Min": 1,
"Max": 3,
"Looting": true
},
{
"Type": "GREEN_WOOL",
"Name": "&3test",
"Lore": [
"&4test2",
"&5test3",
"&6test4"
],
"Enchantments": {
"KNOCKBACK": 1,
"SWEEPING_EDGE": 1
},
"Chance": 50,
"Min": 1,
"Max": 3,
"Looting": true
}
]
}
]
}