Unified Combat

A compatibility bridge for Iron's Spells and Spellbooks, Better Combat, and Combat Roll

Unified Combat Changes how spell casting, rolling, and attacking work together with clear rules you can customize.

Roll - Spell Interaction

Instant Cast Cancel — If you roll while casting a spell, the spell gets cancelled immediately. You'll see the animation stop and the server stops the spell logic.
Roll Lock While Casting — Blocks you from rolling while you're casting a spell. This is OFF by default. To turn it on, you need to turn OFF Instant Cast Cancel.
Spell Whitelist — You can make certain spells (like Magic Arrow, Root, Poison Arrow) ignore these rules. Those spells let you roll freely or keep casting even if you roll.
Input Buffering (Roll Queue) — If you press roll in the last 5 ticks (0.25 seconds) of casting, the mod remembers it. The roll happens automatically right when your spell finishes. You can change how long this window is.

Combat Interaction

Better Combat Upswing Cancel — Rolling stops any Better Combat attack you're in the middle of. Your attack gets reset so you can dodge cleanly.
Roll Lock While Attacking
While performing a Better Combat attack, rolling is temporarily locked until the attack completes or is canceled.

Input Control & Feedback

Keyboard & Mouse Roll Interception
Roll input is intercepted before reaching Combat Roll when:
You are attacking and roll lock is active, or
You are casting a spell that is not whitelisted
This ensures roll behavior is handled consistently and prevents unintended dodges.
Player Feedback
When a roll input is blocked (due to attack lock or spell restrictions), the player receives:
An on-screen message explaining why the roll was blocked
A sound cue for immediate feedback
Both can be disabled via the config.

Combat Consequences

Mana Penalty ("Panic Roll") — If you cancel a spell by rolling, you lose some mana. The amount depends on how much of the spell's mana cost you want to charge (you set the percentage).
Anti-Spam Cooldown — After cancelling a spell, you can't cast that same spell again immediately. There's a short cooldown.
School-Based Backlash — Cancelling certain magic can hurt you based on what type of spell it was:
- Fire spells → You catch on fire
- Ice spells → You get slowed
- Lightning spells → You get shocked
- (You can turn this on/off and adjust the chance)

Visual & Audio Effects

Directional Particle Trails — When you roll-cancel a spell, particles shoot out in the direction you're rolling (like the Blood Step effect).
School-Specific Cancel Sounds — Different spell types make different sounds when you cancel them.

Configuration You can customize everything in the config file:

Enable or disable roll locking while attacking
Toggle roll lock during spell casting
Adjust the roll input buffer window
Define whitelisted spells that can roll-cancel
Set mana penalties for blocked roll attempts
Enable or disable backlash effects and configure their chance
Toggle feedback messages and sounds independently

This allows full control over combat commitment, responsiveness, and difficulty.

Credits