This script provides a complete metal detecting system for FiveM with QBCore. It allows players to search for hidden treasure, level up and upgrade their equipment. Featuring an immersive user interface and realistic animations, it delivers an authentic gaming experience.

https://youtu.be/BHwmV6A5CKI

- Detection system

Progressive detection: Signal strength varies with distance from object

Responsive HUD interface: Visual display of signal strength, depth and battery level

Sound effects: Beeps that vary in frequency according to proximity to object

Realistic animations: Detection and digging animations

Vibrations and visual effects: Enhances immersion during discoveries

- Progression and levels

XP system: Gain experience with each discovery

4 progression levels: Beginner, Intermediate, Advanced and Premium

Level restrictions: Each detector requires a minimum level to be used

Detailed statistics: Tracking of finds and total value discovered

- Equipment

4 different detectors:

Standard (green) : For beginners

Intermediate (blue): Improved range and accuracy

Advanced (red): High performance for experts

Premium (gold): Maximum performance for professionals

Batteries : Different battery capacities (standard, enhanced, long-life)

Wear system: Battery discharges during use

-Findable zones and objects

Detection zones: Different zones with level restrictions

Hotspots: Temporary areas with increased chances of finding objects

Variety of items: From common items to legendary relics

Variable value: The higher the level, the more valuable the items found

- User interface

Custom HUD: Elegant visual interface adapted to the type of detector

Stylised menus: Menus consistent with the overall theme

Notifications: Notification system to keep the player informed

Signal viewer: Graphical representation of signal strength

- Economy and trade

Buying equipment: Dedicated shop for buying detectors and batteries

Selling finds: NPC buyer to sell discovered treasures

Progressive value: Rare items have a higher value

- Customisation

The script is highly configurable via the config.lua file:

Adjustment of zones and blips

Modification of detector performance

Customisation of findable objects and their value

Adjustment of chances of discovery and multipliers

Configure animations and effects

- Technical specifications

Optimised: Low impact on server performance

Persistent storage: Saves players' progress in the database

Advanced notification system: Display of clear and attractive information

- Dependencies

QBCore Framework

qb-target

oxmysql

Developed with ❤️ to improve the RP experience on your FiveM server.