Limited Skill Uses (YEP)
VisuStella, Caz Wolf, Fallen Angel Olivia, Atelier Irina, and other affiliated content creators.
Download
System
This is a plugin created for RPG Maker MV.
For help on how to install plugins, click here.
For help on how to update plugins, click here.
Got errors with your RPG Maker MV plugin? Click here.
Required Plugins
The following plugins are required in order to use this plugin.
Place the following plugins above this plugin located in the Plugin Manager.
Yanfly Engine Plugins
This plugin is a part of the Yanfly Engine Plugins library.
Introduction
This plugin requires YEP_SkillCore. Make sure this plugin is located under YEP_SkillCore in the plugin list. This plugin enables you to set a limited amount of times certain skills (or all skills) can be used per battle or ever. This adds a different type of skill currency and balance mechanic in limiting the amount of times a skill can be used without directly having to alter MP, TP, or the like.
Notetags
RPG Maker MV's editor is unable to allow for custom traits/properties that a game dev may wish to associate with a database object, event, map, etc. Notetags are used to work around such limitations by allowing the game dev to tag certain traits/properties using specific Notetags declared by the related plugin.
Here is a list of Notetag(s) that you may use.
---
You can use these notetags to govern the various Limited Uses aspects of your skills. Skill Notetags: <Unlimited Use> If you've enabled 'Limit All Skills' in the plugin parameters, this will forcefully make the skill unlimited use. If you use this notetag, it will override any of the Limited Use settings. <Limit Uses: x> This will set the number of times the skill can be used to x. If the skill has 0 charges left, the skill cannot be used. <Recover All Uses> <Not Recover All Uses> When using the recover all command, depending on the settings within the plugin parameters, all limited use charges are recovered or not. These notetags will enable you to utilize the other setting for the skill. <Victory Uses Recover: x> <Escape uses Recover: x> <Lose Uses Recover: x> When the player wins a battle, escapes a battle, or loses a battle, the skill use will recover x amount of uses for the respective outcome. If the notetags aren't used, the amounts restored will be equal to settings made in the plugin's parameters. <After Battle Uses Recover: x> This will set the recovery rate of victory, escape, or loss of battle to be equal to x indiscriminately. Skill and Item Notetags: <Global Limited Uses: +x> <Global Limited Uses: -x> This will change the target's limited uses by +x or -x for all skills. +x will increase the amount of times the skills can be used. -x will decrease the amount of times the skills can be used. <SType x Limited Uses: +y> <SType x Limited Uses: -y> This will change the target's limited uses by +y or -y for all skills of the skill type x. +y will increase the amount of times the skills can be used. -y will decrease the amount of times the skills can be used. <Skill x Limited Uses: +y> <Skill x Limited Uses: -y> <Skill name Limited Uses: +y> <Skill name Limited Uses: -y> This will change the target's limited uses by +y or -y for skill x. If you use the named notetag varient and have multiple skills in the database with the same name, priority will be given to the skill with the highest ID. +y will increase the amount of times the skills can be used. -y will decrease the amount of times the skills can be used. Actor, Class, Enemy, Weapon, Armor, and State Notetags: <Global Use Max: +x> <Global Use Max: -x> A battler affected by this property will have any Limited Use skills alter the maximum times used by +x or -x. <SType x Use Max: +y> <SType x Use Max: -y> A battler affected by this property will have Limited Use skills from skill type x alter the maximum times used by +y or -y. <Skill x Use Max: +y> <Skill x Use Max: -y> <Skill name Use Max: +y> <Skill name Use Max: -y> A battler affected by this property will have Limited Use for skill x (or named if you're using that version of the notetag instead) alter the maximum times used by +y or -y. If you are using the named version of the notetag and have multiple skills in the database with the same name, then priority will be given to the skill with the highest ID.
Lunatic Mode
For advanced users who have an understanding of JavaScript, you can use the following features added by the plugin to further enhance what you can do with your game project.
Altering Target's Limited Uses
For those with JavaScript proficiency, you can use the following notetags to perform conditional changes to the target's Limited Uses. Skill and Item Notetags: --- --- --- <Custom Global Limited Uses> value += user.level; </Custom Global Limited Uses> The 'value' variable is the number of uses the user will gain for all Limited Use skills. --- --- --- <Custom SType x Limited Uses> value += user.level; </Custom SType x Limited Uses> The 'value' variable is the number of uses the user will gain for all Limited Use skills of skill type x. --- --- --- <Custom Skill x Limited Uses> value += user.level; </Custom Skill x Limited Uses> or <Custom Skill name Limited Uses> value += user.level; </Custom Skill name Limited Uses> The 'value' variable is the number of uses the user will gain for all Limited Use skills of skill x. If you are using the named version of the notetag and you have multiple skills in your database with the same name, priority will be given to the skill with the highest ID. --- --- ---
Conditional Max Uses
For those with JavaScript proficiency, you can use the following notetags to perform conditional changes to the target's Limited Use Maximums. Actor, Class, Enemy, Weapon, Armor, State Notetags: --- --- --- <Custom Global Use Max> value += user.level; </Custom Global Use Max> The 'value' variable is the maximum uses the target will gain for all Limited Use skills. --- --- --- <Custom SType x Use Max> value += user.level; </Custom SType x Use Max> The 'value' variable is the maximum uses the target will gain for all Limited Use skills of skill type x. --- --- --- <Custom Skill x Use Max> value += user.level; </Custom Skill x Use Max> or <Custom Skill name Use Max> value += user.level; </Custom Skill name Use Max> The 'value' variable is the maximum uses the target will gain for all Limited Use skills of skill x. If you are using the named version of the notetag and you have multiple skills in your database with the same name, priority will be given to the skill with the highest ID. --- --- --- * Note: Keep in mind that none of the adjustments here will bypass the 'Absolute Max' setting in the plugin parameters. That is the ceiling.
Changelog
Version 1.06: - Bypass the isDevToolsOpen() error when bad code is inserted into a script call or custom Lunatic Mode code segment due to updating to MV 1.6.1. Version 1.05: - Updated for RPG Maker MV version 1.5.0. - Added new 'Bypass List' plugin parameter. Version 1.04: - Lunatic Mode fail safes added. Version 1.03: - Compatibility update with Equip Battle Skills and Equip Skill Tiers. Version 1.02a: - Updated for RPG Maker MV version 1.1.0. - Fixed notetag category in documentation for Lunatic Mode - Conditional Max Uses. Updated from Skill and Items to Actor, Class, Enemy, Weapon, Armor, and State Notetags. Version 1.01a: - Optimization Update. - Various functions in the skill window will now return their x positions. Version 1.00: - Finished Plugin!