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.

1. Open the Mystery Box Manager with Manage Mystery Boxes in the Daggerheart Menu, or with the MysteryBox.Manager() macro. Create a box and give it a name, a rarity, an opening style and a mode.
2. Drag items into the box. In Percentage mode you set each item's own drop chance. In Raffle mode you set a weight for each item and how many items the player receives.
3. Drag the box onto a player's character sheet, or take one from the premade compendium.
4. The player clicks the box on their sheet and then Open. The reveal plays, the items go into their inventory, and a message is posted in the chat.

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:

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

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:

• 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 one opening.

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.

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.

• Chat Message Visibility decides who sees the message when a box is opened: everyone, or only the GM as a whisper (the default).
• Default Assets has four tabs: the icon for each rarity, the opening video for each rarity, the sound for each rarity plus the sound for an empty box, and the opening style and mode that new boxes start with.
• Debug Logs prints each roll to the console: the item, its chance and the result.

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();

API

• System: Daggerheart.
• Dice So Nice! (optional): shows 3D dice for the box's opening rolls.
• Unidentified (optional): items that Unidentified has masked keep their masked name and icon when they come out of a Mystery Box, in the reveal window and in the chat message. The player only sees the real item after identifying it through Unidentified. GMs always see the real item, as everywhere else in Unidentified.
• Nice Sheets (optional): on a character using that sheet, each box gets a ring and a tag in its rarity color, and the Open and reveal windows switch to the sheet's gold-on-dark style.