The Drops tag can be added to your custom mobs to allow them to drop items of your choice upon their death. There are three types of custom drops available in MythicMobs to distinguish between.
You can make any number of files in the DropTables folder, and they can be named anything you like as long as the file ends in .yml.
Drops
Drops are the simplest way to implement custom drops.
internal_mobname:
Type: <mobtype>
Drops:
- <item/exp/droptable/cmd> <amount> <chance>
- <item/exp/droptable/cmd> <amount> <chance>
- ...
<item/exp/droptable>
Can be either an item from MythicMobs, a vanilla item, exp, a drop table or an item/experience for a supported plugin.
amount
The amount of items to be dropped.
Can be a number range, for example: 1-3
or 1to3
.
In this case, the number of dropped items will never be smaller than the leftmost number and never be equal or greater to the rightmost number
Writing
1to3
will drop at least 1 item and at most 2 items
chance
The chance for the specified item to be dropped.
- Must be a number between 0 and 1
- Note: allows percentage chances. (10% instead of 0.1).
Special Drops
Special Drops | Explanation | Example |
---|---|---|
champions-exp | Will drop experience points for the plugin Champions. | |
skillapi-exp | Will drop experience points for the plugin SkillAPI. | |
heroesexp | Will drop experience points for the plugin Heroes. | |
mcmmo-exp | Will drop experience points for the plugin MCMMO. | |
exp | Will drop regular Minecraft experience points. | |
money | Will drop money for the plugin Vault. | |
mythicdrop <item> | Will drop an <item> from the plugin MythicDrops. | |
phatloot <item> | Will drop an <item> from the plugin PhatLoot. | |
cmd | Will run a command in console | - cmd{c="warp <trigger.name> spawn"} |
mmoitems | Drops a mmoitems item | - mmoitems{type=SWORD;id=CUTLASS} 1 1 |
nothing | Will drop nothing. Can help while creating weighted droptables |
For more about MMOItems, see here.
In-line Drops
For very basic equipment, you can add some inline item data so that you don't always have to create a mythic item. Options currently available in-line on builds below 4.12 include name, data, amount, lore, and color
All of this inline item data can also be used in Equipment:!
Drops:
- leather_chestplate{name="Dark Leather";lore="&8A vest made of darkened leather";color=BLACK} 1 1
Options added in 4.12 are model, enchants, potioneffects, skullOwner, and skulltexture.
The below drops section will drop a Panda player head item that has 2 enchants on it, and will drop 3 pieces of diamond armor that all have names, lore, and enchantments on them!
Drops:
- PLAYER_HEAD{skullTexture=eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYjY0NjNlNjRjZTI5NzY0ZGIzY2I0NjgwNmNlZTYwNmFmYzI0YmRmMGNlMTRiNjY2MGMyNzBhOTZjNzg3NDI2In19fQ==;enchants=WATER_WORKER:1,OXYGEN:3} 1 1
- DIAMOND_CHESTPLATE{name="Panda<&sq>s Will";lore="A Panda must be vigilant";enchants=PROTECTION_ENVIRONMENTAL:4,DURABILITY:3,MENDING:1,THORNS:2} 1 1
- DIAMOND_LEGGINGS{name="Panda<&sq>s Strength";lore="A Panda must be strong";enchants=PROTECTION_ENVIRONMENTAL:4,DURABILITY:3,MENDING:1,THORNS:2} 1 1
- DIAMOND_BOOTS{name="Panda<&sq>s Speed";lore="A Panda must be fast";enchants=PROTECTION_ENVIRONMENTAL:4,DURABILITY:3,MENDING:1,PROTECTION_FALL:4,DEPTH_STRIDER:3} 1 1
Drop Tables
Drop Tables are collections of multiple drops that can be assigned to mobs. Using them makes it easier to organize your drops in almost any case where your mobs are supposed to drop multiple items.
Drop Tables are stored in their own respective configuration-files located in /MythicMobs/DropTables. They have the advantage of being able to utilize Conditions and various other special options, and can be shared by multiple mobs without the need of duplicating it.
Drop Tables can be nested - a Drop Table can contain multiple other Drop Tables.
internal_mobname:
Type: <mobtype>
Drops:
- <internal_droptablename>
The structure of a fully-configured drop table looks like this:
#Lets you specify exactly how many items will drop from this table
internal_droptablename:
TotalItems: <amount>
MinItems: <amount> #defaults to TotalItems' value
MaxItems: <amount> #defaults to TotalItems' value
BonusLuckItems: <multiplier>
BonusLevelItems: <multiplier>
#Conditions of the dropper
Conditions:
- condition 1
- condition 2
- ...
#Conditions of the person that triggered the drop (i.e. the killer of the mob)
TriggerConditions:
- condition 1
- ...
Drops:
- <item/exp/droptable> <amount> <chance>
- ...
DropTable Options
TotalItems: [number]
- Defines exactly how many items the table will drop
- Setting this causes item chances to be calculated as weights
MaxItems: [number]
- Defines a maximum number of items that will drop
- If only this is set, drops will run down the list unless the maximum number of items is reached
MinItems: [number]
- Defines a minimum number of items that will drop
- If only this is set, drops will run down the list until the minimum items is reached
- If you enable both
MinItems
andMaxItems
, the chances for each table entry will become weights instead.
BonusLevelItems: [number]/[range]
- A modifier on the number of items dropped based on the mob's level
- Can be set as a range,`i.e.
0.2to0.5
- Works like:
amount = amount + (mob_level * bonus_level_items)
- Requires that
TotalItems
,MinItems
, orMaxItems
are set on the table
BonusLuckItems: [number]/[range]
- A modifier on the number of items dropped based on the killer's luck stat
- Can be set as a range, i.e.
0.15to8
- Works with Luck attribute, Luck-based enchants/curses, and Luck potion effects
- Works like:
amount = amount + (luck * bonus_luck_items)
- Requires that
TotalItems
,MinItems
, orMaxItems
are set on the table
Examples
This mob will always drop a bunch of experience and some rotten flesh, but is also using a droptable which is described further below.
snow_loving_zombie:
Type: zombie
Health: 100
Equipment:
- snowsword:0
Drops:
- exp 75-125 1
- rare_snowsword_droptable
This example is a droptable that has a 5 % chance of dropping a custom sword, but only if the mob is killed in an "ICE_PLAINS" biome and if a player is within 20 blocks.
rare_snowsword_droptable:
Conditions:
- biome{b=ICE_PLAINS}
- playerwithin{d=20}
Drops:
- snowsword 1 0.05
In this example, the DropTable would drop 5 gold/diamonds if the player has no Luck, and 15-27 gold/diamonds if the player has a Luck V enchant.
LuckyDroptable:
TotalItems: 5
BonusLuckItems: 2to5
Drops:
- GOLD_NUGGET 1 1
- DIAMOND 1 0.2
Equipment Droptables
It is also possible to use droptables to configure equipment setups. This type of droptables can be used either directly in the Equipment element of the mob or by using the Equip mechanic. The syntax itself is similar to the one of a "normal" droptable, except, in this case, it's necessary to specify an equipment slot.
Examples
# Droptable Config
Example_EquipmentDropTable:
Drops:
- LEATHER_HELMET HELMET 1 1
- LEATHER_CHESTPLATE CHEST 1 1
- CHAINMAIL_CHESTPLATE CHEST 1 0.5
- DIAMOND_CHESTPLATE CHEST 1 0.1
- NETHERITE_CHESTPLATE CHEST 1 0.05
# Mob Config
ExampleMob:
Type: ZOMBIE
Equipment:
- Example_EquipmentDropTable
These configurations will allow ExampleMob
to
- always have a leather helmet
- always have at least a leather chestplate, while having something more powerful if the chance is met