Lisa's Angry Initiative v 2.0.2
Recovery Time Initiative v2 for Foundry VTT and D&D5e — Now free and open-source!
Based on The Angry GM's Recovery Time Initiative, this v2.0 module expands combat into a phase-driven loop with advanced modifiers, phase variants, custom recovery tables, and deep integration hooks.
Features
Free and open-source module for Foundry VTT.
- GitHub: Lisa's Dungeon on GitHub
- License: MIT
Features (v2.0.2)
Core System
- Phase-based combat from Phase 1 through Phase 10 (or variant count)
- Size-based initiative dice (tiny d4 → gargantuan d12)
- Recovery rolls tied to attacks, spells, movement, and ready actions
- Recovery-state reaction blocking
Advanced Modifiers
- Condition-based die adjustments (stunned, paralyzed, exhaustion, inspired, blessed, haste)
- Bonus action upsizing (die advancement by one step)
- Checked attack downsizing (die reduction by one step, minimum d4)
- Stacking modifier support
Phase Variants
- Standard — Phase 1-10, traditional recovery mechanics
- Gritty — Phase 1-12, longer tactical positioning window
- Heroic — Phase 1-8, faster action economy
- Custom — Create unlimited custom variants with arbitrary phase counts
Custom Recovery Tables
- Define recovery rules per action type (attacks, spells, movement, etc.)
- Pre-built tables: Standard Melee, Spellcaster, Archer
- Mix and match rules for homebrew mechanics
- GM-configurable per world
Recovery History Tracking
- Per-combatant recovery log (up to 100 entries)
- Timestamp, action type, die, roll result, conditions
- Query history for tactical decisions
Phase Indicators
- Visual phase badges on token displays
- Combat tracker integration
- Real-time phase state tracking
- Color-coded phase display
Integration Hooks
beforePhaseChange— Pre-phase modificationafterPhaseChange— Post-phase triggersbeforeRecoveryRoll— Pre-roll adjustmentsafterRecoveryRoll— Post-roll processingbeforeCombatStart— Combat setupafterCombatEnd— Combat cleanuponConditionApplied— Condition triggersonConditionRemoved— Condition cleanup
Custom module developers can hook into any stage of combat flow.
Screenshots
Current compatibility
- Foundry VTT: v13+ (verified v14)
- D&D5e System: v3.0+
Quick start
- Install the premium package through your Patreon distribution flow.
- Enable
Lisa's Angry Initiativein your world. - Start combat and the module assigns opening phase from each combatant's initiative die.
- At the end of each turn, roll recovery to determine the next phase.
Recovery basics
- Attacks use the weapon's recovery die.
- Cantrips use
d6. - Leveled spells use
d8, ord10when upcast. - Dash, Disengage, Dodge, Hide use the combatant's initiative die (size-based).
- Ready without a trigger returns the combatant to Phase 1 next round.
Bonus actions upsize the recovery die by one step. Checked attacks downsize it by one step, to a minimum of d4.
Conditions like exhaustion, stunning, paralysis also adjust recovery dice.
API
The module exposes a comprehensive public API through game.modules.get('lisas-angry-initiative').api or window.LisasAngryInitiative.
Recovery Methods
getRecoveryDie(actionType, options)
getInitiativeDieBySize(actor)
upsizeDie(die)
downsizeDie(die)
applyAdvancedModifiers(die, combatant, options)
rollRecovery(combatant, actionType, options)
getHistory(combatantId, limit)
clearHistory(combatantId)
clearAllHistory()
Phase Variant Methods
getActiveVariant()
setActiveVariant(variantId)
getAllVariants()
createCustomVariant(variantId, config)
deleteCustomVariant(variantId)
getPhaseCount()
constrainPhase(phase)
constrainRecovery(rollResult)
Custom Recovery Table Methods
createTable(tableId, config)
getRecoveryDieFromTable(tableId, actionType)
getAllTables()
deleteTable(tableId)
updateTableRules(tableId, rules)
Integration Hook Methods
registerHook(hookId, handler)
fireHook(hookId, context)
unregisterHook(hookId, handler)
getAllHooks()
Phase Indicator Methods
getTokenIndicator(tokenId)
setTokenIndicator(tokenId, phase)
removeTokenIndicator(tokenId)
getAllIndicators()
createPhaseDisplayUI()
Module Info
getVersion()
getStatistics()
Documentation
docs/API.md— Full API reference with examples, including phase variants and custom recovery tablesdocs/gm-guide.md— GM workflow and rulings
Support
For release access, support updates, and premium distribution:
- Patreon: Lisa's Dungeon Patreon
For direct inquiries:
- Email: lisasdungeon@gmail.com
- Discord: MystryssLysa
License
This project is licensed under the MIT License. See LICENSE for details.
Lisa's Angry Initiative v2.0.2 — Combat reimagined through recovery time and phase-driven mechanics.


