Gunchi Dev · Metal Detecting

Bring a fully interactive, immersive metal detecting experience to your FiveM server — now on every major framework! Players equip a metal detector, follow the compass and proximity beeps, and dig up hidden loot across the map, complete with a custom animated DUI.

🧩 Framework Compatibility

Works out of the box on ESX, QBCore, QBox, ND Core and Standalone — powered by the free, open-source gunchi-bridge. Framework, inventory, target and dispatch integration are all handled by the bridge, so one purchase covers your server no matter what you run (or migrate to later).

🌟 Features

Custom Metal Detector UI: Beautiful, animated DUI screen with signal strength, direction compass, and distance display.
Proximity Beeps: The detector beeps faster the closer you get — hunt by ear as well as by eye.
Dynamic Treasure Zones: Randomized dig spots generated in allowed areas on real diggable ground, with configurable cooldowns and distances.
Dig Skill Check: Optional minigame while digging — fail it and the spot is ruined, you get junk, your streak resets and your shovel might break. Uses the ox_lib skill check by default, with an open, editable file (commented examples for ps-ui and SN-Hacking included) so you can plug in whatever minigame your server uses.
Deep Signals: Some finds are buried deep — several shovelfuls to reach, but with guaranteed higher-tier loot.
Streak System: Consecutive successful digs boost your rare loot chances, rewarding players who stay out detecting.
Optional Shovel Requirement: Require a shovel item to dig, with a configurable break chance on failed digs.
Police Dispatch Alerts: Configurable chance of alerting police per dig — turn detecting into a risk/reward activity.
Configurable Loot Table: Fully customizable rarity tiers (common, uncommon, rare, epic, legendary), items, amounts and drop chances.
Zone Restrictions: Control exactly where detecting is allowed (beaches, forests, mountains, Cayo Perico…) via config.
Secure & Anti-Abuse: Loot is rolled entirely server-side, with per-player reward cooldowns and randomized zones that require real exploration.
Fully Translatable: Every player-facing string lives in an open locales file.

🛠️ Configuration

Loot Items & Chances: Edit config.lua to set your own items, amounts, and rarity chances.
Allowed Zones: Enable or disable metal detecting in any GTA zone.
Diggable Materials: Define which ground types can be dug.
Cooldowns & Distances: Set how often and how far away new dig zones appear.
Gameplay Toggles: Skill check, deep signals, streaks, police alerts and shovel requirement can each be enabled, disabled and tuned independently.

🔓 Escrow-Friendly

Open config, open locales, and an open editable skill check file
Easy customization and expansion without touching escrowed code

🎮 How It Works

Equip the metal detector.
The custom DUI appears, showing signal strength, distance and direction.
Explore the map and follow the beeps to find a signal.
Reach the dig zone and dig — pass the skill check (if enabled) to claim your find.
Receive a random server-rolled reward based on your luck, your streak, and the loot table!

📦 Dependencies