Treasure Hunts

TreasureHunts

A fully persistent, clue-based treasure hunt system for Rust servers built for Carbon/Oxide.

Players progress through a sequential chain of hidden clue crates scattered across the map, collecting notes and solving riddles to uncover the final treasure. Each player has their own saved progression, allowing hunts to persist through restarts and wipes.

Features
Persistent player progress tracking
Sequential clue system with customizable riddles
Hidden treasure crates with configurable rewards
Admin commands for placing clue crates anywhere on the map
Automatic crate respawning system
Per-player progression and completion tracking
Configurable reward tables with chance-based loot
Indestructible custom treasure crates
Fully compatible with Carbon and Oxide
Clue texts and loot tables are fully configurable through the generated TreasureHunts.json config file
Player Commands
/th.progress — Check current treasure hunt progress
Admin Commands
/crate1 → /crate5 — Set clue crate locations
/treasure — Set final treasure crate
/th.refresh — Refresh the entire treasure hunt
/th.fullwipe — Completely wipe all hunt data and entities
/th.status — View active hunt status and completion stats

Perfect for RP, survival, PvE, or community-focused Rust servers looking to add exploration, mystery, and replayable world events.