Custom Drops (Lootables)

Explanation of lootables.

About This

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 lootables, you need to have a basic understanding of how to work with the JSON storage format. You are able to modify the tables from the preexisting configuration, and you could also use an online JSON editor to help you write a 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 holds all of the loot for the entity. Loot is the child object that is held by the Lootables object.

There are various Loot options, which 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 while this placeholder is being used, 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 Minecraft versions of 1.13 and above.

  • Name - The name applied to the dropped loot.

  • Lore - The lore applied to the dropped loot.

  • Enchantments - The enchantments applied to the dropped loot. Using the value "Random" will process the enchantment as if it were going through an enchanting table.

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

  • Chance - The chance that the material will drop.

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

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

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

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

  • Only Drop For - Should this drop only be applicable to 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?

  • Wielded Enchantment Chance Overrides - The override for chances applied by the wield item.

  • Damage Min - Min amount of applied damage.

  • Damage Max - Max amount of applied damage.

Examples

In this example, pigs will drop 1 - 3 white wool, 1 - 3 red wool, and will 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
}
]
}
]
}

In this example, pigs will drop a bow bow that is enchanted randomly with an Enchanting Table of level 26. The bow will also be damaged between 10 and 100 percent. There is also a 20% chance that the player will be opped.

{
"Type": "PIG",
"Loot": [
{
"Type": "BOW",
"Enchantments": {
"RANDOM": 26
},
"Chance": 0.7,
"Min": 1,
"Max": 1,
"Wielded Enchantment Chance Overrides": {
"LUCK:2": 1.3,
"LUCK:1": 1.0,
"LUCK:3": 1.6
},
"Damage Min": 10,
"Damage Max": 100,
"Looting": true
},
{
"COMMAND": "OP %player%",
"Chance": 20,
"Min": 1,
"Max": 1,
"Looting": true
}
]
}