Skip to content

Items · Changes

Page history
Update Items authored by Eutherin's avatar Eutherin
Hide whitespace changes
Inline Side-by-side
Items.md
View page @ 89311827
Drops and Drop Tables Items
===================== =====
![](http://fs5.directupload.net/images/160308/p4f6hk8e.jpg) ![](http://fs5.directupload.net/images/160306/or6m6n2s.jpg)
The *Drops* tag can be added to your custom mobs to allow them to drop Making custom items in Mythic Mobs is quite easy. Unlike mobs and skills
items of your choice upon their death. There are three types of custom however, items made with this plugin do not come with any special or
drops available in MythicMobs to distinguish between. unique options. Any items you create with MythicMobs could also be
created by Minecraft commands, though making the items using the
You can make any number of files in the DropTables folder, and they can MythicMobs configurations is much more comfortable.
be named anything you like as long as the file ends in .yml.
Of the following options available for items, only *internal\_itemname*
Drops and *Id* are required. All other options/attributes are completely
----- optional.
Drops are the simplest way to implement custom drops. You can make any number of files in the Items folder, and they can be
named anything you like as long as the file ends in .yml.
internal_mobname:
Type: <mobtype> iternal_itemname:
Drops: Id:
- <item/exp/droptable> <amount> <chance> Data:
- <item/exp/droptable> <amount> <chance> Display:
- ... Model:
Attributes:
**&lt;item/exp/droptable&gt;** Amount:
Can be either an item from MythicMobs, a vanilla item, exp, a drop table Options:
or an item/experience for a supported plugin. Durability:
Enchantments:
**&lt;amount&gt;** Lore:
The amount of items to be dropped. Can be a number range; for example PotionEffects:
*1-3*. BannerLayers:
**&lt;chance&gt;** Breaking down the options
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]. - **internal\_itemname:**
Note: Versions 4.4.1 and onwards allow percentage chances. (10% instead - This string will be how your item is referenced internally in
of 0.1). MythicMobs and can be any name you like.
- Must be alphanumerical and is case sensitive.
| **Special Drops** | **Explanation** | **Example** | - Examples:
|-----------------------------|----------------------------------------------------------|-----------------------------------------| - **strong\_sword:**
| **champions-exp** | Will drop experience points for the plugin *Champions*. | | - **StrongSword:**
| **skillapi-exp** | Will drop experience points for the plugin *SkillAPI*. | | - **strongsword:**
| **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*. | | - **Id:**
| **mythicdrop &lt;item&gt;** | Will drop an &lt;item&gt; from the plugin *MythicDrops*. | | - Defines the type of item.
| **phatloot &lt;item&gt;** | Will drop an &lt;item&gt; from the plugin *PhatLoot*. | | - Can be either the item id or the bukkit material/item name.
| **cmd** | Will run a command in console | `- cmd{c="warp <trigger.name> spawn"}` | - Often used items are listed here: [Common Item
| **mmoitems** | Drops a mmoitems item | `- mmoitems{type=sword;id=cutlass} 1 1` | IDs](/databases/items/commonitems)
- A list of Spigot IDs for 1.12.2 is [available
For more about MMOItems, see here: here.](https://helpch.at/docs/1.12.2/org/bukkit/Material.html)
<https://www.mythicmobs.net/mmoitems/manual/doku.php/items/droptables> - Examples:
- **Id: 359**
Drop Tables - **Id: diamond\_sword**
----------- - It is STRONGLY RECOMMENDED to use namespaced item IDs, e.g.
diamond\_sword, on Minecraft 1.12.2.
Drop Tables are collections of multiple drops that can be assigned to - Numbered IDs do not exist in versions 1.13.2 and above, and you
mobs. Using them makes it easier to organize your drops in almost any will save yourself a lot of time if you don't rely on the old
case where your mobs are supposed to drop multiple items. numbered ID system.
Drop Tables are stored in their own respective configuration-files <!-- -->
located in */MythicMobs/DropTables*. They have the advantage of being
able to utilize [Conditions](/conditions/start) and various other - **Data:**
special options, and can be shared by multiple mobs without the need of - Sets the data value of the item created.
duplicating it. - Used to specify the *used up* durability points on items,
weapons or armor or to specify the sub-type of a block.
Drop Tables can be nested - a Drop Table can contain multiple other Drop
Tables. <!-- -->
internal_mobname: - **Display: '\[display\_name\]'**
Type: <mobtype> - Sets the display name of the item.
Drops: - Supports color codes and string variables:
- <internal_droptablename> [Variables](/skills/stringvariables)
- Must be encased by single quotes.
The structure of a fully-configured drop table looks like this: - For using single quotes inside of the name, you can use the
&lt;&sq&gt; variable.
internal_droptablename: #lets you specify exactly how many items will drop from this table - Examples:
TotalItems: <amount> - **Display: 'Very Strong Sword'**
MinItems: <amount> #defaults to TotalItems' value - **Display: '&eVery Strong Sword'**
MaxItems: <amount> #defaults to TotalItems' value
BonusLuckItems: <multiplier> <!-- -->
BonusLevelItems: <multiplier>
Conditions: # Conditions of the dropper - **Model: \[a number\]** *(Added in v4.7)*
- condition 1
- condition 2 <!-- -->
- ...
TriggerConditions: # Conditions of the person that triggered the drop (i.e. the killer of the mob) * Sets the CustomModelData tag on the item.
- condition 1 * Only usable in 1.14+
- ...
Drops: - **Attributes:**
- <item/exp/droptable> <amount> <chance> - Special field that allows the addition of item attributes to
- ... certain entity slots: [Item
Attributes](/databases/items/attributes)
DropTable Options
================= <!-- -->
**TotalItems: \[number\]** - **Amount:**
- Defines the default amount of items to give when this item is
- Defines exactly how many items the table will drop being called by the plugin.
- Setting this causes item chances to be calculated as weights - Examples:
- **Amount: 8**
**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 - **Options:**
number of items is reached - This is a special field which comes with numerous sub-options,
determining lots of extra attributes for the item.
**MinItems: \[number\]** - A complete list of all available options: [Item
Options](/databases/items/options)
- 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
- **Durability:**
**If you enable *both* MinItems and MaxItems, the chances for each table - Defines the starting durability of the item.
entry will become *weights* instead.**
<!-- -->
**BonusLevelItems: \[number\]/\[range\]**
- \*\*Hide: \*\* *Added in version 2.4*
- A modifier on the number of items dropped based on the mob's level - Special field that allows to hide specific things from the item
- Can be set as a range, i.e. 0.2to0.5 tooltip.
- Works like: **amount = amount + (mob\_level \* - Possible are "ATTRIBUTES", "ENCHANTS", "DESTROYS", "PLACED\_ON",
bonus\_level\_items)** "POTION\_EFFECTS" and "UNBREAKABLE".
- Requires that **TotalItems**, **MinItems**, or **MaxItems** be set - Examples:
on the table to work - ` Hide:
- ATTRIBUTES
**BonusLuckItems: \[number\]/\[range\]** - UNBREAKABLE`
- 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 - **Enchantments:**
- Works with Luck attribute, Luck-based enchants/curses, and Luck - This field allows to add enchantments to items.
potion effects - Any type of of item can have any enchanment(s).
- Works like: **amount = amount + (luck \* bonus\_luck\_items)** - A complete list of all available enchantments:
- Requires that **TotalItems**, **MinItems**, or **MaxItems** be set [Enchantments](/databases/items/enchantments)
on the table to work
<!-- -->
*Bonus modifiers will increase any set Min/Max values as expected*
- **Lore:**
This is all there is to it! - Allows you to add custom lore to your items.
- Supports color codes and string
[Variables](/skills/stringvariables).
- Must be encased by single quotes.
- For using single quotes inside of the name, you can use the
&lt;&sq&gt; variable.
- Putting number ranges surrounded by curly braces will generate a
random number in that range when the item is created (i.e.
*Health: +{100-200}* would become something like *Health:
+152*). Works with ItemLoreStats.
- Examples:`Lore:
- '&rThe weapon of a true warrior'
- ''
- '&cIncreases ones greed'`
<!-- -->
- **PotionEffects:**
- This allows you to add potion effects to your items.
- These effects won't do anything, except for showing up in the
item tooltip, if the specified item isn't a potion.
- See [Potions](/databases/items/potions).
<!-- -->
- **BannerLayers:**
- This option allows you to edit the layers of a banner.
- Won't do anything if the selected item isn't a banner.
- This option is capeable of passing minecraft's 6 layer limit.
However adding excessive amounts of layers may cause weird
behaviour and will not be supported.
- See [Banner Layers](/databases/items/bannerlayers)
### NBT Support
You can now specify NBT tags on items in the format:
Item:
Id: DIAMOND_SWORD
NBT:
Base:
ATag: 20
SomeOtherTag: something
GemSlots:
RedGem: 0
'Denizen NBT':
somedenizentag: a_string
This allows cross-over with a lot of other plugins, or just for storing
some custom information.
For the more technically-inclined, anything under 'Base' will go under
the item's base compound tag, and anything else will go under the
corresponding key (or if no sub-items are defined, everything will go
under the base tag).
If using with Denizen, all tags you want to use in Denizen must go under
'Denizen NBT' and must be lower-case to work in your Denizen scripts.
Examples Examples
-------- --------
This mob will always drop a bunch of experience and some rotten flesh, More items can be found in the [Examples](/examples) section.
but is also using a droptable which is described further below.
ClothSlippers:
snow_loving_zombie: Id: 301
Type: zombie Data: 0
Health: 100 Display: '&fCloth Slippers'
Equipment: Lore:
- snowsword:0 - ''
Drops: - 'So Soft!'
- exp 75-125 1 - ''
- rare_snowsword_droptable Enchantments:
- DURABILITY:1
This example is a droptable that has a 5 % chance of dropping a custom Options:
sword, but only if the mob is killed in an "ICE\_PLAINS" biome and if a Color: 200,200,200
player is within 20 blocks.
Lots of possible options included:
rare_snowsword_droptable:
Conditions: dat_item_though:
- inbiome ICE_PLAINS Id: banner
- playerwithin 20 Data: 4
Drops: Display: '&c&lThe Banner&r'
- snowsword 1 0.05 Lore:
- ''
In this example, the DropTable would drop 5 gold/diamonds if the player - '&rIt<&sq>s the perfect stone.'
has no Luck, and 15-27 gold/diamonds if the player has a Luck V enchant. - '&cNever question that.'
- ''
LuckyDroptable: Amount: 8
TotalItems: 5 Options:
BonusLuckItems: 2to5 Color: 200,200,200
Drops: Damage: 100
- GOLD_NUGGET 1 1 Health: 123
- DIAMOND 1 0.2 FollowRange: 12
KnockbackResistance: 1
[1] 1 = 100 %, 0.5 = 50 % ... MovementSpeed: 0.05
HideFlags: false
[2] This new limit is 2^-1022 or 2.225074e-308 Unbreakable: true
Enchantments:
- DURABILITY:1
- ARROW_FIRE:10
This example will hide which enchantments and potion effects are on the
item:
potato:
Id: carrot_item
Enchantments:
- DURABILITY:5
PotionEffects:
- BLINDNESS 20 1
Hide:
- ENCHANTS
- POTION_EFFECTS