Daggerheart: Resource Macros
A Foundry VTT module designed for the Daggerheart system. It automatically triggers macros whenever the global Fear resource or a player character's Hope, Stress, HP, or equipped Armor resource changes.
This allows Game Masters to automate events, send chat messages, or trigger visual effects exactly when Fear goes up, Hope runs out, or any other threshold is crossed.
A simple example of a chat message displayed when Fear changes:
✨ Features
- Fear Triggers: Detects changes in the global Daggerheart Fear resource.
- Hope Triggers: Detects changes in Hope for every player-owned character.
- Stress Triggers: Detects changes in Stress for every player-owned character.
- HP Triggers: Detects changes in HP for every player-owned character.
- Armor Triggers: Detects changes in the equipped Armor's marks for every player-owned character.
- Dynamic Limits: Automatically respects the maximum Fear value configured in the system settings (no longer fixed at 12).
- Configurable Macros: Assign different macros for each trigger event (see below).
Resource.Message()API: A simple function you can call inside any macro to send a styled Daggerheart chat card, with optional text, background image, and sound.
🚀 Getting Started
This module includes a Compendium Pack named Resource Macros containing basic examples.
- Import the macros from the Resource Macros compendium into your world (or leave them in the compendium — macros don't need to be in your world to be assigned).
- Open Module Settings and click Configure Fear/Hope/Stress/HP/Armor Macros.
- Click Get Default Macros in each dialog to auto-assign the bundled examples to every slot in one click, or drag your own macros into individual slots instead.
⚙️ Configuration
Go to the Module Settings tab in Foundry VTT to configure the behavior. Every configuration dialog below has a Get Default Macros button that assigns the bundled compendium examples to all four slots at once — drag-and-drop is only needed for custom macros.
Fear Triggers
| Trigger | Description |
|---|---|
| Macro: Increase Fear | Runs when Fear goes UP (but has not yet reached the maximum). |
| Macro: Decrease Fear | Runs when Fear goes DOWN (but has not yet reached 0). |
| Macro: Fear Max | Runs when Fear reaches the maximum value defined in system settings. |
| Macro: Fear Min | Runs when Fear reaches exactly 0. |
Hope Triggers
| Trigger | Description |
|---|---|
| Macro: Increase Hope | Runs when a player character's Hope goes UP (but has not yet reached the maximum). |
| Macro: Decrease Hope | Runs when a player character's Hope goes DOWN (but has not yet reached 0). |
| Macro: Hope Max | Runs when Hope reaches the character's maximum value. |
| Macro: Hope Zero | Runs when Hope reaches exactly 0. |
Stress Triggers
| Trigger | Description |
|---|---|
| Macro: Increase Stress | Runs when a player character's Stress goes UP (but has not yet reached the maximum). |
| Macro: Decrease Stress | Runs when a player character's Stress goes DOWN (but has not yet reached 0). |
| Macro: Stress Max | Runs when Stress reaches the character's maximum value. |
| Macro: Stress Zero | Runs when Stress reaches exactly 0. |
HP Triggers
| Trigger | Description |
|---|---|
| Macro: Increase HP | Runs when a player character's HP goes UP (but has not yet reached the maximum). |
| Macro: Decrease HP | Runs when a player character's HP goes DOWN (but has not yet reached 0). |
| Macro: HP Max | Runs when HP reaches the character's maximum value. |
| Macro: HP Zero | Runs when HP reaches exactly 0 (the death move trigger point). |
Armor Triggers
Armor marks live on the character's equipped Armor item, not on the actor directly — these triggers watch that item.
| Trigger | Description |
|---|---|
| Macro: Increase Armor | Runs when a player character's equipped Armor is marked (but not all slots are marked). |
| Macro: Decrease Armor | Runs when marks are cleared from the equipped Armor (but not down to 0). |
| Macro: Armor Max | Runs when every Armor slot is marked. |
| Macro: Armor Zero | Runs when the equipped Armor has no marks left. |
Note: All triggers execute only on the GM's client to prevent duplicate effects. Hope, Stress, HP, and Armor macros receive the
actorvariable in scope, so you can reference the character who triggered the change inside the macro script. Every trigger (Fear included) also receivesnewValue,previousValue,delta, andmaxin scope, so the macro can report the real amount changed — see docs/WIKI.md for details.
💬 Resource.Message() — Chat Card API
The module exposes a function called Resource.Message() that you can use inside any macro to send a styled Daggerheart chat card to all players.
Full documentation is available at docs/WIKI.md.
Header only — a minimal announcement:
Resource.Message({ header: "-1 Fear" });
🧰 My Daggerheart Modules
| Module | Description |
|---|---|
| 💀 Adversary Manager | Scale adversaries instantly and build balanced encounters. |
| 🖼️ Art Mapper | Automatically assigns artwork to system compendiums, actors, tokens, and custom module content — keeping your visuals organized and up to date. |
| 🐉 Colossus | Manage massive multi-part boss encounters with independent HP per part and a single shared stress pool. |
| 📦 Containers | Group inventory items into collapsible containers — pouches, chests, backpacks — to declutter character sheets. |
| 💥 Critical | Animated criticals. |
| 💠 Custom Stat Tracker | Add custom trackers to actors. |
| ☠️ Death Moves | Enhances the Death Move moment with a dramatic interface and full automation. |
| 📏 Distances | Visualizes combat ranges with customizable rings and hover calculations. |
| 📦 Extra Content | Homebrew content pack. |
| 😱 Fear Tracker | Adds an animated slider bar with configurable fear tokens to the UI. |
| 🧟 Horde | Explode single horde tokens into dozens of individual tokens and manage their movement and stats automatically. |
| 🎁 Mystery Box | Introduces mystery box mechanics for random loot and surprises. |
| ⚡ Quick Actions | Quick access to common mechanics like Falling Damage, Downtime, etc. |
| 📜 Quick Rules | Fast and accessible reference guide for the core rules. |
| 🤖 Resource Macros | Automatically executes macros when the Fear, Hope, Stress, HP, or Armor resources change. |
| 🎲 Stats | Tracks dice rolls from GM and Players. |
| 🧠 Stats Toolbox | Import actors using a statblock. |
| 🛒 Store | A dynamic, interactive, and fully configurable in-game store. |
| 🔍 Unidentified | Obfuscates item names and descriptions until they are identified by the players. |
| 🌌 Void | Unofficial module that brings The Void playtesting content — experimental classes, subclasses, ancestries, communities, adversaries, loot, weapons, and more. |
🗺️ Adventures
| Adventure | Description |
|---|---|
| ✨ I Wish | A wealthy merchant is cursed; one final expedition may be the only hope. |
| 💣 Suicide Squad | Criminals forced to serve a ruthless master in a land on the brink of war. |