Skip to content

GitLab

Item Stats and Options · Changes

Page history
added defense, profession requirement, and unstackable authored by Ethan's avatar Ethan
Hide whitespace changes
Inline Side-by-side
Showing with 12 additions and 3 deletions
Item-Stats-and-Options.md
View page @ dc583d1d
......@@ -53,13 +53,19 @@ BLUNT_ITEM:
```
## Unbreakable
When set to true, weapons never break. This option is needed if you planned to give your item a custom texture using the _texture by durability_ mecanism.
When set to true, weapons never break. This option is needed if you planned to give your item a custom texture using the _texture by durability_ mechanism.
## Unstackable
When set to true, your item will never stack with itself.
## Armor, Armor Toughness
The amount of armor and armor toughness your piece of armor gives to the player. These stats correspond to vanilla minecraft player attributes.
Armor and armor thoughness reduce damage taken. You may visit the official MC wiki to know how damage is calculated depending on armor & armor thoughness, but briefly: armor reduces damage, and armor thoughness reduces armor reduction.
Armor and armor toughness reduce damage taken. You may visit the official MC wiki to know how damage is calculated depending on armor & armor toughness, but briefly: armor reduces damage, and armor toughness reduces armor reduction.
These stats are not supported in 1.8 since the corresponding Minecraft attributes were added back in 1.9.
## Defense
This stat determines the player's defense value and can be any positive number. Any item type can be given this stat. The formula for which defense damage mitigation is handled can be edited in the mmolib config.yml.
## Movement Speed
The amount of movement speed your item gives to the holder/wearer.
The default minecraft movement speed is 0.2. If you set the item additional movement speed to 0.02, that will be +10% Movement Speed.
......@@ -130,6 +136,9 @@ MARKING_BOW:
## Required Level
The level your weapon/item requires in order to be used. This restriction completely supports RPG core plugin levels.
## Required Profession Level
This stat determines if a player can use the item or not depending on the required profession level. Requires MMOCore.
## Skull Texture (for player heads only)
The skull texture used for a custom head. For 1.13, use the PLAYER_HEAD material to get a player head item. Legacy users must use SKULL_ITEM with a durability of 3. The config format for that stat is rather weird because of a specific issue with custom textured skulls.
```
......@@ -138,7 +147,7 @@ skull:
value: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTdlMmY0OTQyNDNhY2FkM2Y0ODQ0YmM1YWUyZDVmZDUzZTY5MjczMzA0YzlkYmY1YmQxMzA5NDlmYTEzMjk4ZiJ9fX0=
uuid: 62a6ff60-98f3-4769-9dd6-2b5fe5e8046f
```
You must specific a random UUID (use a [[random UUID generator|https://www.uuidgenerator.net/]]) because Minecraft needs a (ranbdom player) UUID to recognize the head as a textured player head. MMOItems used to use a totally random UUID for every item, but there was an issue with skulls not stacking because they had different UUIDs stored in their NBTTags.
You must specific a random UUID (use a [[random UUID generator|https://www.uuidgenerator.net/]]) because Minecraft needs a (random player) UUID to recognize the head as a textured player head. MMOItems used to use a totally random UUID for every item, but there was an issue with skulls not stacking because they had different UUIDs stored in their NBTTags.
If you input the skull texture value using the item edition GUI, MMOItems will generate a random UUID for you. You can find skull texture values on Minecraft Heads or similar head databases.
......