Equipment.yml
Equipment.yml
This file is for defining custom equipment sets.
The possibilities
As you know you can set the equipment of bosses when they spawn. This feature is more advanced than most other plugins available out there in focus on mob equipment. Of course you can give mobs custom items, like a sword in their hand or armor on their body. All these things have a fully customisable chance, which can be defined in the config files. Each item can have a data value to, for example, give a wool block a colour. Each item can also have a durability value, or a drop chance. You can also add enchantments to the items. The durability is used to make a sword pre-damaged. You can alse set the probability that this item will drop when the mob dies. Inside the enchantments part you can add any enchantment you’d like. Each item can contain more than one enchantment. All enchantments have a customisable chance to be attached on the item. Also, the enchantments are unsafe, which means the following. You can add the enchantment ‘Knockback’ with level 20, to a sign. This makes the sign extremely powerful. This isn’t available in vanilla Minecraft, that’s why it’s called an unsafe enchantment.
The appearance
Only a few mobs are able to wear physical stuff. For example, the zombie, the zombie pigman, the skeleton and only a few others are able to wear visible armor, because they are humanoid mobs. If you put a block of glass on the head of a zombie, players are able to see the glass block. If, for example, you put this block on the head of the spider, the block won’t be visible. This is caused by Minecraft itself, because this spider doesn’t have a human-shaped body. Although, the gear isn’t visible on spiders for example, they do have effect on the behavior of the spider.
Defining equipment sets
It’s actually very easy to setup the equipment sets, once you know how it works. That’s one reason why this documentation page has been created. We will take the diamond set as example. Below you can see an example of what an equipment.yml file can look like.
#The name of the equipmentset. This is what you need to put in the EquipmentSet node in the bosses.yml file "diamond": #The item(s) the mob can wear as helmet Helmet: #To make nothing appear on a slot, you can use the following: {} #The item(s) the mob can wear as chestplate Chestplate: #The name of the item "diamond_chestplate": #Whether or not this item is enabled, # this allows you to disable an item without # removing it from the config Enabled: true #The itemid of the chestplate ItemId: 311 #The probability that this item will be chosen. #Since the total probability of all the items in this node # is more than 100, it will be the relative probability. Probability: 100 #The item data, which can be used to, for instance # set the colour of a wool block ItemData: 0 #The durability of the item to already make it damaged ItemDurability: 0 #The percent probability that this item will drop # when the boss is defeated DropProbability: 50 "golden_chestplate": Enabled: true ItemId: 315 Probability: 100 ItemData: 0 ItemDurability: 0 DropProbability: 50 #The item(s) the mob can wear as leggings Leggings: "diamond_leggings": Enabled: true ItemId: 312 #Since the total probability of the items in this node # is smaller than 100, it is the absolute probability. #In this case that means that the boss has a 50% chance # to wear the diamond leggins and # a 50% chance to wear no leggins. Probability: 50 ItemData: 0 ItemDurability: 0 DropProbability: 50 #The item(s) the mob can wear as boots Boots: "diamond_boots": Enabled: true ItemId: 313 Probability: 50 ItemData: 0 ItemDurability: 0 DropProbability: 50 #The item(s) that can appear in the mobs hands Weapon: "diamond_sword": Enabled: true ItemId: 276 Probability: 100 ItemData: 0 ItemDurability: 0 DropProbability: 50 #This node contains the enchantments for this item Enchantments: #The name of this enchantment "knockback": Enabled: true #The enchantment type, you can choose from the list # at the bottom of this page Enchantment: "Knockback" #The absolute probability that the item will get this # enchantment, so this sword has a 30% chance # to get this enchantment Probability: 30 #The enchantment level, this can be anything larger than 0 # and smaller than 128 Level: 2 "sharpness": Enabled: true Enchantment: "Damage All" Probability: 50 Level: 3
Available enchantments
The table below contains three columns of enchantments available to use. The first column is the Likeaboss enchantment name which should be used inside the Enchantments node, the second column is the Bukkit name for the enchantments, which can also be used inside the Enchantments node. And the third column contains the vanilla in-game Minecraft enchantment names, which CANNOT be used inside the Enchantments node.
| Corruption Enchantment | Bukkit Enchantment | Minecraft Enchantment |
|---|---|---|
| Protection Environmental | PROTECTION_ENVIRONMENTAL | Protection |
| Protection Fire | PROTECTION_FIRE | Fire Protection |
| Protection Fall | PROTECTION_FALL | Feather Falling |
| Protection Explosions | PROTECTION_EXPLOSIONS | Blast Protection |
| Protection Projectile | PROTECTION_PROJECTILE | Projectile Protection |
| Oxygen | OXYGEN | Respiration |
| Water Worker | WATER_WORKER | Aqua Affinity |
| Damage All | DAMAGE_ALL | Sharpness |
| Damage Undead | DAMAGE_UNDEAD | Smite |
| Damage Arthropods | DAMAGE_ARTHROPODS | Bane of Arthropods |
| Knockback | KNOCKBACK | Knockback |
| Fire Aspect | FIRE_ASPECT | Fire Aspect |
| Loot Bonus Mobs | LOOT_BONUS_MOBS | Looting |
| Dig Speed | DIG_SPEED | Efficiency |
| Silk Touch | SILK_TOUCH | Silk Touch |
| Durability | DURABILITY | Unbreaking |
| Loot Bonus Blocks | LOOT_BONUS_BLOCKS | Fortune |
| Thorns | THORNS | Thorns |
| Arrow Damage | ARROW_DAMAGE | Power |
| Arrow Knockback | ARROW_KNOCKBACK | Punch |
| Arrow Fire | ARROW_FIRE | Flame |
| Arrow Infinite | ARROW_INFINITE | Infinity |
