MV/MZ Weapon Attack Formulas

Ramza's Weapon Attack Formulas plugin

This is a fairly simple plug and play plugin that makes one major change to the way the battle engine for RMMV works, and has a few little things you can tweak to your liking as well.

This plugin allows you to override the damage formula for the default attack skill, as well as other skills that you tag specifically using a note tag. You override the damage formula either via note tag on a specific weapon, or via the plugin parameters, where you can set an override for a weapon type.

As of Version 1.11 this plugin also supports RMMZ - the newest version of rpgmaker.

But why though?

Glad you asked. Every actor has the default attack skill (unless you use a certain Yanfly plugin, more on that later), and for every actor that skill has the same damage formula. You can use weapons to change the default element of the attack skill, even add effects like poison to it, but you can't change that damage formula at all. What if you have a speedy actor with a pair of knives who wants his agi to affect his default attack skill? How about a mage character whose staff does melee damage based on his m.attack rather than his attack? Well without a plugin, these examples were impossible.

Now, Yanfly has a great plugin to help remedy this problem too, The YEP_WeaponUnleash plugin, but there are a couple of issues with using that plugin for this specific use-case.

• Skill bloat
  • Each skill that you make for replacing the attack skill takes up space in your database.
  • Each time you update your original attack skill, to add a new trait, new note tags, new action sequences, before/after evals, etc, you must go through and update each of the replaced attack skills as well.
• Replace attack doesn't properly support dual wielding.
  • Having multiple weapons with replace attack skills on them results only in the first one that is found being used. 
  • This will result in unexpected damage, missing added effects/traits, and incorrect animation(s).

This plugin solves the problems above in the following ways:

• Because it is simply replacing the formula on the default attack skill, there is only one attack skill to keep track of. You don't need to update a dozen replacement skills when you change one thing about your default attack skill.
• This plugin was made with (improved) dual wielding in mind, and is capable of updating the damage formula for the skill being used as it's being used, allowing you to dual wield weapons with very different damage formulas seamlessly, especially when used in conjunction with my Dual Wield plugin.

While it was designed with dual wielding in mind, this plugin doesn't have any dependencies, meaning you don't necessarily need the dual wield plugin to make use of it. So go ahead, make that magic staff that hits harder when your m.attack is higher, no other plugins needed!

Plug and Play:

Setup for this plugin is easy, it does most of the heavy lifting in the background, all you need to do is set some damage formulas for weapon types or specific weapons and you're good to go. The damage formula for the basic attack skill is automatically replaced with a weapon damage formula if it exists, which it checks for first on the weapon being used, and then in the plugin parameters for the wtype being wielded. 

If you're dual wielding weapons with weapon attack formulas, only the formula for the weapon in the main hand will be used. If only the offhand weapon has one, it will be used instead. If you're using my dual wield plugin, each weapon swing will use the weapon formula of the weapon being swung for that hit, if one isn't present for a specific weapon, the default attack skill formula will be used instead.

Advanced Use:

The basic attack skill isn't the only skill that can be modified by this plugin. By tagging a skill as a <Weaponskill>, you tell the plugin to sub in the weapon formula in place of the formula for the skill being used. This works the same way as the basic attack skill, and even has some interactions with the skills tags from the dual wield plugin.

Also, your new damage formulas don't need to be only one line anymore. You can define new variables, call new functions, and have access to all of the same values that the normal formula has. A particularly long formula might need a return statement in order to be valid, though.

Note Tags:

<Weapon Formula>
code
code
</Weapon Formula>

Put on a weapon, the code inside the tags replaces the damage formula of the default attack skill, and any other skills you tag with the below tag. New in Version 1.10, this tag can now also be placed on enemies.

<Weaponskill>

This tag notes a skill that will have its damage formula replaced by a weapon formula, if available.

New Function:

With version 1.10 I have added a new function which can be called from the damage formula of any skill. this.weaponFormula() calculates the current custom damage formula of the user, and injects it into the current damage formula. If the attacker doesn't have a custom formula, this function returns 0. 
Additionally, if you feed the function a default formula, instead of 0, it will return that value instead. This allows you to replace part of a damage formula with the custom formula of the attacker, or continue to use a 'default' portion of the formula if the attacker doesn't have a custom formula set. This function must be wrapped in an eval() function in order for it to work correctly, see below:

Example:

eval(this.weaponFormula()) * 2

The above damage formula will return double the attacker's custom formula, or zero if the attacker doesn't have one.

eval(this.weaponFormula(100 + a.mat)) * 2

This is the same formula again, but this time the function is fed a default formula value. This will still return double the attackers custom formula, if he has one, but if he doesn't, it will return 200 + (a.mat * 2)

Plugin Parameters:

The only configurable parameter is used to set up damage formulas for specific weapon types. Weapon type 0 is unarmed. The other numbers correspond to the weapons list in the types tab in your database. You can set a formula for as many or as few weapon types as you like, anything that doesn't have a formula set here, will use the default damage formula as if this plugin wasn't installed.

Terms of Use:

You may:

• Use this plugin in all of your free and commercial projects, with credit to me, Ramza.
• Modify this plugin to add or remove features, or compatibility with other plugins, for personal use only.
• Create and share extensions to this plugin, to add features or compatibility, such that anyone using the extension requires the original plugin.

You may not:

• Claim ownership of this plugin, or change the header text on it.
• Directly share this plugin with others, or share modified versions of it.

<Weapon Formula>
if (a.isStateAffected(26)){
 return a.atk * 4
} else {
 return a.atk * 3
}
</weapon formula>

var wpn = eval(this.weaponFormula(1)); a.mhp * 0.1 + wpn 

a.mhp * 0.1 + eval(this.weaponFormula())

var w = (user.isActor() && user.weapons()[0] && user.weapons()[0]._customFormula) ? eval(user.weapons()[0]._customFormula) : (a.atk * 4 - b.def *2); w