Skip to content

GitLab

Equipment · Changes

Page history
changed layout and information authored by Lxlp's avatar Lxlp
Show whitespace changes
Inline Side-by-side
Showing with 67 additions and 56 deletions
Mobs/Equipment.md
View page @ fbc0d9c0
......@@ -4,26 +4,28 @@ If the PreventOtherDrops option is not enabled, then the mob will naturally drop
If you want your mob to not wear any equipment, you can use the option "PreventRandomEquipment". See [Mob Options](/databases/mobs/options). An alternative to using that option is to equip your mob with *dummy items*, such as AIR.
Equipment slots can also accept droptables, allowing for the creation of "sets" where a random item is selected from the set. For example, a droptable can be created that contains every vanilla helmet, which can then be used on the mob in the equipment tab to select one random helmet to wear.
Equipment slots can also accept [droptables](drops/DropTables#equipment-droptables), allowing for the creation of "sets" where a random item is selected from the set. For example, a droptable can be created that contains every vanilla helmet, which can then be used on the mob in the equipment tab to select one random helmet to wear.
Syntax
------
[[_TOC_]]
internal_mobname:
## Syntax
```yaml
internal_mobname:
Type: <mobtype>
Equipment:
- <item> <slot>
- <item> <slot>
- ...
```
**&lt;item&gt;**
### Item
Can be either the name of a [MythicMobs item](/Items/Items#internal_name) or a vanilla item.
**&lt;slot&gt;**
### Slot
Defines the slot on the mob that item should be carried on.
| Slot | Description |
|---------|-------------------------------------------------------------------------------------------------------------|
|---------|----------------------------------------------------------------------------------------------|
| HEAD | The head slot. Accepts regular helmets, playerheads, and even blocktypes. |
| CHEST | The chest slot. Will only render chestplates, but will carry any items. |
| LEGS | The leg slot. Will only render leggings, but will carry any items. |
......@@ -31,34 +33,57 @@ Defines the slot on the mob that item should be carried on.
| HAND | The mainhand (right) hand slot. |
| OFFHAND | The offhand (left) hand slot. |
Example
--------
awesome_boss:
```yaml
awesome_boss:
Type: pig_zombie
Equipment:
- awesome_boss_helmet HEAD
- diamond_sword HAND
```
--------
**In-line Items**
------------------
For very basic equipment, you can add some inline item data so that you don't always have to create a mythic item. Options currently available in-line on builds below 4.12 include **name**, **data**, **amount**, **lore**, and **color**
## In-line Items
For very basic equipment, you can add some inline item data so that you don't always have to create a mythic item.
All the inline item data that works under `Equipment` will also work under the [Drops](/drops/Drops) section.
```
```yaml
Equipment:
- leather_chestplate{name="Dark Leather";lore="&8A vest made of darkened leather";color=BLACK} CHEST
```
Options added in 4.12 are **model**, **enchants**, **potioneffects**, **skullOwner**, and **skulltexture**.
### Available inline attributes
| Attribute | Aliases | Description | Default |
|-----------|-----------|----------------------------------------------------------------------|---------|
| name | display, n, d | The display name of the item | |
| data | | The "Data" of the item, to not be confused with CustomModelData | 0 |
| model | | The CustomModelData of the item | 0 |
| amount | a | The amount of the item | 1 |
| lore | l | The lore of the item | |
| enchantments | enchants, ench, e | A list of [enchantments] of the item | |
| potioneffects | peffects, potion, pe | A list of [potion effects] of the item, if a potion | |
| color | c, potioncolor, pcolor, pc | The color of the item, if a potion | |
| skullowner | | The owner of the item, if a skull | |
| skulltexture | | The SkinURL of the texture of the item, if a skull | |
[enchantments]: Items/Enchantments
[potion effects]: Items/Potions
## MMOItems
To equip a mob with an mmoitem, use the following syntax:
```yaml
Equipment:
- mmoitems{type=ARMOR;id=STEEL_HELMET} HEAD
- mmoitems{type=ARMOR;id=STEEL_CHESTPLATE} CHEST
- mmoitems{type=ARMOR;id=STEEL_LEGGINGS} LEGS
- mmoitems{type=ARMOR;id=STEEL_BOOTS} FEET
- mmoitems{type=SWORD;id=RUBY_SWORD} HAND
```
Please note that mmo stats on the armor DO NOT work on MythicMobs. As such, they will not have extra health, defense or attack damage because of it.
The example below will spawn a zombie with a panda player head equipped in their head slot.
```
## Examples
The example below will spawn a zombie with a panda player head equipped in their head slot.
```yaml
PandaZombie:
Type: ZOMBIE
Options:
......@@ -69,7 +94,7 @@ PandaZombie:
Now lets take this Panda Zombie and give it some custom armor with a name, lore, and enchantments.
```
```yaml
PandaZombie:
Type: ZOMBIE
Options:
......@@ -83,7 +108,7 @@ PandaZombie:
Lastly, remember that we can use the inline item data in the drops section. Killing the PandaZombie will make it drop all of the items, with their names, lore, and enchants all without the need to make any mythic items!
```
```yaml
PandaZombie:
Type: ZOMBIE
Options:
......@@ -99,17 +124,3 @@ PandaZombie:
- DIAMOND_LEGGINGS{name="Panda<&sq>s Strength";lore="A Panda must be strong";enchants=PROTECTION_ENVIRONMENTAL:4,DURABILITY:3,MENDING:1,THORNS:2} 1 1
- DIAMOND_BOOTS{name="Panda<&sq>s Speed";lore="A Panda must be fast";enchants=PROTECTION_ENVIRONMENTAL:4,DURABILITY:3,MENDING:1,PROTECTION_FALL:4,DEPTH_STRIDER:3} 1 1
```
\ No newline at end of file
MMOItems
-------
To equip a mob with an mmoitem, use the following syntax:
```
Equipment:
- mmoitems{type=ARMOR;id=STEEL_HELMET}:4
- mmoitems{type=ARMOR;id=STEEL_CHESTPLATE}:3
- mmoitems{type=ARMOR;id=STEEL_LEGGINGS}:2
- mmoitems{type=ARMOR;id=STEEL_BOOTS}:1
- mmoitems{type=SWORD;id=RUBY_SWORD}:0
```
Please note that mmo stats on the armor DO NOT work on MythicMobs. As such, they will not have extra health, defense or attack damage because of it.
\ No newline at end of file