🔍 dv_prospecting — Metalldetektor & Schatzsuche für ESX & QBCore | FiveM
Schick deine Spieler auf echte Schatzsuche – mit einem realistischen Metalldetektor, dynamischem Signalton und einem Belohnungssystem mit drei Seltenheitsstufen.
💡 Was ist dv_prospecting?
dv_prospecting ist ein immersives Schatzsuche-Script für FiveM-Server auf ESX- oder QBCore-Basis. Spieler nehmen ihren Metalldetektor in die Hand, begeben sich in eine der konfigurierten Suchzonen und folgen dem Signal – je näher ein vergrabener Fund, desto schneller und lauter das Piepen. Ist man nah genug dran, wird gegraben. Was dabei herauskommt, entscheidet das Glück: Common, Rare oder Epic. Einfach zu konfigurieren, sofort spielbereit und vollständig an jeden Server anpassbar.
⚙️ Features auf einen Blick
🗺️ Unbegrenzt viele Suchzonen – frei konfigurierbar mit Koordinaten, Radius und Fundort-Anzahl
📡 Dynamisches Metalldetektor-Signal – Piepfrequenz und Marker-Geschwindigkeit steigen je näher der Fund ist
🎨 Farbiger Bodenmarker – grün bei weitem Abstand, gelb bei mittlerem, rot wenn man kurz davor ist
🔊 Audio on/off – Signalton lässt sich per Taste jederzeit stumm schalten
🎁 Drei Seltenheitsstufen – Common, Rare und Epic mit individuell einstellbaren Chancen pro Zone
📦 Items frei konfigurierbar – jede Zone bekommt eigene Item-Listen pro Seltenheitsstufe
🔫 Detektor als nutzbares Item – Aktivierung direkt über das Inventar, kein Befehl nötig
🗺️ Minimap-Blips – Suchzonen werden auf der Karte angezeigt, ein- und ausschaltbar
🎮 Eigenes Key-Hint HUD – zeigt aktive Steuerungstasten elegant am unteren Bildschirmrand
🏃 Bewegungsbeschränkung – Detektor deaktiviert sich automatisch beim Sprinten, Springen oder im Fahrzeug
🔒 Serverseitige Validierung – Fund-Events werden serverseitig geprüft, kein clientseitiger Exploit möglich
🐛 Debug-Modus – Konsolenausgaben per Config-Option ein- und ausschaltbar
⚡ Performance-schonend – nur nahe Fundorte werden aktiv geladen, weiter entfernte ignoriert
🎮 Steuerung
Linke Maustaste – Graben wenn ein Fund in Reichweite ist
F – Suche beenden und Detektor weglegen
Q – Signalton ein- oder ausschalten
📡 Das Signalsystem
Der Detektor reagiert stufenweise auf die Entfernung zum nächsten vergrabenen Fund. Weit entfernt ist es still. Ab einer gewissen Nähe beginnt ein langsames Piepen mit einem grünen Marker am Boden. Je näher man kommt, desto schneller wird das Signal und der Marker wechselt von grün über gelb zu rot. Ist man direkt drüber, piept es schnell und der Marker leuchtet rot – jetzt kann gegraben werden.
🎁 Das Belohnungssystem
Jede Fundstelle in einer Zone hat eine festgelegte Seltenheitsstufe. Beim Graben wird per Würfelwurf geprüft, ob Epic oder Rare getroffen wird – schlägt beides fehl, gibt es immer mindestens ein Common-Item. Jede Stufe hat eine eigene Item-Liste, aus der zufällig ein Item mit einer zufälligen Menge zwischen Minimum und Maximum ausgewählt wird.
⚙️ Konfiguration auf einen Blick
Config.Core – Framework auswählen (ESX oder QBCore)
Config.Debug – Konsolenausgaben ein-/ausschalten
Config.ShowBlip – Minimap-Blips ein-/ausschalten
Config.ShowDrawMaker – Bodenmarker während der Suche ein-/ausschalten
Config.DetectorItem – Name des Inventar-Items das den Detektor aktiviert
Config.Chances – Prozentchance für Rare und Epic pro Fundstelle
Config.Zones – Alle Suchzonen mit Koordinaten, Radius und Fundort-Anzahl
Config.Items – Item-Listen pro Zone und Seltenheitsstufe mit Min/Max-Mengen
Config.DefaultItems – Fallback-Items wenn keine Zone-Items konfiguriert sind
📦 Abhängigkeiten
Pflicht (eines von beiden): es_extended (ESX) oder qb-core (QBCore)
Optional: ox_inventory oder natives ESX/QBCore Inventar – Items werden automatisch erkannt
🚀 Installation in 4 Schritten
1️⃣ Ordner in resources/ legen
2️⃣ ensure dv_prospecting in die server.cfg eintragen
3️⃣ Zonen, Items und Chancen in der config.lua anpassen
4️⃣ Detektor-Item ins Inventar eintragen (ox_items Einträge liegen fertig bei) – fertig!