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

1. Player opens a naturally generated chest
2. 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
3. Each player gets fresh loot generated just for them
4. 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

• [ ] Different riddle types (multiple choice, fill-in-blank, etc.)
• [ ] Riddle difficulty tiers
• [ ] Custom rewards for solving riddles
• [ ] Riddle categories/themes
• [ ] 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

---

📜 License

All Rights Reserved

---

👤 Author

Created by TrivialBrett

---

Enjoy challenging your players with riddles! 🧩✨