Turn your Minecraft server into a configurable scavenger hunt. Players discover clue items from loot chests and mob drops, redeem them in order at exact world locations, and unlock a final sign-based solution..

https://www.youtube.com/watch?v=mgZRauLlRfc

Enigma is a Fabric mod for Minecraft 1.20.1 that lets server admins run mystery events, treasure hunts, and progression-based clue chains without custom maps or command spaghetti.

• Configurable clue hunt with ordered progression
• Clues can appear in specific loot tables and mob drops
• Each clue points to exact coordinates and reveals the next message only at the right block
• Duplicate clue pickups are blocked per player
• Final completion can trigger any server command
• Admin commands make it easy to start, stop, reset, reload, test, and distribute clues

1. Start the hunt.
2. Players explore the world, raid configured structures, and defeat configured mobs.
3. Enigma injects clue items into the configured reward sources.
4. A clue item shows coordinates and must be used on the exact target block.
5. When redeemed, the player receives the next hint in the chain.
6. After all clues are redeemed, the player writes the secret phrase on a sign.
7. Enigma runs the configured reward command and finishes the puzzle.

Enigma is built for live events. It works well for:

• seasonal treasure hunts
• SMP mystery arcs
• community puzzle nights
• admin-run competitions
• lore delivery through exploration instead of chat spam

Available commands:

• /enigma start
• /enigma stop
• /enigma reload
• /enigma give er>
• /enigma resetAll
• /enigma setChest z>

The included command set covers both production use and quick testing. You can start an event, hand out the full clue chain to a player, reset progress, or generate a demo chest with a guaranteed clue.

Enigma reads its settings from config/enigma/config.json.

You can configure:

• whether the hunt is active
• the final secret phrase
• the reward command
• what happens to the finishing sign
• clue item material, name, and lore
• loot table sources and drop chances
• mob drop sources and drop chances
• the full clue list with coordinates and messages

Enigma tracks which clues each player has:

• received
• redeemed

That means players cannot farm the same clue over and over, and they cannot skip ahead in the sequence. The hunt stays structured even on active multiplayer servers.

Fabric API is required.

Out of the box, Enigma feels like a secret tucked inside your world:

• mysterious clue items
• coordinate-based discovery
• exact-location redemption
• a final phrase hidden behind full completion

It is lightweight, focused, and built around one thing: making exploration feel deliberate.

I wanted to make a tool to help inexperienced server owners organize scavenger hunts easily. Also, I made this for the Hackcraft Hack Club YSWS!