Build with confidence.

What you get

• Optimized Lua — every loop, thread and event audited for production load.
• ESX Legacy 1.13+, QBCore & Qbox — multi-framework, auto-detected.
• Escrow + open config — locked logic, fully editable settings.
• Real Discord support — devs reply, not bots.

Quick install

1. Drop the resource into your server.

   Place the unzipped vDetector folder inside resources/[vulkan]/.

2. Import the SQL manually.

   Open the included install.sql and run it in your database (phpMyAdmin, HeidiSQL, DBeaver, etc.). Do not skip this step — the script will not auto-create its tables on first launch.

   SQL must be imported manually before starting the resource. Auto-migration is currently disabled.
3. Add the line to your server.cfg.
   server.cfg Copy

   # ESX Legacy + dependencies first…
   ensure oxmysql
   ensure ox_lib
   ensure es_extended
   
   # vDetector
   ensure vDetector

4. Tune the configs and restart.

   Edit config.lua, detectors.lua, zones.lua, loot.lua & the locale of your choice — then reboot the server.

Core gameplay

• Native GTA V digiscanner — real two-handed weapon with working scaleform on the prop screen (just like the Treasure Hunt mission).
• 3 detector tiers — Basic, Pro, Legendary (40 m / 70 m / 120 m range).
• 6 search zones across San Andreas, on 3 difficulty tiers.
• Distance-based beep with progressive bars and color shifts (red → yellow → green).
• Realistic dig animation with shovel prop attached to the player's hand.
• Auto-stow — detector unequips when entering a vehicle, dying, swimming, ragdolling or falling.

Detector tiers

All three tiers share the same prop (w_am_digiscanner — the real GTA V Treasure Hunt scanner) and the same shovel item (shovel, $50). What changes is the rarity weight table for loot rolls, the range, and the scan rate.

legendary = {
    label    = _U('detector_legendary_label'),
    item     = 'metal_detector_legendary',
    prop     = 'w_am_digiscanner',
    price    = 25000,
    range    = 120.0,                    -- meters
    scanRate = 150,                       -- ms between beep updates
    rarityWeights = {
        [1] = 30,                       -- common
        [2] = 30,                       -- uncommon
        [3] = 25,                       -- rare
        [4] = 12,                       -- epic
        [5] = 3,                        -- mythic
    },
    requiredLevel = 20,
}

Search zones

Treasure chest system

• Ultra-rare drop in Tier 3 zones only — pry open with a crowbar (treasure_crowbar, $2,000 at the shop).
• Custom prop placed on the ground (m23_1_prop_m31_roostercrate_01a), opened via ox_target with key proximity fallback (range 2 m).
• Open animation : kneeling medic clip, 6 s hold time.
• 15% fail chance (configurable) — crowbar consumed, no reward.
• On success : $4,000–$12,500 cash + independent rolls on bonus items :
  • 40% chance × 1–2 gold nuggets
  • 15% chance × 1 vintage Rolex
  • 5% chance × 1 pirate doubloon
• Auto-despawn 5 s after the player picks the loot.

rewards = {
    moneyMin = 4000,
    moneyMax = 12500,

    items = {
        { item = 'gold_nugget',     chance = 0.40, qtyMin = 1, qtyMax = 2 },
        { item = 'rolex_vintage',   chance = 0.15, qtyMin = 1, qtyMax = 1 },
        { item = 'pirate_doubloon', chance = 0.05, qtyMin = 1, qtyMax = 1 },
    },
}

XP / Level / Progression

• 30 levels with configurable XP curve.
• Per-rarity XP gains — common = 10 XP, mythic = 50 XP.
• Custom in-game level-up notification — Vulkan-style, glassmorphic, animated bar with shimmer.
• Native particle FX + screen flash on rare/mythic finds.

Weekly leaderboard

• Top hunters of the week, auto-resetting every Monday (ISO week tracking — no cron job needed).
• Beautiful 3-place podium + scrollable full ranking.
• You tag highlights your position.

Antiquaire / Detector shop

• Custom Vulkan-style 3-column NUI — Sell / Buy / Leaderboard side-by-side.
• Animated number counters, gold particle effects on rare sales.
• Sell-all-at-once button with shimmer animation.
• Items locked / unlocked based on level + money.
• Toast notifications & sound effects on every action.

Loot

• 30+ items — coins, rings, gold chains, gold nuggets, vintage Rolex, pirate doubloons…
• 8 junk items for RP humor — old shoe, broken bottle, lost dentures, dried fish…
• 5 rarity tiers (Common → Mythic), per-tier loot tables, weighted picks.

Multi-language support

Locales bundled in locales/<lang>.lua, 128 translation keys, zero hardcoded strings. Add a new language = duplicate one of the bundled files. Switch language with Config.Locale = 'fr' in config.lua.

• 🇬🇧 English (en.lua)
• 🇫🇷 French (fr.lua)
• 🇩🇪 German
• 🇪🇸 Spanish
• 🇧🇷 Brazilian Portuguese

Sound design

• Frontend sounds for every action (menu open/close, buy, sell, dig success per rarity, level up, chest place/open).
• Rarity-based dig sounds — common to mythic = different audio cue.
• Native digiscanner beep with distance-based cadence.

Security & anti-cheat

• All callbacks rate-limited (configurable cooldowns per action — see table below).
• Server-side validation on every dig — zone, distance, detector ownership, point existence, inventory capacity.
• XY tolerance of 3.0 m between server-known dig point and client-claimed position. Above that = rejected.
• Chest opening requires placed chest state server-side (anti money-print exploit).
• Suspicious attempts logged to a Discord webhook with player identifier (configurable minRarityForLog, default rarity ≥ 3).
• Per-player webhook rate-limit (WebhookCooldown = 3000 ms) to prevent spam.

UI / UX

• Responsive design — auto-scales from 800×600 to 4K, ultrawide.
• 10 theme colors exposed via Config.UITheme — change them without touching CSS.
• All UI texts loaded from the locale bundle — zero hardcoded strings.
• Smooth animations, slide-ins, glassmorphism effects.

Config.UITheme = {
    background  = '#0a0a0c',   -- panel background
    accent      = '#94a3b8',   -- accent (text, hover, bars)
    accentDark  = '#475569',   -- darker accent (gradients)
    gold        = '#f1c40f',   -- prices, podium, mythic items
    success     = '#2ecc71',   -- successful sale, money gained
    danger      = '#e74c3c',   -- errors, money lost, close button
    info        = '#3498db',   -- rarity 2 (uncommon, blue)
    warning     = '#e67e22',   -- rarity 4 (epic, orange)
    text        = '#ffffff',   -- main text
    textDim     = '#71717a',   -- secondary text
}

Performance

• < 0.05 ms client-side when active, < 0.01 ms idle.
• Idle threads use 1000–1500 ms waits.
• Cached zone & loot label lookups (O(1)).
• Debug threads early-return when Config.Debug = false (zero cost in prod).

Compatibility

• ESX Legacy 1.13+, QBCore & Qbox (auto-detect via Config.Framework)
• ox_inventory or framework inventory (auto-detect via Config.Inventory)
• ox_target + key proximity fallback (Config.Target)
• ox_lib — progressBar, notify, requestModel, requestAnimDict
• oxmysql for database
• 1 SQL file to install (manual import — see install steps)

Global configuration cheatsheet

Most servers only need to tweak a handful of values in config.lua. Here's the full list of the most useful keys :

Discord webhook

Config.Webhook = {
    enabled = true,
    url     = 'https://discord.com/api/webhooks/...',
    botName = 'vDetector',
    avatar  = 'https://i.imgur.com/4M34hi2.png',
    color   = 16766720,                    -- gold
    minRarityForLog = 3,                   -- log items rarity ≥ 3 only
}

Customization

7 config files separated by concern: config.lua, detectors.lua, zones.lua, loot.lua + 5 locale files.

• Add a new zone in 1 block — coords + radius + tier + level + blip.
• Add a new detector tier with custom rarity weights.
• Add a new loot item in 1 line.
• Tune XP curve, sell prices, cooldowns, webhook, theme colors.
• Asset Escrow ready — configs & locales in escrow_ignore.

Add a new search zone

-- zones.lua — append to Config.Zones
{
    name          = 'zone_sandy_shores',
    label         = _U('zone_sandy'),         -- locale key
    center        = vector3(219.60, 7036.61, 3.73),
    radius        = 40.0,
    tier          = 3,                       -- 1 | 2 | 3 (loot table)
    requiredLevel = 20,
    blip          = { sprite = 568, color = 46, scale = 0.5 },
},

Add a new loot item

-- loot.lua — append to Config.Loot[tier]
{
    item   = 'pirate_doubloon',
    label  = _U('loot_doubloon'),       -- locale key
    rarity = 5,                        -- 1 common .. 5 mythic
    sell   = { 8000, 15000 },             -- min/max antiquaire price
    weight = 2,                        -- weight inside its rarity bucket
    -- noSell = true,                  -- set on items that should never appear in the shop
},

Database

• 1 table — treasure_hunter_data with 4 indexed columns.
• Manual SQL install via the bundled install.sql file (no auto-migration).
• Persistent XP / level / total finds / weekly finds.

Quick install

1. Drop the resource into your server.

   Place the vTablet folder inside resources/ and add the ensure line to your server.cfg.

   server.cfg Copy

   # dependencies first…
   ensure oxmysql
   
   # vTablet
   ensure vTablet

2. Import the SQL.

   Run sql/install.sql in your database — it creates the tables and the default catalog.

3. Register the tablet item.

   Use sql/esx_items.sql, or the provided .lua.snippet for QBCore / ox_inventory.

4. Grant admin access.
   server.cfg — ACE permission Copy

   add_ace group.admin vtablet.admin allow

   Or list admins directly in Config.AdminIdentifiers (license / steam / discord id).

5. Add your Discord webhooks & restart.

   Paste your webhook URLs in config/secrets.lua, then reboot the server.

Core features

• 📱 Real tablet OS UI — home screen, apps, dock, custom glitch boot intro (pure React, no ds_bundle).
• 🔒 Encrypted DarkNet account — register / login, DB-persisted, forgot-password recovery.
• 🧅 Hidden .onion markets — locked until you buy the address (404 otherwise).
• 🕵️ 3 NPC brokers sell the .onion links (drugs / guns / gear).
• 🛒 Database-driven catalog + cart — add / remove, quantities, one-click checkout.
• 📦 Immersive NPC delivery — random meeting point, GPS route, van + guards + cargo search animation.
• 💬 Live multiplayer forum — configurable channels, post / edit / delete in real time.
• ⚙️ Full in-game admin panel — items, prices, stock, images by link, clear forums (no code editing).
• 🔑 Admin by ACE or identifier — gamemode-independent.
• 🔔 2 Discord webhooks — orders & deliveries / forum.
• 🎵 Native GTA V sound design + configurable open animation.
• 🛡️ Server-side anti-cheat — ownership & distance checks.
• 🌍 5 languages — EN, FR, DE, ES, PT-BR (fully translatable).
• 🧩 Fully modular config — cooldowns, account rules, meeting points, NPC skins & more.

Compatibility

• ESX Legacy · QBCore · Qbox (auto-detected via Config.Framework)
• ox_inventory, qb-inventory or ESX inventory (auto-detect)
• ox_target / qb-target with [E] key fallback
• Requires oxmysql — no ox_lib needed

Key configuration

Delivery meeting points

Each order is dropped at a random point from this list — a vector4 (x, y, z, heading). Add as many as you want.

Config.MeetingPoints = {
    vector4(-586.19, -1637.08, 19.81, 69.66),
    vector4(112.39, -2260.76, 6.08, 178.93),
    vector4(1509.04, -2147.13, 77.13, 97.88),
}

Database

• Manual SQL install via the bundled sql/install.sql (tables + default catalog).
• Tablet item registered through sql/esx_items.sql or the QB / ox .lua.snippet.
• Persistent DarkNet accounts, catalog, orders & forum posts.

Resource fails to start

• Check your FXServer artifact build — minimum 6500+ recommended.
• Verify es_extended, oxmysql and ox_lib all start before vDetector in your server.cfg.
• Make sure the SQL has been imported manually (auto-install is currently disabled).
• Open a Discord ticket with your server console output.

Translation strings show as raw keys

If the UI displays things like loot_old_coin instead of the translated label, your locale is missing or mistyped. Each script ships with locales/en.lua and locales/fr.lua — duplicate one to add a new language and update Config.Locale in config.lua.

NPC doesn't react to interaction

• If you use ox_target: confirm it's started before vDetector, and that Config.Target = 'ox_target' in config.lua.
• If you use the key fallback: set Config.Target = 'key' and check Config.InteractionKey (default 38 = E).

Detector won't equip / no scaleform on screen

The script uses the native WEAPON_DIGISCANNER. Make sure your server doesn't blacklist it via your anti-cheat or weapon whitelist. The prop used is w_am_digiscanner — must be loadable on your build.