DoItDigital Treasure Hunt

---

Advanced Treasure Hunting Script for FiveM

DoItDigital Treasure Hunt turns your whole map into a treasure field. Players buy a map from the Treasure Hunter NPC, reveal a hidden location, drive out, search the area for the chest waiting there and crack it open — then do it again for better rewards as their hunter rank climbs.

It is a full progression career, not a one-off minigame: three ranks, five loot tiers, level-locked locations and a scanner economy you control down to the charge.

🧭 The Treasure Hunter NPC

Every hunt starts at the NPC. Players buy their treasure map and, if they want the shortcut, a treasure scanner.

✅ NPC location
✅ Ped model
✅ Item names and prices
✅ Full shop setup

All of it sits in the config — drop the NPC wherever your economy needs it.

🗺️ The Hunt

Opening the map reveals a treasure location. From there it is on the player: get to the area, sweep it, and find the chest that is actually placed out there in the world.

💰 Search the treasure
• Receive the loot for that treasure type
• Gain XP toward the next rank
• Locations refresh automatically on the reset timer

📈 Three Hunter Ranks

Progression runs on a simple XP curve you own completely:

🥉 Newbie — the starting rank
🥈 Intermediate — unlocks better treasures and new ground
🥇 Expert — the full map and the top loot tiers

Each rank changes both what a player can find and where they can find it, so the world opens up as they earn it.

💎 Five Loot Tiers

Copper, Iron, Animal Skin, Gold and Diamond — each with its own label, description, inventory image, world prop and required level.

Want a sixth? Add another entry to the treasure types table. Nothing is hardcoded.

🐺 Living Treasures

One tier does not play by the rules. Animal skin treasures spawn as a live animal instead of a chest — a random deer, cow or mountain lion. Walk up and the script tells you the creature is still alive: put it to sleep first, then take the skin.

📡 The Treasure Scanner

The scanner is the difference between hunting and wandering.

❌ Without charges — no route is drawn. Players read the map and search the area on foot.
✅ With the scanner — the location is routed instantly.

Charges per scanner item are configurable, so you decide whether the scanner is a luxury or a staple.

⏱️ Automatic Resets

Treasure locations reset on a timer you set, so the hunt refills itself and the map never goes dead. Pick the reset minute, cap how many locations are active at once, and let it run.

⚙️ Everything Is Configurable

✅ XP per treasure
✅ XP required for each level
✅ The levels themselves
✅ Active locations per level
✅ Treasure loot tables
✅ Props and NPCs
✅ Required level for each item
✅ Treasure reset timers
✅ Maximum active treasure locations
✅ Treasure spawn locations
✅ Item names and prices

💡 Why Choose DoItDigital Treasure Hunt?

✨ A real progression loop, not a repeatable prop interaction
✨ Rewards that scale with rank, so hunting stays worth it
✨ Built-in scarcity through scanner charges and location caps
✨ Living treasures that break the routine
✨ Self-refreshing world — no admin upkeep
✨ Commented config with sensible defaults

Perfect for roleplay, survival and adventure servers that want something to do between jobs.

📦 Requirements

⚠️ This package includes two resources. Both are delivered with your purchase and both must be installed and started:

• doitdigital_treasurehunt — the script itself
• DoItDigital_lib — shared library, required. Start it before the script.

The script uses your framework for money and inventory items, so a working framework and inventory system are required.

💬 Support & community: https://discord.gg/MtEX7K4Sa8