RNK Angry Init™
Recovery Time Initiative system for Foundry VTT & D&D5e
Copyright © 2025-2026 Asgard Innovations / RNK™
Based on [The Angry GM's Recovery Time Initiative] (https://theangrygm.com/fixing-initiative-because-i-want-to-part-ii-angrys-recovery-time-initiative-system/), this module transforms combat into a dynamic phase-based system where actions determine recovery time.
DEVELOPMENT ROADMAP: See [PHASED-UPGRADE-ROADMAP.md] (PHASED-UPGRADE-ROADMAP.md) for the 18-month expansion plan (8 initiative variants)
MODULE HEALTH: See [MODULE-SWEEP-REPORT.md] (MODULE-SWEEP-REPORT.md) for current status and issues
Features
- Phase-Based Combat (1-10): Initiative becomes ongoing - your action determines when you act next
- Recovery Rolls: Different actions have different recovery times (attacks use weapon die, spells use d8/d10, etc.)
- Size-Based Initiative: Creatures roll initiative die based on size (Small≤d4, Medium=d6, Large=d8, Huge+=d10)
- Knockback System: Large hits can knock opponents back in the initiative order
- Recovering Status: Track when combatants are vulnerable and unable to take reactions
- Seamless D&D5e Integration: Uses hooks, no system modifications needed
Quick Start
1. Install the module in Foundry VTT
2. Enable in your D&D5e world
3. Start combat - initiative dice are rolled automatically based on creature size
4. Each turn, the system prompts for recovery roll based on action taken
5. Combatants act when their phase comes up (phases 1-10)
How It Works
Initiative Roll At combat start, each combatant rolls their Initiative Die (based on size) to determine their starting phase (1-10).
Taking Actions When your turn ends, you roll a Recovery Die based on your action:
-Attacks: Weapon's base damage die (shortsword = d6, greatsword = d10)
- Spells: d8 (cantrips = d6, upcast = d10)
- Dash/Disengage/Dodge/Hide: Your initiative die
-Ready: Phase 1 if action doesn't trigger
Modifiers
- Bonus Action Used: Upsize die (d4→d6, d6→d8, d8→d10, d10→d12)
-Checked Attack: Downsize die (minimum d4)
-Multiple Attacks: Use highest damage die
Recovery Phase Your recovery roll determines your
Next Phase (when you act next round).
While recovering, you:
- Cannot take reactions
- Are vulnerable to Sneak Attacks
- Show "Recovering" status in combat tracker
Settings
- Enable Core Initiative System: Toggle the module on/off
-Auto-Size Initiative Die: Automatically assign initiative die by creature size
-Block Reactions While Recovering: Prevent reactions during recovery
-Knockback Threshold: Enable knockback mechanic (planned for future phase)
-Show Phase Visualizations: Display phase trackers on tokens
API & Macros
Access the module API for integration with macros and other modules:
```javascriptconst api = game.modules.get('rnk-angry-init').api;const phase = await api.rollRecovery(combatant, 'attack', { baseDamageDie: 'd8' });```
Full API Documentation: See [docs/API.md] (docs/API.md)
Testing
Run the comprehensive test suite:
```bashnpm test```
Tests validate functionality, integration, performance, and security (38 tests, 4 suites).
Compatibility
-Foundry VTT: v11-v12-v13
D&D5e System: v3.0.0+
- Works with existing modules via hook-based integration
Credits
System design by [The Angry GM] (https://theangrygm.com/)Module by The Curator (RNK Codex series)
My Story
I am a Game Master (GM) who has always been passionate about tabletop role-playing games. My journey into development began unexpectedly after a career as a truck driver came to an end due to health challenges. In 2021, I suffered several strokes that forced me off the road, leaving me with limited mobility and energy for outings that would otherwise exhaust me for days.
What started as simple curiosity about what a macro could do in Foundry Virtual Tabletop quickly evolved into a full-fledged passion for development. My first major creation was a 3D animated cube with 41 lines of code, which became the foundation of the RNK brand. As a self-taught developer working from my garage, I approach every project with meticulous research and innovative thinking. I refuse to settle for anything less than excellence, pushing myself to create modules that not only function flawlessly (however, there are always bugs) but also enhance the gaming experience for fellow GMs and players.
This work keeps me engaged and my mind active during a time when physical limitations restrict my activities. I am engaged to the love of my life, Ms. Lisa, and without her unwavering support, I wouldn't be able to bring anything that I do to the community. It is with her support and encouragement that I have excelled to become what I am today.
I will continue creating and innovating until boredom sets in or health prevents it—whatever comes first.
Eventually, I will be looking for someone to take over these modules, someone with the drive and tenacity that I wake up with every day. In the meantime, I am open to collaborations if the project peaks my interest. My modules are born from this dedication, crafted with the same care and precision that defined my driving career, now channeled into the digital realm of virtual tabletop gaming.
Thank you for supporting my creations and sharing in this journey.
For collaborations or inquiries: Email: Asgardinnovations@protonmail.com
Discord: Odinn1982
Location: Eastern US
As always, love and respect from the RNK Enterprise, Odinn
Support
For bugs, issues, and discussions, please visit the public repository: [RNK Angry Init Issues](https://github.com/RNK-Enterprise/rnk-angry-init/issues)
License
MIT License