Limited Skill Uses (YEP)

From Yanfly.moe Wiki
Jump to navigation Jump to search

<

Welcome to the wiki! This is where you can find resources from Yanfly.moe, Ækashics.moe,
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

NotetagsMV.png

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

JavaScript.png

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!