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. If the GM has assigned an image to that roll's case (see Cinematic Roll Images below), it's sent as a "cinematic" full-screen prompt instead of a plain chat message.

• 💬 Whisper: Send a private message to any number of connected users, via QuickActions.Whisper(). Pick the recipients from the list (GMs are flagged with a crown), type the message, and hit send — it arrives as a whispered chat card visible only to them. The text is plain: anything you type is delivered literally, so pasted HTML shows up as text instead of being rendered. Ctrl+Enter sends without leaving the keyboard.

  

• 🤝 Barter: Trade items and coins, via QuickActions.Barter(). You need a linked character actor. Your inventory shows as an icon grid split into Weapons / Armor / Consumables / Loot tabs — click an icon to put it on the table (selected items get a green border; stacks get a small quantity stepper), and offer coins alongside them in whichever currencies the world has enabled. The "Trade With" list then lets you pick either:

  • Another player (they also need a linked character actor). Hit Start Trade and the same window opens on their screen with your offer already laid out. They can add items and coins of their own or accept as-is; once they confirm, you approve and the swap happens. Any edit after a confirmation cancels it, so nobody can lock in an offer and then quietly change it. A GM must be connected: the actual transfer is written by the GM client in a single batch, so it either goes through completely or not at all.
  • A party stash — any party sheet that lists your character as a member and that you hold Owner permission on. There is no invite and no approval step here: the right-hand column becomes the party's own inventory, so you give from the left and take from the right in the same window, then hit Complete Transfer. Your own client writes it, so no GM needs to be online. If a party you expect is missing from the list, check its ownership — without Owner permission on the party actor the option is hidden, since the transfer could not be written.

  Either way the result is posted to chat as a receipt.

  

• 🆙 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. Adversaries get their own version, listing damage thresholds and every Action, Reaction and Passive they have.
• 💛 Token Hope Bar: A row of Hope diamonds sits just above every character token — filled for the Hope currently held, empty for the rest. It follows each token's own Display Bars setting, so it appears and disappears alongside the native Hit Points and Stress bars. Scars are shown instead of hidden: rather than shortening the row, the slots a Scar locked off are faded out, and healing the Scar brings them back. Can be switched off 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 macros the module ships with (Fate Roll – Hope, Fate Roll – Fear, Help an Ally, Roll Loot/Consumable, Whisper, and Barter), 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).
• Token Hope Bar (GM): draw the Hope diamonds above character tokens (on by default). Turn it off if another module already renders Hope on your tokens — Bar Brawl and similar. Applies immediately, on every client.
• Interface Settings (GM): one window collecting the world-wide interface changes this module makes. It holds:
  • Daggerheart Menu Enhancements: a single switch that turns off all of this module's changes to the system's sidebar menu — the purple skull tab icon, the search bar, the alphabetical ordering, the collapsible sections, and the two-column button grid. The module's own Quick Actions section stays in the menu either way; only its layout falls back to the system default. Takes effect immediately, on every client.
  • Biography Tab Visibility: 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. Stays in the settings list rather than in the GM-only Interface Settings window, so every player can reach it.
• 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 Roll Images: assign an image to each Request Roll case (the six traits, Hope, Fear, and the generic Duality Roll fallback). A case only uses the full-screen cinematic prompt when it has an image configured here — cases left empty fall back to a plain chat message, and the feature does nothing at all until at least one image is set.

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.

You can trigger any function programmatically or via Foundry Macros using the global QuickActions object:

// Opens the full Downtime UI
QuickActions.DowntimeUI();

// Opens the lightweight "Earn Fear" (Short/Long Rest) dialog
QuickActions.Downtime();

// Opens the Falling Damage calculator
QuickActions.FallingDamage();

// Opens the Roll Request dialog. The cinematic full-screen prompt activates automatically per
// request, based on the images configured in Configure Settings → Cinematic Roll Images.
QuickActions.RequestRoll();

// Opens the Whisper window — pick connected users and send them a plain-text private message.
QuickActions.Whisper();

// Opens the Barter window — trade items and coins with another connected
// player, or with a party stash your character belongs to.
QuickActions.Barter();

// Opens the Loot & Consumables roller
QuickActions.LootConsumable();

// Performs "Help an Ally" on the selected token
QuickActions.HelpAnAlly();

// Performs a "Scar Check" on the selected token
QuickActions.ScarCheck();

// Sets the combat turn to the selected token
QuickActions.SpotlightToken();

// Choose a number of Hope to spend on the selected token
QuickActions.SpendHope();

// Adds a template to the scene
QuickActions.Templates();

// Opens a level-up flow for a player character
QuickActions.LevelUp();

// Rolls a Hope/Fear Duality die with a cinematic animation
// rollType: "hope" or "fear" | mode: "default" (animated), "ask" (choose the die), "system" (use the system's own roll)
QuickActions.Fate("hope");

// Runs one of the built-in class feature macros (e.g. subclass abilities)
// See "Class Feature Macros" above for the available names.
QuickActions.Features("Unleash Chaos");
QuickActions.Features("Chain Lightning");

// Opens a dialog with buttons for specific macros by name
// To use the macro name it requires the macros to exist in the 'daggerheart-quickactions.macros' compendium. You can use the UUID to add any macro from world or any compendium.
// 
QuickActions.ShowMacros("Macro Name 1", "Macro Name 2", "Macro.CDcmq4UiZMqs6pbs", "Compendium.daggerheart-quickactions.macros.Macro.5SyMBdCHM5TZXqGz");

// Opens the same palette as the "Quick Actions" button on character sheets,
// listing the macros the GM curated in Configure Settings → Quick Actions Macros.
QuickActions.QuickActionsMenu();

/* WARNING: This will only work if you enable the module setting.
This allows the player to obtain information about a targeted adversary token. 
They will be informed about the HP and Stress status without revealing numerical values. 
During the game, it is common for players to ask: "I look at the goblin, how does it look?" 
The GM usually responds: "He looks quite wounded and exhausted." 
This macro aims to give players the autonomy to do this themselves. 
Example output: 
Physical State: Injured 
Mental State: Completely overwhelmed, paralyzed by panic and unable to think clearly 
*/

QuickActions.Scan();