> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_prospecting.md). # ak47\_prospecting The ultimate metal detecting and treasure prospecting experience for FiveM servers. {% embed url="" %} ak47\_prospecting introduces an immersive, fully interactive outdoor activity where players equip a custom 3D metal detector to sweep the terrain and unearth valuable underground relics. Featuring realistic proximity-based radar audio beeps, on-the-fly scroll wheel volume controls, shovel excavation scenarios, and an integrated pawn shop economy, it brings engaging exploration and progression to your server. Seamlessly powered by ak47\_lib with synchronized multiplayer zones and out-of-the-box support for ESX, QBCore, and QBX. *** ### πŸ”₯ Key Features Designed to improve roleplay immersion and economy balancing: #### πŸ” Metal Detector & Dynamic Audio Radar * **Custom 3D Prop & Sweeping Animations:** Equipping the metal detector attaches a custom 3D scanner model (`w_am_digiscanner`) to the player's hands with authentic body posture and sweeping animations. * **4-Stage Proximity Audio:** Integrated NUI Howler audio plays realistic beep tones that accelerate through 4 distinct frequency tiers as players get closer to buried treasure (<10m, <5m, <2m). * **On-the-Fly Volume Controls:** Players can smoothly increase or decrease the scanner audio volume at any time using their mouse scroll wheel (`SCROLLUP` / `SCROLLDOWN`) guided by an on-screen controls HUD. #### πŸ—ΊοΈ Prospecting Zones & Dynamic Spawning * **Configurable Zones & Radius Blips:** Create multiple prospecting areas with custom coordinates, radius circles, spawn limits, and map blip styles directly in the config. * **Ground-Level Height Calculation:** Buried treasure points automatically calculate accurate ground surface coordinates (`GetGroundZFor_3dCoord`), ensuring realistic placement across hills, dunes, and beaches. * **GlobalState Multiplayer Sync:** Active search coordinates are managed via FiveM's `GlobalState.searchPoints`, ensuring synchronized zones and preventing duplicate spawns across players. #### ⛏️ Shovel Excavation & Tiered Loot Drops * **Excavation Scenario & Progress Bar:** Getting within 2 meters triggers a clean `[E] Dig` prompt, putting away the detector to initiate a gardening/digging animation and progress bar. * **3-Tier Rarity System:** Rewards roll on configurable drop chances divided into Common (100%), Rare (50%), and Epic (10%) loot tiers with randomized quantity ranges. * **11 Pre-Configured Relics & Valuables:** Comes loaded with items including broken glasses, pendrives, rusted rods, broken phones, action cams, rusty guns, wedding rings, gold chains, gold watches, diamond necklaces, and rare gemstones. #### πŸ’° Integrated Pawn Shop Economy * **Pawn Shop Locations & Blips:** Set up pawn shops with custom map blips and 3D floating world text where players can turn their discoveries into cash. * **Interactive Sell Menu:** Context menu automatically detects prospecting items in the player's inventory, showing current market prices, held counts, and a custom quantity sell dialog. * **Dynamic Fluctuating Prices:** Configure items to use fixed prices or randomize between minimum and maximum values on every server restart for a fluctuating roleplay economy. #### πŸ› οΈ Technical Excellence * **Multi-Framework & Target Support:** Seamlessly works with ESX, QB, QBX, and various target systems (ox\_target, qb-target, qtarget). * **Highly Secure:** Built-in server-side exploit checks, including distance validation and trigger authentication, to prevent cheating. * **Turnkey Setup & Assets:** Includes complete item definitions for QBCore (`qb.lua`), ox\_inventory (`ox.lua`), and ESX SQL (`esx.sql`) alongside custom PNG item icons. *** ### πŸ’» Framework: * ESX, QB, QBX *** ### βš™οΈ Dependencies: * ak47\_lib: *** ### βš™οΈ How To Install: * Download ak47\_prospecting from your cfx portal. * Add the script in your resources folder. * Add items based on your framework instruction. * Add item images into inventory. * Start the script in your server.cfg below framework files. * Make sure you have all dependencies. * Restart the server. *** ### πŸ”— Links & Support: * **πŸ“– Documentation:** * **πŸ›’ Buy Now (Tebex):** * **πŸ’¬ Discord Support:** *** ### πŸ“ Note: * We don't support custom framework. Make sure you are using official framework update. * Renaming the script is not allowed. It may break the functionalities. * Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading