|
Custom durability is a really powerful system that allows you to create items with a set amount of uses unlike the vanilla durability system which forces you to always have the same amount of uses for a type of item, unless you use the Unbreaking enchant which may just look unclean.\
|
|
Custom durability is a really powerful system that allows you to create items with a set amount of uses unlike the vanilla durability system which forces you to always have the same amount of uses for a type of item, unless you use the Unbreaking enchant which may just look unclean.\
|
|
All items can have a _Max Durability_ stat, which defines how many times the item can be used before either **breaking** or **becoming unusable**. The _Will Break_ item option defines whether or not the item will break when it is finally out of uses.
|
|
All items can have a _Max Durability_ stat, which defines how many times the item can be used before either **breaking** or **becoming unusable**. The _Lost when Broken_ item option defines whether or not the item will be lost when it reaches 0 durability.
|
|
|
|
|
|
Since that durability system is not based on the vanilla MC durability system, it allows you to create both items with different amount of uses and items with **custom textures** which are not unbreakable.
|
|
Durability is displayed on the item vanilla durability bar, however you may also display the player's held item durability using PAPI placeholders. Items can be repaired at the anvil or using repairing consumables.
|
|
If you make your item **unbreakable** using the corresponding item option, the custom durability system will still work - the _Unbreakable_ item option only impacts the vanilla durability system.
|
|
|
|
|
|
|
|
The items do not directly display how many uses they have left. You have two ways of knowing how damaged your item is. Either by checking the item lore which will display the item **durability state**, or by using **PlaceholderAPI** to get the item's durability as a durability 'progress bar' as a simpler numeric value.
|
|
## Durability Placeholders
|
|
|
|
|
|
## Via Placeholders
|
|
|
|
* **%mmoitems_durability%** returns the amount of uses left of the item the player is holding.
|
|
* **%mmoitems_durability%** returns the amount of uses left of the item the player is holding.
|
|
* **%mmoitems_durability_max%** returns the item max durability.\
|
|
* **%mmoitems_durability_max%** returns the item max durability.\
|
|
![](https://i.imgur.com/TaumARR.png)
|
|
![](https://i.imgur.com/TaumARR.png)
|
... | @@ -18,18 +15,3 @@ The items do not directly display how many uses they have left. You have two way |
... | @@ -18,18 +15,3 @@ The items do not directly display how many uses they have left. You have two way |
|
![](https://i.imgur.com/QPrLKtj.png)
|
|
![](https://i.imgur.com/QPrLKtj.png)
|
|
* **%mmoitems_durability_bar_thin%** returns a much thiner durability bar.\
|
|
* **%mmoitems_durability_bar_thin%** returns a much thiner durability bar.\
|
|
![](https://i.imgur.com/MJvhd6S.png) |
|
![](https://i.imgur.com/MJvhd6S.png) |
|
|
|
\ No newline at end of file |
|
|
|
|
|
## Via Durability States
|
|
|
|
Durability states are used to display an item durabilitty in its lore. As the item gets more and more damaged, the durability state displayed in the item lore will change, indicating a lower state.\
|
|
|
|
![](https://i.imgur.com/En61zjP.png)
|
|
|
|
![](https://i.imgur.com/8DbooXv.png)
|
|
|
|
|
|
|
|
Durability states can be edited in the use-states.yml config file. You can edit their 'use ratios' and their 'lore tag'. e.g
|
|
|
|
```
|
|
|
|
NOT_VERY_USED:
|
|
|
|
use-ratio:
|
|
|
|
max: 90
|
|
|
|
min: 80
|
|
|
|
lore-tag: '&eNot Very Used'
|
|
|
|
```
|
|
|
|
This means that any item which still has between 80% and 90% of its durability (so any item which has lost 10% to 20% of its uses) will be in that durability state. Moreover, the item will display Not Very Used in its lore. |
|
|
|
\ No newline at end of file |
|
|