Skip to main content
Loot chests are special reward chests that randomly appear as you mine. Each chest shows a hologram overhead, plays a custom animation, and offers one of five bonus mini-games when claimed — turning an ordinary mining session into a moment of excitement every time one surfaces in the rock.

​
How Chests Spawn

Chests appear in the mine randomly based on configurable drop chances. When a chest spawns:
  1. A hologram appears floating above it to draw your attention
  2. A spawn animation plays (defined in animations.yml)
  3. A custom sound cues to alert nearby players (defined in sounds.yml)
The global spawn rate and per-chest-type weights are all tunable in loot-chests.yml.
Chest spawning is per-mine and per-block-break, so higher-tier mines with faster mining speeds will naturally surface chests more often in absolute terms.

​
Claiming a Chest

Walk up to a spawned chest and right-click it to claim it. A claim summary appears showing:
  • The base rewards you earned from the chest’s reward table
  • The bonus mini-game you can play for additional prizes
You must claim a chest before it despawns — unclaimed chests disappear after the configured timeout.

​
Bonus Mini-Games

Every chest claim triggers one of five bonus mini-games, each offering prizes beyond the base chest contents. The active mini-games and their reward tables are defined in minigames.yml.
A configured activity that challenges you to complete a quick in-game task. Success awards a bonus prize on top of your base chest loot. Difficulty and rewards are set in minigames.yml.
A different style of bonus challenge with its own mechanics and prize pool. Fully customizable in minigames.yml — swap the reward table without touching anything else.
A luck-based mini-game where the outcome is determined by a configurable random roll. Higher-tier chests can be configured to offer better odds in this game.
A reaction-based mini-game that rewards quick players with extra prizes. The timing window and bonus multiplier are both configurable in minigames.yml.
A choice-based mini-game that presents multiple options, each hiding a different prize. Configure the pool of options and what each one awards in minigames.yml.

​
Holograms & Animations

Each chest type supports:
  • A custom hologram — floating text displayed above the chest, configurable per chest type
  • A spawn animation — plays when the chest first appears in the world
  • An open animation — plays when a player claims the chest
All animations are defined in animations.yml and referenced by name from loot-chests.yml.

​
Chest Types

Configure multiple distinct chest types in loot-chests.yml. Each type is fully independent with its own:

​
Sounds

Custom sounds for both chest spawn and chest open events are defined in sounds.yml and referenced by key from loot-chests.yml.

​
Configuration Files