✦ MysteryBox ✧

Risk something valuable—or take the safe reward. The choice is yours.

MysteryBox is a lightweight risk-and-reward mod that adds a mysterious interactive block with guaranteed payouts, randomized reward bundles, animated visuals, custom sounds, advancements, and a carefully hidden secret.

How It Works

Approach a MysteryBox while carrying an accepted payment item. The reward interface presents two choices:

• Guaranteed Payout: Receive the displayed reward with no risk.
• Mystery Gift: Gamble your payment for a randomized bundle containing 1–4 rewards.

Higher-tier payments provide significantly better chances of receiving valuable or mythic rewards. Lower-tier payments are cheaper but carry a greater chance of common loot.

Rewards remain balanced around legitimate Minecraft gameplay. Enchanted equipment uses valid vanilla enchantment levels—nothing intentionally impossible or game-breaking.

Features

• Guaranteed payouts or randomized Mystery Gifts
• Mystery Gift bundles containing 1–4 items
• Tiered luck based on the value of your payment
• A large collection of common, valuable, and mythic rewards
• Legitimately max-enchanted vanilla armor, weapons, and books
• Animated black, violet, and pink floating title
• Violet proximity outline and custom Boss Bar
• Custom placement, breaking, and interaction sounds
• Subtle enchanting and obsidian-tear particles
• Directional placement—the amethyst padlock faces the player
• Easy and balanced crafting recipe
• Fully breakable, collectible, and reusable
• Built-in guide book explaining payments and rewards
• First-craft advancement: A MysteryBox?!
• Replacement guide command: /mysterybox book
• A hidden secret for particularly curious players
• Designed for both singleplayer and multiplayer

Accepted Payments

MysteryBox accepts a wide range of vanilla resources:

• Echo Shards
• Netherite Ingots
• Amethyst Shards
• Prismarine Shards
• Emeralds
• Diamonds
• Gold Ingots
• Iron Ingots
• Copper Ingots
• Glowstone Dust
• Quartz
• Lapis Lazuli
• Redstone Dust
• Coal
• Charcoal
• Clay
• Flint
• Resin Clumps

When multiple accepted resources are present, the payment item currently held in your hand receives priority.

Proximity Effects

When you move within 6 blocks of a placed MysteryBox:

• Its violet glowing outline becomes visible.
• A custom MysteryBox Boss Bar appears.
• Its animated floating title and atmospheric particles create a distinctive magical presence.

These effects are distance-limited to keep the mod smooth and lightweight.

Guide Book

Crafting your first MysteryBox unlocks the yellow A MysteryBox?! advancement, launches celebratory fireworks, and awards a written guide book.

The guide explains:

• Every payment tier
• All guaranteed payouts
• Alternative and bonus rewards
• How Mystery Gift odds work
• How higher-tier payments improve your luck
• How to replace a lost guide

The guide is awarded only once. Crafting additional MysteryBoxes will not fill your inventory with duplicate books.

If your guide is lost, obtain another copy with:

/mysterybox book

Rumors suggest that MysteryBox may contain more than its reward interface reveals—but discovering its secret is up to you.

Crafting Recipe

The recipe requires:

• 4 Copper Ingots
• 2 Emeralds
• 2 Diamonds
• 1 Gold Ingot

Requirements

Fabric

• Minecraft 26.2
• Fabric Loader
• Fabric API
• Install on both the client and server

Quilt

• Minecraft 26.2
• Quilt Loader
• Fabric API
• Uses the Fabric and Quilt version
• Install on both the client and server

NeoForge

• Minecraft 26.2
• NeoForge
• No additional API required
• Install on both the client and server

Forge

• Minecraft 26.2
• Forge
• No additional API required
• Install on both the client and server

Singleplayer is fully supported because Minecraft runs an integrated server internally.