Custom Hit Formula MZ

[ATT_Turan]

Custom Hit Formula 1.1
ATT_Turan​

Introduction
As far as I know, there's still no plugin written with the ability to provide a custom hit formula in MZ, and I got tired of telling people that

(apparently caethyril actually had one and I didn't know about it! Well, now you can try both and tell us who you like better. It should be me.)

So I wrote this to allow for custom hit formulae globally and/or per skill.

I tested the basic functions, please let me know if you run into any errors. Because it was necessary to modify code in the middle of the Game_Action.apply() function, this may cause conflicts with other plugins that modify the same function.

I will consider making compatibility patches if the other plugin is free to use and unobfuscated. Otherwise, other authors are free to modify this code to make it compatible with theirs so long as I am still credited.

Spoiler: Features

You may use this plugin to bypass MZ's default hit formula (a percentile check against the attacker's hit rate). You can redefine one universal formula to supplant it, modify it at the skill level, and decide whether evasion is checked separately.

The default behavior of the engine is to determine a hit and then check for evasion or magic evasion, depending on the skill type. You can choose to bypass this behavior in order to incorporate the eva/mev parameters into your formula (or to disregard them).

The hit formula notetags and plugin parameter function identically; the notetags will always override the plugin parameter, and the parameter is set to MZ's built-in calculation by default. So this plugin is as plug-and-play as the user desires, with the ability to change the hit calculations on just one or few skills if that's all that's required.

Spoiler: How to Use

Use the following notetag in the notebox of your skills:

<hitformula: your_formula_here>

The formula can be any valid JavaScript expression. An evaluation of "true" means the skill will hit, whereas "false" is a miss.

The below example is fashioned after the D20 system, adding d20 + level and comparing it to the target's Defense:
<hitformula: Math.randomInt(20)+1+a.level >= b.def>

Included variables are the same as those listed in MZ's damage formula, as well as user and target.

Terms and Credits
Free for non-commercial and commercial use. Credit ATT_Turan.

 

[Arthran]

For anyone who wants to use this with VisuStella Battle Core, it should be compatible as long as you place this plugin somewhere above Battle Core in your plugin manager.

 

[murilloc]

This is so incredible i'm beyond words!
It's simple, effective and give us plenty of possibilities.
Thank you so much @ATT_Turan

Just a quick question tho.
This formula already takes the evade parameters in consideration or i need to add it?

<hitformula: Math.randomInt(20)+1+a.level >= b.def>

 

[ATT_Turan]

This formula already takes the evade parameters in consideration or i need to add it?

That depends on how you configured the plugin parameters.

As I described in the instructions, checking evade is normally a second check unrelated to the hit formula.

So if you left that option on, then the engine will check evade as it always does.

If you turned it off, then no, there's nothing in your formula that references it.

 

[aironneil]

Sorry, but it doesn't seem to work for me. No matter what I put in the Hit Formula it doesn't do anything. I even tried making the formula always return false and it still just kept to the default. I turned all other plugins off to see if that made a difference and it didn't.

Edit: Nevermind, I forgot about hit rate with the default formula.

 

[bookco]

How do I make a certain hit formula for this plugin? I have tried <hitformula: true>, but it doesn't work in all cases. Would this be a compatibility issue with another plugin in that case?

EDIT: Nevermind, I answered my own question as I was asking it. I got my issue resolved by making sure both plugins were telling the skill to always hit.