Riddler Chests

Add brain-teasing riddles to loot chests in your Minecraft world! Challenge players with riddles before they can access treasure, with full per-player loot support.

🎯 Overview

Riddler Chests transforms ordinary loot chests into puzzle challenges. When players discover a chest, they may be presented with a riddle that must be solved before accessing the loot inside. Perfect for adventure maps, RPG servers, and anyone who wants to add an extra layer of challenge to treasure hunting!

✨ Key Features

🧩 Per-Player Riddles

Each player gets their own independent riddle chance when opening a chest
One player solving a riddle doesn't affect other players
Fully randomized riddle assignment per player

💎 Per-Player Loot

Every player gets their own unique loot from the same chest
Loot regenerates independently for each player
Works standalone or integrates seamlessly with Lootr mod
No more racing to get the best items first!

📝 Fully Customizable Riddles

Easy-to-edit JSON configuration file
Add unlimited custom riddles
Support for multiple correct answers per riddle
Enable/disable individual riddles
Comes with starter riddles included

⚙️ Extensive Configuration

Riddle Chance: Set probability (0-100%) that a chest will have a riddle
Master Toggle: Quickly enable/disable all riddles
Break Protection: Prevent chest breaking or delete items when broken unsolved
Break Warnings: Configurable warnings before breaking a riddle chest
Custom Warning Colors: Personalize warning message appearance
GUI Customization: Change riddle screen title

🔒 Chest Protection

Optional item deletion when breaking unsolved riddle chests
Warning system before breaking (with configurable timeout)
Shift-to-break requirement option
Protects against accidental chest destruction

🎮 How It Works

Player opens a naturally generated chest
System rolls for riddle (based on your configured chance)
- If riddle: Player must solve it to access loot
- If no riddle: Player gets loot directly
Each player gets fresh loot generated just for them
Multiple players can loot the same chest independently

📋 Configuration

Main Config (`config/riddler_chests-common.toml`)

[riddles]
    # Probability that a riddle appears (1.0 = 100%, 0.5 = 50%, etc.)
    riddleChance = 1.0
    # Master switch to enable/disable all riddles
    enableRiddles = true

[breakProtection]
    # Delete items when breaking unsolved riddle chests
    deleteItemsOnBreak = true
    # Show warning before breaking
    enableBreakWarning = true
    # Require SHIFT to break after warning
    requireShiftToBreak = true
    # Warning timeout in seconds
    warningTimeoutSeconds = 10

[display]
    # Warning message color (RED, YELLOW, GOLD, etc.)
    warningColor = "RED"
    # Title shown in riddle GUI
    riddleGuiTitle = "Solve the Riddle"

Riddles Config (`config/riddlerchests/riddles.json`)

[
  {
    "question": "I speak without a mouth and hear without ears. What am I?",
    "answers": ["echo"],
    "enabled": true,
    "description": "Classic riddle about sound"
  },
  {
    "question": "What has keys but no locks, space but no room?",
    "answers": ["keyboard", "computer keyboard"],
    "enabled": true,
    "description": "Technology riddle"
  }
]

Easy to add your own riddles! Just follow the format and add as many as you want.

🔧 Requirements

Minecraft: 1.21.1
NeoForge: 21.1.211 or higher
Lootr (Optional): Automatically integrates if present

🤝 Lootr Integration

With Lootr: Uses Lootr's per-player chest system
Without Lootr: Built-in per-player loot system activates automatically
Seamless integration - no configuration needed!

🎨 Features in Detail

Riddle System

Case-insensitive answers: "ECHO", "echo", and "Echo" all work
Multiple valid answers: Accept variations like "keyboard" or "computer keyboard"
Persistent riddles: Each chest remembers its assigned riddle
Random assignment: Riddles randomly assigned from your pool

Per-Player Loot

Independent inventories: Each player has their own copy of the chest
Unique loot generation: Different loot for different players (seed-based)
Persistent storage: Your loot is saved even after logging out
No grief potential: Other players can't steal your loot

Safety Features

Break warnings: Confirm before destroying riddle chests
Item protection: Optional item deletion prevents exploitation
Configurable timeout: Control how long warnings last

- Shift requirement: Extra safety with shift-to-break option

🐛 Known Compatibility

✅ Compatible with Lootr for enhanced per-player features
✅ Works on naturally generated chests in structures
✅ Player-placed chests are never affected

📝 Planned Features

<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Different riddle types (multiple choice, fill-in-blank, etc.)
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Riddle difficulty tiers
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Custom rewards for solving riddles
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Riddle categories/themes
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Per-dimension riddle configurations

🆘 Support

If you encounter any issues or have suggestions:

Check your latest.log for errors
Ensure config files are properly formatted
Verify you're using the correct Minecraft/NeoForge version

- Discord https://discord.gg/bWU2a5tMtS

📜 License

👤 Author

Created by TrivialBrett

Enjoy challenging your players with riddles! 🧩✨