DOL's MultiHit Plugin MV / MZ

DOL Multi-Hit adds a flexible, rank-based multi-hit system to RPG Maker MV/MZ that works on top of your existing damage formulas and battle plugins.

Help Guide written by ChatGPT.

Main features:

• Rank-based extra hits: Convert high HIT% and/or AGI into “ranks” that become extra hits, with multiple randomization modes (always, chance, dice, bell curve, chain, thresholds, rank table).

• Configurable rank sources: Choose whether ranks come from HIT, AGI, both, or only from bonuses; optional AGI-difference vs target for advantage/disadvantage ranks.

• Deep notetag support: Per-skill/weapon/armor/state/class/actor/enemy control over modes, bonus ranks, rank caps, min/max hits, elemental rank bonuses, miss behavior, and more.

• Miss and graze control: Turn misses into partial “grazes” or full hits, or keep them as true misses, with per-object overrides.

• Guard break and armor shred: Trigger extra states on the target if an action reaches a certain hit count.

• Combo memory: Build a “combo level” from hits and use it in formulas (a.comboLevel), with per-trait gain, cap, and decay.

• Backlash and risk: Reflect a percentage of final damage back to the user and/or apply states when hit count exceeds a threshold.

• TP integration: Gain TP per rank and/or per hit, fully configurable.

• Visual feedback: Optional battle log text and animated popups (text or pictures) showing hit counts, with color tiers and simple animation controls.

• Compatibility modes: Works in vanilla, plus an alternate “framework” mode that scales final damage inside executeHpDamage for better cooperation with large battle cores.

==================================================

Terms of Use

==================================================

By purchasing this plugin, you agree to the following terms.

1. Usage

   - You may use this plugin in any number of commercial and 

     non-commercial RPG Maker projects, as long as you legally purchased it.

   - You may use it in both free and paid games.

2. No Redistribution

   - You may NOT upload, share, distribute, or resell this plugin or its

     modified versions.

   - You may NOT include the plugin in public repositories, asset packs,

     plugin bundles, starter projects, or templates.

   - Exception: Team members working on the *same* game project may share

     the plugin internally for that project only.

3. Modifications

   - You may edit/modify this plugin for your own personal projects.

   - You may NOT distribute modified versions.

   - You may share screenshots, note-tag examples, parameter setups, etc—

     just not the plugin code itself.

4. Credit

   - Please include credit in your game:

       "Plugin by DOLGRIM"

5. Liability

   - This plugin is provided “as is” without warranty of any kind.

   - I am not responsible for project corruption, data loss, or compatibility

     issues with other plugins.

   - Always keep backups of your project before adding or updating plugins.

==================================================

Not working? Try

1: Make sure your parameters and tags are correct.

1: Moving the plugin around in your pluginlist

2:  Try it without other plugins on.
If you get an error, you can press F12. You get a list of errors, if any other plugin name is on that list then they are most likely incompatible. 

3: Report to me, there might be something I have overlooked, it can be difficult to test every feature in a plugin like this, especially with me adding so much more then I intended.