FREE MoreItems 2.0.2-FIXED

MoreItems is a custom items plugin which will enhance your Role-Playing server to the max! The possibilities are endless. It is designed for a server who want to add extra special items into the game. Be it items with special powers or just regular extra damage items!
If you are looking for a custom items plugin and you can't find any that are updated look no further. MoreItems has all you would want and more!

If you plan to use powers I suggest using Magicspells. It is a very good plugin for spells.





MoreItems! Enhance your server's RPG experience!

== Features ==

• Endless possibilities!
• Create items with custom lore, names, material, itemflags, damage, armor, attack range, attack speed, and much more!
• Built in Recipe Manager meaning you can make recipes for the cool items you make. The ingredients can be MoreItems items too!
• Custom powers with cooldowns!
• Works for armor, swords and bows. You can give extra damage and powers to everything!
• You can enchant your items too!
• Custom mob drops!
• Automatic Updating! You do NOT need to give the item to players after updating it!
• Custom join items!
• Import your items from RPGItems!
• Supports 1.8.x!

== Commands ==

• /mi - Main command of MoreItems
• /mi create <Item Identifier> - Create an item. The item identifier is the name which you will identify the item as.
• /mi give <Item Identifier> <OPTIONAL: player> - Give yourself or a player an item
• /mi name <Item Identifier> <Name> - Set an item's name.
• /mi material <Item Identifier> <Material> - Set an item's material.
• /mi lore <Item Identifier> <Line> <OPTIONAL: Lore> - Set the description for an item. Write no lore to add an empty space.
• /mi delline <Item Identifier><Line> - Delete a line in the lore.
  
• /mi durability <Item Identifier> <Durability/infinite> - Set the durability of an item. Write infite to get unbreakable (only if using Spigot)
• /mi enchant <Item Identifier> <Enchantment> <Level> - Add an enchantment to an item
• /mi additemflag <Item Identifier> <ItemFlag> - Add an itemflag
• /mi removeitemflag <Item Identifier> <ItemFlag> - Remove and itemflag
• /mi damage <Item Identifier> <minimum damage> <maximum damage> - Sets the damage range of an item. Set both minimum and maximum for an absolute damage.
• /mi armor <Item Identifier> <Armor> - Set an armor piece's armor rating. This is in percentage so if you write 20 it'll shield 20% of all damage. If more items are worn then the percentage will stack. For example a chest with 20% and a helmet with 10% will give 30% damage reduction.
• /mi list - List all MoreItems items
• /mi addpower <Item Identifier> <EventType> <Power> <Args> - Add a power
• /mi removepower <Item Identifier> <Power> - Remove a power
• /mi recipe <Item Identifier> - Will open the a chest inventory where you can place items in a 9x9 grid to the left hand side. When you move out of the window the crafting recipe will be set.
• /mi removerecipe <Item Identifier> - Quickly remove a recipe if you made a mistake. You might need to reload the server.
• /mi removeitem <Item Identifier> - Delete an item forever!
• /mi adddrops <Item Identifier> <Entity> <Chance> - Make the entity drop your item a percentage amount of time!
• /mi removedrops <Item Identifier> <Entity> - Remove the drop from the specified entity
• /mi requirepermission <Item Identifier> <true/false> - Default is set to false. If you set this to true then your item can only be used if the player has the permission moreitems.use.<Item Identifier>
• /mi setlevel <Item Identifier> <Level> - Set the minimum required experience level to use this item!
• /mi addattribute <Item Identifier> <Miscellaneous> <Args> - Add a miscellanouses
• /mi removeattribute <Item Identifier> <Miscellaneous> - Remove a miscellaneous
• /mi setcolor <Item Identifier> <Hex value> - Set an item's colour. Find the colours here http://www.color-hex.com/color-names.html under Color Code
• /mi import - Import all items from either MythicMobs or RPGItems
• /mi show - Shows the Item Identifier of the item you're holding/mi
• displaydescription <Item Identifier> <true/false> - Set an item to display it's powers and attributes or not!

== Permissions ==

• MoreItems.use - The ability to create MoreItems
• MoreItems.use.<Item Identifier> - If itemsRequirePermission is set to true or the item is said to require permission then this is the permission node for it.

== Config ==
You can either create items via commands or you can do it in bulk via the items.yml. An example of an item from the items.yml would be:
Code (Text):
shovel:
Material: IRON_SPADE
Name: '&cShovel Of Doom'
minDamage: 12
maxDamage: 22
Powers:
- PotionEffect_HOLD_SPEED_200_1
- PotionEffect_HOLD_JUMP_100_3
Lore:
- Its a shovel mate
ItemFlags:
- HIDE_ATTRIBUTES
This is the config.yml:
Code (Text):
timerInterval: 1 #This is how often the plugin should check for the hold event type.
displayPowersInDescription: true #If you want powers to not be displayed in the lore then write false
displayCooldown: true #If you want cooldowns to be displayed to the user. This might be a good idea to turn off if there are more powers on one item
itemsRequirePermission: false #If all items require permission. If this is set to true then the node is moreitems.use.<Item Identifier>
joinItems: #A list of items that the player will receive when joining for the first time ever.
- someItem

== Powers, EventTypes & Attributes ==

Powers
To add a power simply do /mi addpower <Item Identifier> <EventType> <Power> <Args> Powers are:

• Command <OPTIONAL: Cooldown> <Command with NO slash (/)> - Gives the player OP to fire a command and then removes it again. Typing %player% will get the player name and %target% will get the target name.
• Fire <Duration in ticks> <OPTIONAL: cooldown> - Sets the target on fire for x amount of ticks.
• Fireball <Velocity (1-2 is average)> <Small/Big> <OPTIONAL: cooldown> - Fires either a small or big fireball with x velocity.
• Lightning <OPTIONAL: Cooldown> - Strikes lightning at the target.
• Teleport <Range in blocks> <OPTIONAL: Cooldown> - Teleports the player x amount of blocks forward.
• Throw <Velocity> <Damage> <Cooldown> - Throw an item with x amount of velocity! 6 is about average of throwing velocity
• Consume <Material> <Amount> - Will consume a x amount of materials from the player!
• Knockback <Velocity> <Cooldown> - Will knock the player away!
• TNT <Velocity> - Fire tnt!
• DurabilityCost <Amount> - Make an item cost durability!
• PotionSelf <PotionEffectType> <Amplifier> <Duration in ticks> <OPTIONAL: Cooldown> - Give a potion effect to yourself!
• PotionTarget <PotionEffectType> <Amplifier> <Duration in ticks> <OPTIONAL: Cooldown> - Give a potion effect to the target!
• Heal <Heal amount> <OPTIONAL: Cooldown> - Heal the player.
• Sound <sound> - Play a sound! Sounds can be found Here
• Message <text> - Write a custom message to the player!
• Wither <Velocity> - Shoot a wither head!
• Snowball <Velocity> - Shoot a snowball!
• Effect <Amount> - Play particle effects!

EventTypes

• Left - when left clicking an item (or when wearing the armor and left clicking)
• Right - Fires when right clicking an item (or when wearing the armor and right clicking)
• Hold - At each interval ticks (set in the config with timerInterval) it will add the effect if the player is holding the item or has it equipped. This means that potion effects WILL be refreshed. It also makes it so that any other effects will get spammed when holding or having an item equipped.
  
• Damage - Fires when dealing damage to an opponent (arrows and swords).
• Damaged - Fires when dealt damage to by an opponent.
• Sneak - Fires when toggling sneak (shifting and unshifting)
• BlockBreak - Fires when breaking a block
• Killed - Fires when the player is killed and has the item in their inventory
• ArrowLand - Fires when an arrow lands on either a block or an entity.
• Consume - Fires when the player consumes an item (drinking, eating)

Attributes
To add an attribute simply do /mi addattribute <Item Identifier> <Attribute> <Args>

Attributes are:

• Range<Blocks> - Set the attack range of an item.
• Speed <Speed> - Set the attack speed of an item. 20 is the default speed. 0 is the fastest. This is counted in ticks meaning 20 ticks = 1 second.
• Backstab - Give the item the ability to backstab.
• Dodge <Chance> - Give the item the ability to dodge when holding/equipped
• Soulbound <Player> - Make the item soulbound to the specific player.

== Tutorial ==
Creating items via the in-game commands might become tedious if you want a lot of similar items, so use the config for that. If you're creating individual items, I'd suggest using the in-game commands.
Here's a tutorial on creating an item via in-game commands.
Here I'll be creating a sword via in-game commands for you that you can use:

I'll start with creating it:

1. /mi create sword - Create the item
2. /mi name sword &cGod Sword - Set it's name
   
3. /mi material sword diamond_sword - Set it's material
   
4. /mi damage sword 10 20 - Set it's minimum - maximum damage
   
5. /mi additemflag sword hide_attributes - hide the +x damage
   
6. /mi lore sword 1 &bForged by the gods - Add line 1 lore
   
7. /mi addpower sword hold potionself speed 200 2 - add a potioneffect when holding
   
8. /mi recipe sword - Create a recipe for it

Adding Enchantments
On this http://minecraft.gamepedia.com/Enchanting website all enchantments can be found. A couple examples of enchantment names and their in-game name:

• fire_protection
• feather_fall
• haste
• silk_touch
• fire_aspect
• etc.

ItemFlags

• hide_attributes - hides the +x damage
• hide_destroys - hides the destroy tag
• hide_enchants - hides all enchantments
• hide_place_on - hides the placed on tag
• hide_potion_effects - hides potion effects on a potion for example.
• hide_unbreakable - hides the unbreakable tag

Materials
Click on this http://minecraft-ids.grahamedgecombe.com/ website to see a list of all materials. Examples of some materials (you can also use IDs):

• Diamond_Sword
• Stone
• Nether_brick
• Ink_sack:4
• Etc.

Potion Effects
Click on this http://minecraft.gamepedia.com/Status_effect website to see a list of all possible potion effects.

Donations
If you wish to donate you can do so here:


Images