RPG MAKER MZ Plugin: DurabilityMZ
Welcome to the Durability plugin
This plugin allows you to have a repair system for your equipment. You can have an interface where you will be charged based on how damaged the used item is.
If the item is destroyed, its stats will temporarily become 0 until the player repairs the item, and optionally, the special effects (sp-stats) that they provide to the player will be removed.
You can set the repair price for each item, how much durability it has, how much damage it suffers, make a skill damage the item, whatever you want. In the FULL version, you have many more customizations and systems to adapt it to your project!
RPG MAKER COMPATIBLE VERSION: MZ
All documentation on how to use the plugin will be inside the plugin. The FULL version has more detailed documentation with more examples.
Please Read:
The DEMO version does not include the most up-to-date version of the plugin.
The new version includes (v1.1.0+) the DurabilityPatch that will extend the capabilities of the plugin and solve the object stacking problem. In any case, the demo version will serve as a reference of what the plugin does, but now you will know that the full version will solve that behavior that rpg maker mz has by default.
Due to how RPG MAKER MZ works and stacks the objects, the DEMO plugin will not work correctly if you use more than one object from the database in your game since they will stack with each other. Example: If you have a ShortSword (DB ID: 2) equipped destroyed, and you get another ShortSword (DB ID: 2). The new one will never exist and you will have 2 "Shortsword" destroyed. basically, in other words: You can only use a unique ID from the database for each repairable object. What you can have is: DATABASE: ID: 2 Shortsword (Repairable) ID: 3 Shortsword (Not Repairable)
Differences between versions:
| Feature | DEMO | FULL |
|---|---|---|
| Encrypted Code | YES | NO |
| Durability Patch Included Allows to fix the Stacking problem of RPG MAKER MZ and adds fixes for the main plugin. | NO | YES |
| Plugin Command: Weapon/Armor Remover Due to how the Durability Patch works, the rpg maker's Default Remove Weapons/Armor feature will no longer work as it was before, now you will use it from plugin commands in the DurabilityMZ plugin. | NO | YES |
| Tags: <armor-durability-breaking:x> <weapon-durability-breaking:x> You can create statuses that reduce the durability of your weapon/armor. | NO | YES |
| Tag: <durability:x> Enable and sets the Weapon/Armor durability for that item. Default: Items will not use Durability System. | YES | YES |
| Tag: <durability:var(x)> (Same before but, allows to use variables instead Fixed Values) | NO | YES |
| Tag: <brokenText:XXXX> This allows you to change the text that is displayed when the object is broken. | YES | YES |
| Tag: <repair-cost:x>
This establishes the price that must be paid for each point that the object has lost. | YES | YES |
| Tag: <repair-cost:var(x)> Same as before, but instead of using a fixed value, the value is set by a variable. | NO | YES |
| Tags : <break-value:x> <break-value:rnd(x)> This forces a skill to deal X damage to the weapon/armor. *If you use the FULL version, its operation is different: it will only affect the protectors and will have priority over everything. Useful for enemies skills. DEMO Not Include Rnd Function | YES* | YES |
| Tag: <no-break>
Prevent this skill from reducing your durability points | YES | YES |
| Tag: <weapon-self-damage:x>
When you use this skill you lose x durability points on equipped weapon. | NO | YES |
| Tag: <weapon-self-damage:rnd(x,y)>
When you use this skill you lose x to y random durability points on equipped weapon. | NO | YES |
| Tag: <damaged-value:x>
Your protector will take these damage points from the enemy. | NO | YES |
| Tag: <damaged-value:rnd(x,y)>
Your protector will take x to y random damage points from the enemy. | NO | YES |
| Change the color of the object based on its damage. | NO | YES |
| - More coming soon? |
How to install the plugin? Place the file:
DurabilityMZ.js and DurabilityPatch or DurabilityMZDEMO.js (Depending on your case)
In the plugins folder. Activate the plugin from the editor.
Call the plugin with the Command: Plugin Call in the event editor.
I think a demo is not necessary, but if you need it tell me and I'll do it!
Don't forget to configure everything in the database with the appropriate notes before using this plugin.
The repair interface only shows inventory items that ARE NOT EQUIPPED. If you want to repair something, you must remove it from your inventory. Don't forget about that. This is intentional.
Purchase
In order to download this project you must purchase it at or above the minimum price of $4.79 USD. You will get access to the following files:
Download demo
Development log
- DurabilityMZ: v1.1.0 UpdateSep 06, 2023
Comments
Log in with itch.io to leave a comment.
Hi Undermax, I have a question: items does not use durability by default, but we can turn it on, right? I wanted to make a system where player can use item, let's say a pickaxe, and the event uses plugin call/script to decrease that item durability while used. Can I do that somehow? Is there a plugin command or a piece of code that will allow me to do that?
Hello, please contact me directly through a form, so I can send you a personalized version.
https://itch.io/blog/694860/undermax-support-page
I don't know if this is what you were looking for, if by "Items" you mean Weapons and Protectors, I added a small plugin command that allows you to select the currently equipped object of a specific actor and reduce its durability. If it is something else, I fear it will not be possible.
This plugin is quite complex to customize as it works in a quite specific way.
All the best!
Hi Undermax, this plugin looks awesome!
Do you know if it is compatible with Visustella Plugins, specifically the Items Core entries?
Thank you for your time, looking forward to trying this out :)
Hi, friend! Thanks for your question, as far as I've been able to test I don't see any incompatibility with that plugin. So you shouldn't have any problems. All the best!
Edit:
I have tested it with the following set of plugins and have not noticed any problems:
- VisuMZ_0_CoreEngine
- VisuMZ_1_ItemsEquipsCore.js
- VisuMZ_1_MainMenuCore.js
For anything I remain at your disposal!
That's great, thank you for the reply! I appreciate your help
Hi, I love the idea of this plugin. I downloaded the demo, but it isn't quite working for me. Do you know if it is compatible with an ABS system (I'm specifically using Phoenix Kage Desu's Alpha ABS-Z) or does it measure the wear on durability only in the turn-based combat scenes?
Hello , Thank you very much for your interest. Since you are using a different battle system, it is logical that the plugin is not compatible since it is made to work based on the Battle Scene and as I understand, ABS is a system that runs on the map. Since I don't know how the Phoenix plugin works, and its complexity, I can't adapt it :(
You could contact the author of the plugin and perhaps they can make an adaptation for what you need. Greetings and i remain at your disposal!
I don't know if they would implement it at this time, but I'm definitely earmarking your plugin for a future project. Brilliantly done, great job!
❤️