| Latest version | 0.3.0 |
|---|---|
| Minimum Core | 14 |
| Compatible Core | 14 |
| Last updated | 1 week ago |
| Created | 8 months ago |
| Authors | |
| Languages |
|
| Systems |
Daggerheart |
| Project source | Project URL |
Mystery Box lets the GM hand out loot as a box instead of a list. The player clicks the box on their character sheet and opens it, the module rolls for what is inside, a confetti burst, sound or video plays, and the items they won go straight into their inventory.
The GM decides what each box holds, the chance of each item, and whether the box can come out empty or always gives a set number of items.
Players like the wait before the result, and the GM no longer has to move items into each sheet by hand. Boxes can be exported and shared between worlds.
MysteryBox.Manager() macro. Create a box and give it a name, a rarity, an opening style and a mode.The Manager is the GM's control panel. There you create boxes, name them, set their rarity, choose the opening style (Confetti, Video, Sound Only or None) and the mode (Percentage or Raffle). Once configured, the box is ready to be filled with items.
When you create a box, you choose how it decides what the player receives.
Each item in the box has its own chance of being given to the player.
When the player opens the box, the module rolls 1d100 for each item separately:
So the player can receive several items at once, just one, or nothing, depending on the rolls.
For example, a box contains three items:
- Rare Sword, 10% chance
- Healing Potion, 80% chance
- Magic Scroll, 50% chance
Each one is rolled on its own. The player could walk away with all three, only the Potion, or nothing at all.
Items set to 100% are always given, with no roll.
The box draws a fixed number of items from the pool, like a raffle. The player always receives exactly that number of items, or a number within the range the GM set.
Instead of each item rolling against its own chance, all items compete in one weighted draw:
A visible 1d100 is rolled first, and its result seeds the random number generator. Then the weighted draw happens.
For example, a box has 5 items, each with a different weight, and is set to draw 2 items. The player always gets exactly 2, but which 2 depends on the weights and the draw.
Use this mode when you want a fixed number of rewards but still want chance to decide which ones.
In Raffle mode the box lists each item with its weight instead of a percentage, and the GM sets how many items each opening gives.
| Percentage | Raffle | |
|---|---|---|
| Items received | 0 to all | Fixed count (N) |
| Each item rolled? | Yes, independently | No, all compete together |
| Can get nothing? | Yes | No (unless pool is empty) |
| Best for | Loot drops with variable results | Prize boxes with guaranteed rewards |
Each box has an opening style, which decides how the reveal looks to the player.
A burst of confetti fills the screen while the rarity sound plays.
Plays the video you chose for the box's rarity in Default Assets, then shows the items. The module does not include any videos. If no video is set for that rarity, nothing plays, not even the sound.
Plays the rarity sound with no animation, so the reveal does not interrupt play.
No animation and no sound. The items are shown right away.
Video suits a big reward, Confetti an everyday box, Sound Only a moment where you want the sound without anything on screen, and None a fast reveal.
Under Game Settings, Party Actor lets you pick a shared actor for the group. Once it is set, the Open window shows a Send loot to party switch. With it on, the items go to the party actor instead of the player's character, the chat message is public, and the opening effect plays for every player.
All players must be Owner of that actor, or they cannot add items to it.
The module comes with a compendium of ready-to-use Mystery Boxes in several rarities and themes. You can drag one straight onto a character sheet, or use it as a starting point for your own boxes.
You can also share the boxes you create with other worlds. When you import a Mystery Box item into a world, the module sets up the box's settings for you.
MysteryBox.Open();
MysteryBox.Manager();
| 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. |
| 📝 Nice Sheets | An alternative character sheet with a resource sidebar, ranked trait plaques, and the character's art filling the background. |
| ⚡ 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. |
| 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. |
To install this package, open your Foundry Setup screen and navigate to your Module tab and click the Install Module button.
From there, you can either search for the package unique name: dh-mystery-box or copy its manifest URL:
And paste it to the input box at the bottom of your window.

You can install this package directly to your Forge account.