Essential tools and automations for Daggerheart in Foundry VTT.

This module streamlines the flow of gameplay by putting the most common Daggerheart mechanics — Downtime, Falling Damage, Roll Requests, Loot, Scar Checks, and more — one click away, integrated directly into the Daggerheart system interface.

• Downtime UI: A full-screen manager for downtime moves. Players pick their moves (Tend to Wounds, Prepare, Work a Trade, and more, including any homebrew moves the GM adds), the same move can be chosen more than once when the rules allow it, and the GM resolves everything — resource costs, Fear gained, and rest results — with one click. Automatically handles class/subclass features that hook into downtime, such as Efficient, Forager, Recovery, Armorer, Celestial Trance, Premium Bedroll, Eloquent, and Soothing Speech.
• Quick Earn Fear: A lightweight "Short Rest / Long Rest" dialog for GMs who just want to roll Fear without opening the full Downtime UI.

• 🪂 Falling & Collision Damage: Instant damage roller for environmental hazards. Supports "Very Close", "Close", "Far/Very Far", and "Collision" tiers, with dice formulas the GM can fully customize.
• 🎲 Request Roll: Quickly ask one or more players to make a roll. Configure Difficulty, Trait, Advantage/Disadvantage, and a context label; optionally send it as a "cinematic" full-screen prompt.
• 🆙 Level Up: Walk a player character through leveling up directly from the menu.
• 🎁 Loot & Consumables: Roll loot, consumables, or coins (by tier) and hand out the results — automatically added to the receiving player's character sheet when possible.
• ✨ Spend Hope: A quick picker for spending 1–6 Hope from the selected token's actor.
• 📐 Templates: Place attack templates (cone, line, circle, rectangle, and more) on the scene using Daggerheart's @Template[...] chat code syntax.

• 🔍 Scan: Reveal a target's physical and mental state through immersive, non-numeric descriptions instead of exact HP/Stress values (GM must enable this in settings). Great for "I look at the goblin, how does it look?" moments.
• 🤝 Help an Ally: Spends 1 Hope from the selected token (if available) and rolls the Help Die (1d6) to the chat.
• ❤️ Scar Check: Rolls 1d12 against the actor's Level to determine whether they stay Safe or take a Scar.
• 🔦 Spotlight Token: Instantly hands the active combat turn to the selected token (requires an active combat).
• 🖱️ Token Hover Tooltip: Hovering over a token shows a quick stat summary (HP, Stress, and more). Can be toggled on/off and resized per user in the settings.

Available through QuickActions.Features(), meant to be wired up to specific subclass items/macros:

• Unleash Chaos: Recharges the "Unleash Chaos" item's charge to its maximum (based on the actor's spellcasting trait). Asks what the player wants to pay — 1 Stress (default), 1 HP, or nothing (for the free recharge at the start of a session) — and posts a chat summary of the result.
• Chain Lightning: Opens a configuration window (Difficulty, damage formula, options) and then rolls saves and chained damage against nearby hostile adversaries, posting a full results card to chat.

• Sidebar Menu: Adds a "Quick Actions" section — a compact 2×2 button grid — to the Daggerheart System Menu ("GM Tools") in the sidebar, with one-click access to Downtime, Fall Damage, Request Roll, and Level Up.
• GM Tools Menu Upgrade: With several modules installed, the shared "GM Tools" sidebar menu can grow into a long, hard-to-scan list of sections. This module adds a search/filter bar, collapsible sections (state remembered per user), and deterministic ordering (the system's own "Refresh Features" always first, everything else alphabetical) to the entire menu — including sections contributed by other modules, not just this one's.
• Party Sheet: Replaces the built-in Short Rest and Long Rest buttons with a single Downtime button (GM only) that opens the full Downtime UI directly from the party sheet.
• Character Sheet: Adds a Quick Actions button to the header of every character sheet, next to the controls (three dots) button. It opens a palette with the macros the GM picked in the settings — the same window QuickActions.ShowMacros() produces, one click away for every player. The GM can turn the button off entirely.
• Macro Palette: Build your own palette of buttons for any macro using QuickActions.ShowMacros().

• Light Sources: If the Light Sources module is installed and active, every light-bearing item in this module's Items compendium — Candle, Torch, Alistair's Torch, Hooded Lantern, Bullseye Lantern, Storm Lantern, Oil Lamp, Candelabra, Miner's Helmet, Tactical Flashlight, Smartphone, Matches, Glowstick, and Emergency Flare — is registered with it automatically. Equip one from the Token HUD and it lights up, no manual configuration needed.

Most features work out of the box, but a few can be tuned from Configure Settings → Module Settings → Daggerheart: Quick Actions:

• Quick Actions Macros (GM): choose which macros the Quick Actions button on character sheets lists. Drag macros in from the Macro directory or from any compendium, remove the ones you don't want, and use Preview to see the resulting palette. Reset to Default restores the four macros the module ships with, and Clear All empties the list. The button at the bottom turns the whole feature off — open character sheets lose the button immediately, for every user.
• Token Hover Tooltip: enable/disable and choose its size (Small to Massive).
• Biography Tab Visibility (GM): decide how the Biography tab behaves on character sheets — Each user decides (default), Always visible for everyone, or Always hidden for everyone.
• Hide Biography Tab (per user): hides the Biography tab on character sheets for you only (off by default). Honored only while the GM leaves the world setting on Each user decides.
• Scan Configuration: enable the Scan macro for players and customize the labels/descriptions it shows.
• Falling Damage Formulas: customize the dice formula for each fall height tier, with a one-click reset to the official defaults.
• Coin Tier Configuration: customize the min/max coin range rolled for each Loot coin tier.
• Cinematic Request Roll: toggle whether Request Roll uses the full-screen cinematic prompt.

Go to the Daggerheart Menu in the sidebar (a.k.a. "GM Tools"). You will see a Quick Actions section with buttons for:

• Downtime
• Fall Damage
• Request Roll
• Level Up

The whole menu also gets a search bar plus collapsible, alphabetically ordered sections — handy once several modules are contributing to it. Click a section's title to collapse/expand it (remembered per user), or use the search box to jump straight to what you need.

GMs will find a Downtime button on the party sheet's action bar, in place of the default Short Rest / Long Rest buttons. It opens the full Downtime UI for the whole party.

Every character sheet has a Quick Actions button in its header. Clicking it opens a palette with the macros configured in Configure Settings → Daggerheart: Quick Actions → Quick Actions Macros, ready to run. The list starts with the module's own macros; the GM can drag in any world or compendium macro, or switch the button off.

Macros: https://github.com/brunocalado/daggerheart-quickactions#via-api--macros