Skip to content

Latest commit

 

History

History
218 lines (185 loc) · 6.52 KB

Items.md

File metadata and controls

218 lines (185 loc) · 6.52 KB
Raw

Items

Making custom items in Mythic Mobs is quite easy. Unlike mobs and skills however, items made with this plugin do not come with any special or unique options. Any items you create with MythicMobs could also be created by Minecraft commands, though making the items using the MythicMobs configurations is much more comfortable.

Of the following options available for items, only internal_itemname and Id are required. All other options/attributes are completely optional.

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.

iternal_itemname:
  Id:
  Data:
  Display:
  Model:
  Attributes:
  Amount:
  Options:
  Durability:
  Enchantments:
  Lore:
  PotionEffects:
  BannerLayers:

Breaking down the options

  • internal_itemname:
    • This string will be how your item is referenced internally in MythicMobs and can be any name you like.
    • Must be alphanumerical and is case sensitive with no spaces allowed.
    • Examples:
      • strong_sword:
      • StrongSword:
      • strongsword:
  • Id:
    • Defines the type of item.
    • Can be either the item id or the bukkit material/item name.
    • Often used items are listed here: [Common Item IDs](items/Common Item Id's)
    • A list of Spigot IDs for the current version is available here.
    • Example:
      • Id: diamond\_sword
    • It is STRONGLY RECOMMENDED to use namespaced item IDs, e.g. diamond\_sword
    • Numbered IDs do not exist in versions 1.13.2 and above, and you will save yourself a lot of time if you don't rely on the old numbered ID system.
  • Data:
    • Sets the data value of the item created.
    • Used to specify the used up durability points on items, weapons or armor or to specify the sub-type of a block.
  • Display: '[display_name]'
    • Sets the display name of the item.
    • Supports color codes and string variables: Variables
    • Must be encased by single quotes.
    • For using single quotes inside of the name, you can use the <&sq> variable.
    • Examples:
      • Display: 'Very Strong Sword'
      • Display: '&eVery Strong Sword'
  • Model: [a number]
    • Sets the CustomModelData tag on the item.
    • Only usable in 1.14+
  • Attributes:
    • Special field that allows the addition of item attributes to certain entity slots: Item Attributes
  • Amount:
    • Defines the default amount of items to give when this item isbeing called by the plugin.
    • Examples:
      • Amount: 8
  • Options:
    • This is a special field which comes with numerous sub-options, determining lots of extra attributes for the item.
    • A complete list of all available options: Item Options
  • Durability:
    • Defines the starting durability of the item.
  • Hide:
    • Special field that allows to hide specific things from the item tooltip.
    • Possible are "ATTRIBUTES", "ENCHANTS", "DESTROYS", "PLACED_ON","POTION_EFFECTS" and "UNBREAKABLE". Example:
  Hide:
  - ATTRIBUTES
  - UNBREAKABLE
  • Enchantments:
    • This field allows to add enchantments to items.
    • Any type of of item can have any enchanment(s).
    • A complete list of all available enchantments: Enchantments
  • Lore:
    • Allows you to add custom lore to your items.
    • Supports color codes and string Variables.
    • Must be encased by single quotes.
    • For using single quotes inside of the name, you can use the <&sq> 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.
  • 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 capable of passing minecraft's 6 layer limit. However adding excessive amounts of layers may cause weird behavior and will not be supported.
    • See Banner Layers

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

More items can be found in the Examples section.

ClothSlippers:
  Id: 301
  Data: 0
  Display: '&fCloth Slippers'
  Lore:
  - ''
  - 'So Soft!'
  - ''
  Enchantments:
  - DURABILITY:1
  Options:
    Color: 200,200,200

Lots of possible options included:

dat_item_though:
  Id: banner
  Data: 4
  Display: '&c&lThe Banner&r'
  Lore:
  - ''
  - '&rIt<&sq>s the perfect stone.'
  - '&cNever question that.'
   - ''
  Amount: 8
  Options:
    Color: 200,200,200
    Damage: 100
    Health: 123
    KnockbackResistance: 1
    MovementSpeed: 0.05
    HideFlags: false
    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