⚠️ This module is being folded into the core DCC RPG system

The combat automation features provided by DCC-QoL are being merged directly into the main DCC RPG system (starting with v0.70.5), where they live behind opt-in settings. Once the migration is complete, these features will be available natively without a separate module, and **this standalone module will be deprecated**.

If you are starting fresh, prefer enabling the equivalent settings in the core DCC system. Existing DCC-QoL users can continue using the module during the transition; an announcement will follow when it is fully retired.

A quality of life and automation module for the Dungeon Crawl Classics RPG system in Foundry VTT. This module aims to enhance gameplay by automating common mechanics, improving combat flow, and providing additional flexibily to DCC players and GMS. This version has been re-written from the ground up to support the 0.50+ version of the DCC RPG system, and Foundry VTT v12+.

The DCC Quality of Life module aims to improve the DCC RPG experience in Foundry VTT by:

• Streamlining combat - Let the system handle hit/miss determination, range penalties, mighty deed success/failure, damage application, and auto-apply "dead" status to NPCs who reach 0 HP
• Enforcing easily forgotten DCC rules - Automatic friendly fire checks, firing into melee penalties, and luck modifiers on incoming crits & fumbles
• Supporting house rules and experimental variants - DCC-QoL, as an optional add-on, has room to roam when it comes to support for other non-RAW/house rules options. More to come here soon!

• Hit/Miss Display: Automatically shows whether an attack hits or misses when a target is selected
• Redesigned attack roll chat cards with improved visual presentation and added information
• Two Layout Options: Choose between "Full" and "Compact" attack card formats
  • Full Format: Shows all attack details (including damage formula in Roll Damage button) with maximum visual clarity
  • Compact Format: Reduces vertical space by approximately 50% while maintaining essential information
• Color-coded roll damage, crit, and fumble buttons

• Automatic damage application to targeted tokens when damage is rolled
• Respects token permissions and ownership -- only the attacking player or GM can roll damage
• Visual confirmation of damage dealt - red animated text floating from the target shows the damage amount applied
• Automatic "Dead" Status: When an NPC's hit points reach 0 or below, the "dead" status effect is automatically applied

• Automatic distance calculation using DCC diagonal movement rules
• Melee weapons: Warning when target is beyond adjacent range
• Ranged weapons: Automatic application of range penalties
  • Medium range: -2 penalty to attack roll
  • Long range: -1 die step penalty to action die (d20→d16)
  • Out of range: Warning and confirmation dialog

• Automatic friendly fire checks when firing into melee (per DCC rules, page 96)
• 50% chance (d100 ≤ 50) of hitting an ally when attack misses in melee
• Random target selection from available friendlies
• Full attack resolution against friendly targets
• Damage application workflow for friendly fire hits

• Automatic -1 penalty when using ranged weapons against targets engaged in melee
• Smart detection of melee engagement based on token positioning and disposition (friendly/neutral/enemy)

• Monster Crits vs Player Luck: When a monster scores a critical hit against a PC, the PC's luck modifier is applied as a penalty to the monster's critical hit roll, reducing the severity of the critical
• Monster Fumbles vs Player Luck: When a monster fumbles an attack against a PC, the PC's luck modifier affects the fumble die used for the fumble table roll

1. From Foundry's Module Browser:

   • Search for "DCC Quality of Life" or "dcc-qol"
   • Click Install

2. Manual Installation:

   • Download the latest release from GitHub releases
   • Extract to your Foundry Data/modules/ directory
   • Enable in Foundry's Module Management interface

3. Enable the Module:

   • In your DCC world, go to Settings → Manage Modules
   • Check the box next to "DCC Quality of Life"
   • Save Module Settings

Access module settings through Settings → Module Settings → DCC Quality of Life.

[screenshot: showing module settings panel with all configuration options]

This module is open source and welcomes contributions:

• Bug Reports: Use GitHub Issues
• Feature Requests: Discussion on GitHub
• Code Contributions: Pull requests welcome
• Translations: Help expand language support

This module is licensed under the MIT License.

See CHANGELOG.md for detailed version history.

DCC Quality of Life is an independent module and is not affiliated with or endorsed by Goodman Games or the creators of the Dungeon Crawl Classics RPG.