Turn loot into an event!

Add a thrill of surprise to your Daggerheart sessions. The Mystery Box module lets GMs create item boxes — treasure chests, magical caches, lucky bags — that players open to reveal random rewards. Items land directly in the character's inventory, no manual work needed.

• Suspense & Fun: Players love the anticipation of rolling for loot.
• Two reward modes: Use Percentage for variable loot drops (players might get one item, several, or none) or Raffle for guaranteed rewards (always N items, weighted by rarity).
• Four reveal styles: Pick Confetti, Video, Sound Only, or Silent — match the drama to the moment.
• Fully Customizable: Set what's in the box, the odds, and the rarity. Export and share boxes across worlds.

1. 📦 Create a Box: Open the Mystery Box Manager and define a new box — name, rarity, reveal style, and mode.
2. ✨ Fill it up: Drag and drop items. In Percentage Mode, set each item's individual drop chance. In Raffle Mode, set weights and how many items the player is guaranteed to receive.
3. 🎁 Give it to a Player: Drag the box to a player's character sheet — or pull one from the premade compendium.
4. 🎉 Open & Enjoy: The player clicks to open, the reveal plays, and the loot drops automatically.

MysteryBox.Open();

MysteryBox.Manager();

API

When creating a Mystery Box, you choose how it decides what the player receives. There are two modes:

Each item in the box has its own independent chance of being given to the player.

When the player opens the box, the module rolls a 1–100 dice for each item separately:

• If the roll is equal to or lower than the item's chance, the player receives that item.
• If not, that item is skipped.

This means the player can receive multiple items at once, just one, or even nothing — depending on how lucky the rolls are.

Example: A box contains three items:

• 🗡️ Rare Sword → 10% chance
• 🧪 Healing Potion → 80% chance
• 📜 Magic Scroll → 50% chance

Each one is rolled independently. The player could walk away with all three, only the Potion, or nothing at all.

Items set to 100% are always given — no dice roll needed.

The box draws a fixed number of items from the pool — like a raffle ticket. The player is guaranteed to receive exactly N items (or whatever range the GM configured).

Instead of each item fighting its own odds, all items compete against each other in a weighted draw:

• Items with higher weights are more likely to be picked.
• Items with lower weights are rarer picks.
• The same item cannot be drawn twice in a single opening.

A visible 1d100 dice is rolled first (its result seeds the random number generator), then the weighted draw happens behind the scenes.

Example: A box has 5 items, all with different weights, and is set to draw 2 items. The player will always get exactly 2, but which 2 depends on the weighted randomness.

Use this mode when you want to guarantee a fixed number of rewards but still want randomness in which rewards are given.

When creating a Mystery Box, you can choose how the reveal is presented to the player.

A burst of colorful confetti fills the screen. Lightweight and festive — works for any occasion.

Plays a short animated video tied to the box's rarity before revealing the contents. The higher the rarity, the more dramatic the intro.

Plays the rarity sound effect without any visual animation. Good for a subtle reveal that doesn't interrupt the flow of play.

No animation or sound. The contents are revealed immediately and silently.

Tip: Use Video for dramatic high-rarity rewards, Confetti for a fun everyday feel, Sound Only when you want atmosphere without distraction, and None for a fast no-frills experience.

• System: Daggerheart.
• Dice So Nice! (optional) — 3D dice are shown for the box's opening rolls when installed.
• Unidentified (optional) — items that Unidentified has mystified stay masked (alias name/icon) when drawn from a Mystery Box, in both the reveal popup and the opening chat message. The true item is only revealed once the player identifies it through Unidentified's own flow; GMs always see the real identity, same as elsewhere in Unidentified.

You can share your created Mystery Boxes with other worlds. When you import a Mystery Box item into a world, the module automatically configures the necessary settings for you. You can also drag items directly from a compendium onto a player's character sheet.

The Mystery Box Manager is the GM's control panel. Here you create new boxes, name them, set their rarity, choose the opening style (Confetti, Video, Sound, or None), and select the box mode (Percentage or Raffle). Once configured, the box is ready to be filled with items.

In Raffle Mode, items are listed with their relative weights instead of individual percentages. Items with higher weights are more likely to be drawn. The GM defines how many items the player is guaranteed to receive per opening — useful for prize boxes and structured rewards.

The Player View shows what happens when a character opens a Mystery Box. The reveal animation plays (confetti burst or rarity video), followed by the list of items won. All rewards are automatically transferred to the character's inventory — no manual work required.

The module ships with a collection of ready-to-use Mystery Boxes. These premade boxes cover a range of rarities and themes, so you can drop them straight into your session without any setup. They can also be used as templates for your own custom boxes.