Bukkit

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.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

#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 corresponding to an item in items.yml
    "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 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 percent probability that this item will drop
      # when the boss is defeated
      DropProbability: 50
    "golden_chestplate":
      Enabled: true
      Probability: 100
      DropProbability: 50
  #The item(s) the mob can wear as leggings
  Leggings:
    "diamond_leggings":
      Enabled: true
      #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
      DropProbability: 50
  #The item(s) the mob can wear as boots
  Boots:
    "diamond_boots":
      Enabled: true
      Probability: 50
      DropProbability: 50
  #The item(s) that can appear in the mobs hands
  Weapon:
    "diamond_sword":
      Enabled: true
      Probability: 100
      DropProbability: 50