> For the complete documentation index, see [llms.txt](https://dexlab-scripts.gitbook.io/dexlab-scripts-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dexlab-scripts.gitbook.io/dexlab-scripts-docs/redm-free-releases/dex-treasure-hunting/user-guide/features.md).

# Features

<figure><img src="https://3628839866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzeH5m2NcpM6wdeyLkzje%2Fuploads%2FBkIzfa88vKA3lgqlMIIR%2Fimage_2026-01-12_202541720.png?alt=media&amp;token=450569fd-6e84-44ce-b3f1-d80e988b3865" alt=""><figcaption></figcaption></figure>

***

{% embed url="<https://youtu.be/bk32N-2MPQA>" %}

***

## 🧰 **Features**

***

### 🏴‍☠️ **Treasure Hunt Core**

🔹 Server-wide treasure hunt events with competitive gameplay\
🔹 One hidden chest inside a visible search radius\
🔹 First player to open the chest wins the reward\
🔹 Fully server-validated claim logic (no exploits)

***

### ⚙️ **Admin Event Control**

🔹 In-game admin menu to configure rewards before starting\
🔹 Supports items, weapons, money, and gold\
🔹 Optional custom chest prop model per event\
🔹 Optional required item to unlock the chest\
🔹 Start and stop events without restarting the resource

***

### 📍 **Precision Placement**

🔹 Manually pick the radius center in-world\
🔹 Manually pick the exact chest spawn location\
🔹 Automatic ground-safe placement validation\
🔹 Radius blip visible to all players on the map

***

### 🔒 **Locked Chest System**

🔹 Optional required item (shovel, key, etc.)\
🔹 Immersive unlock progress with animation\
🔹 Chest unlocks globally once requirement is met\
🔹 Vanilla chest opening resumes after unlock

***

### 🎬 **Immersion & UI**

🔹 Old West–style NUI announcements (start, end, winner)\
🔹 Optional announcement sound with volume control\
🔹 Native chest opening animations with fallback logic\
🔹 Clean removal of vanilla prompts when locked

***

### 🎁 **Reward Distribution**

🔹 Automatic loot delivery to the winning player\
🔹 Items & weapons via inventory system\
🔹 Money and gold via character currency\
🔹 Rewards granted only once, server-side enforced

***

### 💾 **Persistence & Sync**

🔹 Active events saved to database (restart-safe)\
🔹 Queued/pending treasure events supported\
🔹 Late-join sync: new players see active chest + radius\
🔹 Safe cleanup on resource stop/start

***

### 🛡️ **Safety & Logging**

🔹 Robust anti-spam and cooldown handling\
🔹 Prevents double-claim and race conditions\
🔹 Discord webhook logs for start, end, and winner\
🔹 Logs include loot, player identifiers, and coordinates

***

### ⚙️ **Fully Configurable**

🔹 Radius size, animations, cooldowns, sounds, items\
🔹 Easy locale support (EN / PT included)\
🔹 Designed to be extended with future event types

***

### 🔌 **VORP Integrated**

🔹 Built for VORP Core, Inventory, and database systems
