YR's New Parameters Plugin

This plugin allows the developer to utilize more parameters, for both actors and enemies (from here on mentioned as "battlers"), than the default ones set by RPG Maker MV.

They are independent among different battlers, meaning you should not expect to use them for the whole party.

Important note: this is an internal mechanics plugin. It does not affect menus and the like. Menaing you can create the parameters and use them, but will need something else to show them.

Compatible with most Yanfly plugins, including Item Core, Equip Core and Attachable Augments and even Equip Battle Skills.

Compatible with RPG Maker MV versions above 1.5.1.

The parameter's value should be able to be called by using: 

battler.(command Name)

For example, if the command name is "test", battler.test should return the value of the test parameter for that battler.

[NEW from 1.07] Now you are able to replace the default parameters with your own coded with this plugin.

Be aware this is a new feature, and while I did my best to avoid them ther emay still be some bugs unsquached.

A quick manual:

When you install the plugin, it seems to have only one parameter, called "Parameters".

But, when you open it, you see that is wrong.

"Parameters", when opened, reveals itself as a list. Each of your new parameters will be an element in this list.

Important note: Every time you need to call the parameter's id through code, the number is the position on the list -1. In the example image, the parameter's id is 0.

Open the parameter in the list - or in the case of a new one open the empty one, in the image the 2 but on a first use the 1, to actually change the parameter.

• The first line is the parameter's command name, or the stat's name. It is the value, together with the id that you get on the list, that you will use the most after it is all set to use.
  Example, calling for the pictured example in a damage formula would be a.armPen. Be careful though, the Command Name is case sensitive, meaning armPen is different from armpen.
• The second line is the parameter's text name. Just in case you are using the messages for buff/debuff and the like. You can also call it in custom-made menus. Most won't use it, though.
• The third line is the preset base of the parameter. The default formula is this.level ? (level * 1) : 1 meaning that, if the battler has a level (being an actor or using an enemy levels plugin) the value will be the level, else it will be 1. Feel free to change it to fit your real needs. As you can see, in the example image it is 0.
• Can also be set individually for each actor or enemy through a notetag <change stat base formula: x>, x being the new formula and stat being the parameter's command name.
• The fourth line is the parameter's formula. It is based on the Yanfly parameters formulas, in for example his Base Parameters plugin. You can add or remove from it as needed, but I suggest only adding to the formula and not removing the variables.
• The fifth line is the parameter's buff formula. It is the formula used when buffing/debuffing to set the parameter's formula buffRate.
• The sixth and seventh lines are the parameter's minimum and maximun value. They can be changed for a certain battler through notetags.
• The next four lines are the max number of how many times something can be buffed/debuffed on this stat, default and maximum values. The value can be changed through notetags for a certain battler, as long as it is more than 0 and less or equal to the value set as max.
• And the final four lines are icons for buffs and debuffs, first and second stages (second stages when they are buffed/debuffed more than once). They can be left as 0 for no images (or to still use the one of the first stage, in the case of the second stage).

In case of any more doubts not understandable here or in the help of the plugin, feel free to ask.

Notetags

"stat" should be the parameter's command name

Actors, Classes, Enemies
(Actors has preference over Classes)

<change stat base formula: x>

"x" should be the formula

Allows you to set a different formula for this battler for the parameter's base than the one set on the settings. For example, two actors' base atk grow different, even at the same level.

Actors, Classes, Enemies, Weapons, Armors, and States

<stat Plus: +x>
<stat Plus: -x>

Adds/Subtract value to the "plus" in the parameter's formula.
By defaut "plus" is added to the base, like for stat-up items.

<stat Rate: +x>
<stat Rate: -x>

Multiplies the value of the "rate" in the parameter's formula.
By defaut "rate" multiplies "base" and "plus", like for states that double attack for a small bit.

<stat Flat: +x>
<stat Flat: -x>

Adds/Subtract value to the "flat" in the parameter's formula.
By defaut "flat" is added to the result, after the rest of the calculations.

<stat Min: x>
<stat Max: x>

Sets the minimun/maximum value the stat can have.
Preference is for the higher value, both for minimum and maximum.

<Max stat Buff: +x>
<Max stat Buff: -x>
<Max stat Debuff: +x>
<Max stat Debuff: -x>

Changes the stat's buff/debuff limit by the set number.

Skills and Items

<Apply Buff stat x Turns>
<Apply Debuff stat x Turns>

Applies a buff/debuff of x turns to the stat.

<stat Buff Turns: +x>
<stat Buff Turns: -x>
<stat Debuff Turns: +x>
<stat Debuff Turns: -x>

Changes the duration of a buff/debuff the stat may have.

<Custom stat Buff Turns>
turn = x;
</Custom stat Buff Turns>
<Custom stat Debuff Turns>
turn = x;
</Custom stat Debuff Turns>

Sets the duration of a buff/debuff the stat may have to "turn".

If you have YEP_EquipBattleSkills, Skills

<Equip stat: +x>
<Equip stat: -x>

Increases or decreases the stat if skill is equipped.

Functions

As mentioned before, paramId is the parameter's id in the list - 1.

battler.clearYRparamPlus()

Sets all Plus of the battler's custom stats to 0.

battler.setYRparam(paramId, value)

Sets the plus of the custom parameter to get the stat to the value.

battler.setYRparamPlus(paramId, value)

Sets the plus of the custom parameter to the value.

battler.addYRparamPlus(paramId, value)

Adds value to the custom parameter's plus.

battler.minusYRparamPlus(paramId, value)

Subtracts value of the custom parameter's plus.

battler.setYRparamCustomMin(paramId, value)

Sets the custom parameter's minimum value.
If a higher value is set through other means, the higher value wins.

battler.setYRparamCustomMax(paramId, value)

Sets the custom parameter's maximum value.
If a higher value is set through other means, the higher value wins.

battler.clearYRparamCustomLimits()

Removes limits set with setYRparamCustomMin and setYRparamCustomMax.

battler.addYRBuff(paramId, turns)

Adds a buff to the custom parameter.

battler.addYRDebuff(paramId, turns)

Adds a debuff to the custom parameter.

battler.removeYRBuff(paramId)

Removes the buffs and debuffs of the custom parameter.

battler.removeAllYRBuffs()

Removes the buffs and debuffs of all custom parameters.

battler.overwriteYRBuffTurns(paramId, turns)

If "turns" is higher, set the buff/debuff's remaining turns for it.

battler.setYRBuffTurns(paramId, turns)

Sets the buff/debuff's remaining turns.

battler.isYRBuffAffected(paramId)
battler.isYRDebuffAffected(paramId)
battler.isYRBuffOrDebuffAffected(paramId)

Tells if the battler is being affected by a buff, debuff or either.

battler.YRBuff(paramId)

Tells the current levels of buff on the battler.
Debuffs are negative.

battler.YRBuffTurns(paramId)

Tells the current remaining number of turns for the buff.

From here on the codes are for altering the formula values directly. Only use if you know what you are doing.

battler._YRparamPlus[paramId]

The value of the parameter's plus.
Also for items.

battler._YRparamRate[paramId]

The value of the parameter's rate.
Also for items.

battler._YRparamFlat[paramId]

The value of the parameter's flat.
Also for items.

Using parameters created with it instead of the original RPG Maker ones

While I am already coding an upgraded version of this plugin with this feature already in, it would be a very different plugin in many aspects.

Thus I thought better to release this updated for the original.

The way to use is simple: just name the parameter's command name to the same name as the parameter it will replace.

To use the original values in the base formula, that is the one in the database, classes or enemies, for the base params, and for the special and extra the combination of the traits on the character.

For base params, traits are already added to the paramRate, and equipment is already added to the paramPlus.

For the special and extra parameters, do not forget to set the minimum value. Those numbers are used as percentages, and thus are supposed to be able to reach 0 or even become negative.