Unboxing the Mystery

Turn reveals into puzzles players can touch.

Unboxing the Mystery adds interactive reveal overlays to Foundry VTT journals, items, tiles, doors, and loot interactions. Instead of handing over a page or item immediately, the GM can ask players to crack a seal, brush away dust, pick a lock, trace a magic circle, match runes, solve a circuit maze, or open a gacha pool before the reward appears.

The module supports private and shared reveals, live spectator windows, tile containers, locked doors, roll checks, key items, reusable presets, gacha pools, and currency rewards through GlitchSmith Library.

Key Features

Interactive Puzzle and Reveal Modes

• Nine puzzle modes: Wax Seal, Dust Off, Password Lock, Lockpick, Smash, Glyph, Combination Lock, Rune Matching, and Circuit Maze.

• Wax, dust, password, lockpick, and smash reveals: Use classic tactile overlays for sealed letters, hidden notes, locked boxes, sci-fi terminals, crates, cursed objects, and mystery items.

• Glyph mode: Build magic-circle tracing puzzles with node placement, freehand drawing, shape tools, straight or curved segments, multiple phases, custom colors, and custom background images.

• Combination Lock: Set a numeric safe code and let players drag rotating dials until the lock opens.

• Rune Matching: Create memory-card puzzles with 4-12 rune pairs, optional preview time, max attempts, custom symbols, custom card images, and match/mismatch sounds.

• Circuit Maze: Players navigate a generated circuit-board maze with WASD controls, time limits, security levels, keys, locks, blinking hazards, slowdown paths, and speed boosts.

• Mode customization: Set instruction text, cover images, progress sounds, finish sounds, fail sounds, reveal chat messages, difficulty, content style, and reveal permissions per page, item, tile, door, or Item Piles token.

Journals, Items, Tiles, and Doors

• Journal page reveals: Lock individual journal pages behind puzzles, reveal them to selected users, re-lock them later, or automatically grant Limited, Observer, or Owner permission after completion.

• Mystery item reveals: Add an unboxing overlay to item sheets, show item descriptions and meta chips, and optionally add the revealed item to the player's inventory.

• Tile containers: Turn scene tiles into locked containers with closed/opened images, open and close sounds, linked items, linked journals, currency rewards, partial currency taking, sequential reveals, grid view, Claim All, and live remaining counts.

• Door puzzles: Attach puzzle settings to Foundry doors. Players must solve the puzzle before the door opens, and GMs can relock the door from its configuration.

• Access controls: Require a specific key item, consume the key after use, limit interaction by grid distance, hide tile highlights, hide tiles after reveal, or keep configuration GM-only.

• Per-user state: Reveal progress can be personal or shared. A secret can be opened for one player while staying locked for others.

Gacha and Loot Pools

• Gacha pool editor: Create pools with titles, descriptions, banner images, rarity tiers, drop chances, item quantities, currency rewards, featured items, and featured boost.

• Pity options: Configure hard pity, soft pity, guaranteed rarity, and 50/50 featured-item behavior.

• Pull costs and rewards: Charge sheet currencies or virtual currencies, add bonus pulls for multi-pulls, set per-tile max pulls, and grant item or currency rewards after reveal.

• Reveal flow: Gacha results can reveal instantly or use Wax Seal, Dust Off, Password, Lockpick, or Smash presentation before items are claimed.

• Cinematic Cut-ins integration: If Cinematic Cut-ins is active, gacha results can trigger rarity-specific cut-ins, use the pulled item image/name, and play for everyone or inside the reveal dialog.

• Player-facing tools: Players can view probabilities, see pull history, share results to chat when allowed, and watch other players' pulls through spectator mode.

• Import and export: Export individual gacha pools as JSON, import them into another world, and see warnings when imported item references are missing.

Checks, Presets, and Automation

• Roll Check before puzzle: Require a dice check before the puzzle starts. Success and failure can change difficulty, lockpick count, rune pair count, or allowed attempts.

• D&D 5e and Pathfinder 2e checks: Use direct ability, save, and skill roll options through native system support.

• Generic roll detection: Other systems can use chat-based dice checks, keyword matching, roll-result keyword matching, or a custom formula.

• Dice So Nice timing: When Dice So Nice is active, roll-check results can wait for the 3D dice animation before resolving.

• Reusable presets: Save any unboxing configuration as a preset, load it later, export presets as ZIP packages with referenced media, and import presets into another world.

• Copy and batch tools: Copy settings from another page or apply the current setup to every page in the same journal.

• Monk's Active Tile Triggers: Use the Trigger Puzzle action inside MATT workflows, including success and failure anchor tags for branching flows.

• Item Piles support: Require a puzzle before an Item Piles container opens, then relock the pile later from the Token HUD.

Presentation and Spectator Tools

• Five revealed-content styles: Parchment & Ink, Hacker Terminal, Vault, Rustic Wood, and Rebel, plus an unstyled option when you want the journal content to stay close to its original look.

• Live puzzle spectator windows: Other players can watch someone solve Wax Seal, Dust Off, Password, Lockpick, Smash, Glyph, Combination Lock, Rune Matching, or Circuit Maze puzzles in real time.

• Gacha spectator windows: When a player pulls from a gacha pool, connected players can watch the reveal sequence progress card by card.

• OBS and stream view support: Spectator windows render inside Foundry's interface layer so they can appear in stream captures.

• Accessibility and audio controls: Client settings include reduced flashing effects and sound effect volume control.

Technical Specifications

• Required module: GlitchSmith Library 0.6.0 or later.

• Optional module: Cinematic Cut-ins enables cinematic gacha reveal effects.

• System support: Puzzle and reveal workflows can be used across systems. D&D 5e and Pathfinder 2e receive direct roll-check support and sheet-currency handling through GlitchSmith Library; other systems can use custom currency definitions and chat-based roll detection.

• Currency support: Sheet currencies and virtual currencies are managed through GlitchSmith Library, including decimal currency support when the currency definition allows it.

• Localization: English and Korean included.

Important Note: Cinematic Cut-ins is a separate GlitchSmith module. Unboxing the Mystery can use it for gacha reveal effects when both modules are installed and enabled, but those cinematic effects are not included in this module by itself.

Credits: Music and sound effect credits can be found in the CREDITS.md file within the module.

✅ Compatibility: Foundry VTT v13 & v14. Foundry VTT v12 users should use version 1.3.1 or earlier.

💖 Support Development & Get Access: This module is available exclusively for my patrons.

Join the community to unlock these tools for your table! ➡️ https://www.patreon.com/c/glitchsmith