Implement boss monsters with hit points and multi-hit mechanics

[h1ddenpr0cess20]

This PR adds a boss monster system where certain enemies have multiple hit points and require multiple successful hits to defeat, rather than being defeated in a single blow.

Summary

Boss monsters now have hit points (hp) and can survive multiple hits from the party. They always land at least a quarter of their power in damage, hit harder on failed rolls, and have a guard cooldown between hits. The battle system now tracks hits landed and remaining HP, with the UI displaying remaining hits during multi-hit boss fights.

Key Changes

• Boss hit points system: Bosses have an hp property and take multiple hits to defeat. Each hit reduces their HP, and they're only defeated when HP reaches 0.
• Guard cooldown: After taking a hit, bosses enter a 1.5-second guard state where they can't be hit again, giving them a moment to recover.
• Damage scaling for bosses:
  • Bosses always deal at least 1/4 of their power in damage (even on critical hits)
  • Failed rolls against bosses cost 4/3 more damage than against regular enemies
  • Critical hits land 2 hits instead of 1; fumbles land 0 hits
• Battle UI updates: The loot display now shows remaining hits during multi-hit fights instead of gold, and boss-specific flavor text appears for critical and success grades.
• Monster stat adjustments: Eggdreessen (dc 16→17, hp: 3) and Red Dragon (dc 17→18, power 12→14, hp: 4) updated as bosses.
• Die physics: When a boss survives a hit, the die is knocked back away from the boss rather than disappearing.

Implementation Details

• The resolveBattle() function now returns a hits property indicating how many times the boss is struck
• A new wound() method in the actors system handles boss HP tracking and guard state
• The defeat() call is deferred until HP reaches 0, allowing multi-hit encounters
• Tests updated to verify boss damage floors, multi-hit mechanics, and damage scaling

https://claude.ai/code/session_01HmZbXRXiPKCrDCJSgfXwsL

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
dungeon-roller	Ready	Preview	Oct 7, 2026 7:39pm UTC