Table of Contents
Drops and Drop Tables
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> <amount> <chance> - <item/exp/droptable> <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.
<chance>
The chance for the specified item to be dropped. Must be a number between 0 and 1 1).
Note: Versions 2.5.0 and onwards allow lower chances than 0.1 . 2).
Note: Versions 4.4.1 and onwards allow percentage chances. (10% instead of 0.1).
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 |
For more about MMOItems, see here: https://www.mythicmobs.net/mmoitems/manual/doku.php/items/droptables
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:
internal_droptablename: #lets you specify exactly how many items will drop from this table TotalItems: <amount> MinItems: <amount> #defaults to TotalItems' value MaxItems: <amount> #defaults to TotalItems' value BonusLuckItems: <multiplier> BonusLevelItems: <multiplier> Conditions: # Conditions of the dropper - condition 1 - condition 2 - ... TriggerConditions: # Conditions of the person that triggered the drop (i.e. the killer of the mob) - 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 and MaxItems, 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, or MaxItems be set on the table to work
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, or MaxItems be set on the table to work
Bonus modifiers will increase any set Min/Max values as expected
This is all there is to it!
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: - inbiome ICE_PLAINS - playerwithin 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