Differences

This shows you the differences between two versions of the page.

--- databases:items:attributes [2016/10/04 15:15]
+++ databases:items:attributes [2020/06/30 21:13] (current)
@@ Line 1: / Line 1: @@
+====== Item Attributes ======
+//Added in version 2.4//
+The attributes section for items made with MythicMobs handles the new Minecraft 1.9 attribute system. It makes it possible to apply different attributes given to the entity wearing/using it depeding on the slot. The old system in which attributes for items where put into the //Options://-tag are no longer supported.
+<code>
+Item:
+  Id: item_id
+  Attributes:
+    Slot:
+      Attribute: [number]
+</code>
+Attributes in this section also allow number ranges and forced percentages. See examples at the bottom of the page.
+===== Attributes =====
+**AttackSpeed: [number]**
+  * Handles the attack speed or cooldown time of the item. Only does something when used on weapons.
+  * Using this attribute will override the original attack speed value of the item. Base item attack speed and custom attack speed do not stack. See [[databases:items:commonitems|Common Items]] for a list of base attack speed values.
+**Armor: [number]**
+  * Sets the armor stat of the item.
+  * Is applicable to all items - not exclusive to armor type items.
+  * 1 armor = 0.5 plate pieces
+**ArmorToughness: [number]**
+  * ''Not sure what this does yet but it's in there!''
+  * (Apparently affects the damage reduction percentage of the armor)
+**Damage: [number]**
+  * Sets the melee damage of the item. (May in fact ADD onto the items base damage.
+  * Using this attribute will override the original damage value of the item. Base item damage and custom damage do not stack.
+  * The above may only apply to non-weapon/tool items.
+  * 1 damage = 0.5 hearts damage
+**FollowRange: [number]**
+  * Sets the follow range stat of the item.
+  * Only has an effect when worn by mobs.
+  * ''Not implemented yet as of build #1530''
+**Health: [number]**
+  * Sets the health of the item which will give the wearer extra or minus health.
+  * Use positive numbers for extra health and negative numbers for minus health.
+  * 1 health = 0.5 hearts health
+**Luck: [number]**
+  * Sets the luck or bad luck of the item.
+  * Use positive numbers for luck and negative numbers for bad luck.
+**KnockbackResistance: [number]**
+  * Sets the knockback resistance of the item.
+  * Use //[number]%// to force percentage values.
+    * Examples:
+      * **KnockbackResistance: 99%**
+**MovementSpeed: [number]**
+  * Sets the movement speed of the item.
+  * Use positive numbers for additional speed and negative numbers for minus speed.
+===== Slots =====
+^**Slot**^**Explanation**^
+|All|Special option. Will apply the given attributes to all slots.|
+|MainHand|Attributes will only apply if item is being held in the main hand.|
+|OffHand|Attributes will only apply if item is being held in the off hand.|
+|Head|Attributes will only apply if item is being worn on the head slot.|
+|Chest|Attributes will only apply if item is being worn on the chest/torso slot.|
+|Legs|Attributes will only apply if item is being worn on the legs slot.|
+|Feet|Attributes will only apply if item is being worn on the feet slot.|
+====== Examples ======
+This example item will grant +10 luck when the item is held in the main hand, but will grant +7 luck and +2 extra damage if the item is held in the off hand slot:
+<code>
+lucky_charms:
+  Id: potato_item
+  Display: 'Rotten Lucky Charm'
+  Attributes:
+    MainHand:
+      Luck: 10
+    OffHand:
+      Luck: 7
+      Damage: 2
+</code>
+This example item grants +2 extra health no matter in which slot the item is being held, but will also grant +4% movement speed if the item is worn in the feet slot:
+<code>
+happy_feet:
+  Id: leather_boots
+  Display: 'Penguin Hide'
+  Attributes:
+    All:
+      Health: 2
+    Feet:
+      MovementSpeed: 0.04
+</code>
+Each time this item is generated it will have a random damage value between 3 and 5 and a random speed bonus between 1 % and 5 % when worn in the main hand:
+<code>
+lucky_sword:
+  Id: wood_sword
+  Display: '&eLucky Sword&r'
+  Attributes:
+    MainHand:
+      Damage: 3-5
+      MovementSpeed: 0.01-0.05
+</code>