Kadajah's Battle Trigger for RPG Maker MZ

Inject Adrenaline into Every Turn, Master the Timing, and Unleash Critical Combos.

Kadajah Battle Trigger (KBT) – Is a professional "Quick Time Event" (QTE) system designed to transform standard RPG Maker MZ combat into an interactive experience. It bridges the gap between passive turn-based strategy and active engagement, inspired by classic "Action Command" systems found in titles like Paper Mario, Shadow Hearts, and Final Fantasy VIII.

In v4.6, the plugin receives a massive visual overhaul. The "Arc" style has been refined into a sleek Speedometer with a precise Target Circle, and the new "Shutter" style introduces vertical precision bars perfect for cut-scenes or sniping skills.

In v4.7, A series of new features, a block and dodge system suggested by the user Raz, the addition of some extra screen effects, and a list of ready-made presets.

• Defensive QTEs (Dodge & Block):
  You can now assign QTE presets to enemy attacks! When an enemy targets a player character, a defensive trigger will appear. A standard success allows the actor to Block (reducing incoming damage by half), while hitting the Critical/Sweet Spot results in a Perfect Dodge (evading the attack entirely and taking zero damage). This can be assigned using the <BattleTriggerDef: X> note tag or enabled globally for all enemies via Plugin Commands.

• Screen Shake & Flash:
  You can now configure Screen Shake and Screen Flash effects specifically on Critical (Perfect) hits directly inside the Plugin Parameters for each preset. This adds a massive visual impact when the player hits the "Sweet Spot".
• 20 New Default Presets:
  The plugin now comes out-of-the-box with 20 distinct default setups ready to use, showcasing the full potential of every visual style (Square, Arc, Shutter, Bar, Circles, Drop, Expand, Charge, Linear track, and Boost mashing).

Total Control: You define the rhythm of battle. Create simple "Press OK" timing challenges, complex button sequences (Up, Down, Left, Right), or furious button-mashing tests of strength. Everything is fully customizable via a robust Preset System in the plugin parameters, change colors, adjust hit windows, add particle explosions, and set specific rewards for perfection.

Stop watching your battles. Play them.

Features

• Unique Visual Styles: Choose the perfect UI for every skill.
  • Square / Expand / Drop: Classic shrinking or falling shapes.
  • Bar / Charge: Sliding gauges and fill-meters.
  • Arc (New v4.6): A refined speedometer needle with a clean target zone.
  • Shutter (New v4.6): Cinematic bars closing in from top and bottom.
  • Linear: A scrolling track of inputs (Guitar Hero style).
  • Boost: A button-mashing test of endurance.
• Custom Particle Engine: Integrated particle system with 7 types (Star, Circle, Square, Triangle, Cross, Ring, and Shatter). Particles react to physics—"Shatter" particles obey gravity on failure, while "Ring" particles expand on impact.
• Input Sequencing: Require the player to press "OK", or specific keys like Shift, Control, Up, Down, etc.
• Risk & Reward System:
  • Skill Morphing: Transform a skill into a more powerful ID upon "Perfect" completion.
  • Damage Bonuses: Set separate multipliers for Hits and Criticals (Sweet Spots).
  • Fail Punishment: Set recoil damage (User takes % Max HP damage) if they miss the trigger.
• Perfect Finishes: Trigger a "Perfect Image" cut-in (Zoom, Fade, or Instant) with sound effects when a player hits 100% success.
• Smart Auto-Mode: Allow enemies (or lazy players) to use skills with a calculated success chance based on Luck stats.

Controls & Configuration

The plugin is designed to be "Set and Forget." You create your styles in the Plugin Parameters, and assign them to Skills, Items, or Weapons using a single ID.

Setup Workflow:

1. Open Plugin Parameters.
2. Configure a Trigger Preset (Visual Style, Difficulty, Colors).
3. Note the ID (e.g., 1).
4. Add the Note Tag to your Database.

Note Tag Examples:

• <BattleTrigger: 1>
  • Placed in a Skill or Item note box: Activates Preset #1 when this skill is used.
  • Placed in a Weapon note box: Activates Preset #1 when the actor attacks physically.
  • Placed in an Actor/Class note box: Sets a default trigger for that character.

Parameter Highlights:

• Duration: How fast the trigger moves (lower is faster).
• Tolerance: The size of the success window in frames.
• Zone Shrink: Make the hit window get smaller after every successful hit in a combo.
• Speed Accel: Make the trigger move faster with every hit.

Creative Gameplay Mechanics

Kadajah Battle Trigger isn't just a UI overlay; it allows you to design entirely new mechanics for your classes:

The "Limit Break" Rush:
Use the Boost visual style with Max Repeats: 20 and Duration: 120. Creates a mechanic where the player must furiously mash a button to charge up a massive attack.

The "Sniper" Shot:
Use the Shutter or Arc style with a very high Duration (slow movement) but a tiny Critical Tolerance (1 frame). High risk, massive critical damage multiplier.

Combo Chains (Rhythm):
Use the Linear style to create a scrolling bar of 5-10 inputs. Use Zone Shrink to make each subsequent hit harder. Reward the player with Extra Hits or Skill Morphing only if they complete the full chain.

The "Glass Cannon":
Create a forbidden spell with massive damage potential, but set Fail Recoil: 50. If the player misses the timing, their mage loses 50% of their HP.

Cinematic Finishers:
Use the Perfect Finish system to flash a high-quality character portrait or dynamic artwork across the screen only when the player executes a move perfectly.

Perfect Game Examples

Not sure if this fits your project? Here are 4 game genres that benefit perfectly from Kadajah Battle Trigger:

1. JRPG Classics: Recreate the "Gunblade" trigger or "Duel" mechanics from the PS1 era.
2. Action-RPGs: Make turn-based combat feel fast and visceral by keeping the player's hands on the controller every second.
3. Rhythm / Bard Games: Use the "Linear" track to make music-based classes that require playing notes to buff the party.
4. Tactical Hardcore: Games where resources are scarce, and landing a "Perfect" hit is the difference between life and death.

Terms of Use

• Commercial and non-commercial projects.
• You are NOT permitted to resell or redistribute this plugin, either on its own or as part of a bundle.
• You ARE permitted to edit the plugin's code for your own project's use. However, you are NOT permitted to redistribute the edited version of the plugin.