🚘 JamzVehicleExtras – Vehicle Upgrades & Immersion Pack [QBCore | QBox | ESX]
Transform vehicles on your server with installable upgrades, hidden storage, luxury lighting, radar detectors, blank plates, phone holders, and more. All fully synced, interactive, and saved to the database.

🔗 YouTube Preview: JamzScripts

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ FEATURES

📡 Radar detector

Portable police scanner - install with a usable item while seated in the vehicle.

- Live detection of configured police vehicle models within range; beep rate scales with distance (closer = faster).
- In-car HUD: band display (X / KA / OFF), signal strength bar, alert counter — driver-only widget.
- 3D audio via XSound (positional or optional 2D fallback); first detection also fires an ox_lib notification.
- / key (rebindable): mute / unmute alerts per vehicle without removing the unit.
- Target removal on boot / bonnet / bodyshell; only the installer can remove; item returned on removal (configurable).
- ox_lib progress install/remove with in-vehicle or standing animations.

🪪 Blank / North Yankton plates

Give your vehicle a clean stealth plate cover perfect for RP situations.

- Install/remove directly from the rear of the vehicle using target interaction.
- Toggle between the blank plate and your original registered plate with a rebindable key.
- Includes custom plate textures, install/remove sounds, and on-screen switch UI.
- Fully saved to the database so your setup persists through restarts and respawns.
- Original plate state is automatically restored when removed.

💡 Door puddle lights

Luxury door-down lighting - coloured LEDs under each door when it opens.

- 15 colours (white, warm white, blue, ice blue, red, green, yellow, orange, amber, purple, pink, cyan, lime, magenta, teal).
- Per-door install via target - pick colour from inventory.
- ~165+ pre-tuned vehicle offsets in config, plus a DEFAULT fallback for addon cars.
- Lights draw from door hinge bones with configurable range/intensity per model.
- Persists in MySQL per plate, model, and door index.

🟣 Footwell / cabin lights

Interior ambient lighting for driver and passenger footwells.

- Two slots per supported vehicle (driver + passenger) with the same 15 colour item set.
- ox_lib context menus to pick slot → colour; install/remove with progress.
- ~145+ vehicle offset profiles in config for accurate placement.
- Real-time DrawLight visuals synced from the server when near the vehicle.
- DB persistence; optional vehicle ownership check on management.

📱 Car phone holders

Dash-mounted phone props tied to vehicle extras.

- Custom streamed prop (phone_jmz) with per-vehicle extra IDs and offset/rotation tables (50+ vehicles pre-configured).
- Radio-synced screen skins: prop texture swaps to match the player’s current GTA radio station (30+ station artwork YTDs included).
- Target “Manage phone holders” — install/remove with progress; vehicle ownership optionally required.
- Toggles the correct vehicle extra and spawns the prop when installed; state saved per plate + model in MySQL.
- Expandable: add any vehicle that already has suitable extras in Config.VehicleExtras.

🪑 Under-seat vehicle storage

Hidden stash per seat

- Inside the car: progress + keybind (. default, rebindable) to reach under your seat.
- Outside the car: target “Seat storage” on boot / bonnet / bodyshell with distance check.
- Per-seat qb-inventory / ox_inventory stashes (slots + max weight configurable).
- Vehicle class whitelist (cars, SUVs, sports, vans, etc. — bikes/planes/emergency excluded by default).

🔧 Door panel smuggling stashes

RP smuggling compartments behind door panels, hood, and trunk.

- Usable tool item opens an ox_lib door menu (FL / FR / RL / RR / hood / trunk) with styled icons.
- Pry progress → open door → unique stash per compartment (separate slot/weight for doors vs hood vs trunk).
- Auto-seal when inventory closes: progress + door shuts — feels like closing the panel.
- Reusable tool (not consumed); DB registry per plate/door.
- Same vehicle class filters and ownership options as seat storage.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ Configuration

🌉 Framework & bridge

One config picks your stack; bridges auto-prefer ox when set to 'auto'.

Config.Framework = 'qb'      -- 'qb' or 'esx'
Config.Inventory = 'qb'       -- 'qb', 'ox', or 'auto'
Config.TargetSystem = 'qb'    -- 'qb', 'ox', or 'auto'

📡 Radar detector

Police models, range, beep tiers, keybinds, and sounds.

Config.PoliceVehicleModels = { 'police', 'police2', 'sheriff', ... }

Config.Detection = {
    Range = 120.0,
    BeepIntervals = {
        { distance = 20.0, interval = 350 },
        { distance = 45.0, interval = 650 },
        ...
    }
}

Config.Keybinds = {
    AlertsToggle = 'SLASH',
    BlankPlateToggle = 'COMMA'
}

🪪 Blank plates

Item, ownership rules, target labels, and North Yankton plate index.

Config.BlankPlate = {
    Item = 'jamz_blank_plate_kit',
    NorthYanktonIndex = 5,
    AllowInstallWithoutVehicleOwnership = true,
    ReturnItemOnRemoval = true,
}

💡 Puddle & footwell lights

Per-vehicle door offsets, footwell coords, colours, and install times — huge tables ready to extend.

Config.VehicleDoorLights["ADDER"] = { Range = 2.0, doors = { [0] = { x, y, z }, ... } }
Config.VehicleFootwellLights["ADDER"] = { [1] = driverOffset, [2] = passengerOffset }
Config.PuddleLightItems["puddle_blue"] = { label = "Blue Puddle Light", colour = "blue" }

📱 Phone holders

Vehicles, extra IDs, prop offsets, and radio → texture mapping.

Config.PhoneHolder = {
    Item = 'jamz_phone_holder',
    PropModel = 'phone_jmz',
    RadioStationTextures = {
        ["RADIO_03_HIPHOP_NEW"] = "phone_jmz_radiolossantos",
        ...
    }
}

Config.VehicleExtras["tailgater2"] = {
    extras = { 2 },
    extraOffsets = {
        [2] = {
            Offset = vector3(...),
            Rotation = vector3(...)
        }
    }
}

📦 Storage (seats & door panels)

Stash sizes, keybind, class filters, and smuggling tool.

Config.VehicleStash = {
    Enabled = true,
    Keybind = 'PERIOD',
    Stash = { Slots = 4, MaxWeight = 50000 },
    RequireVehicleOwnership = false,
}

Config.VehicleDoorStash = {
    Item = 'jamz_door_panel_tool',
    Stash = { Slots = 2, MaxWeight = 75000 },
    TrunkStash = { Slots = 5, MaxWeight = 120000 },
}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛠️ Dependencies

Install and start these before JamzVehicleExtras in server.cfg.

🧩 Required

📚 ox_lib — menus, progress, callbacks, notifications
🗄️ oxmysql — persistence (7 SQL tables included)
🔊 XSound — radar beeps & blank-plate SFX

⚙️ Framework (pick one)

✅ QB-Core / Qbox (qb-core)
✅ Qbox
✅ ESX (es_extended)

🎒 Inventory (pick one)

qb-inventory or ox_inventory (auto-detect supported)

🎯 Target (pick one)

qb-target or ox_target (auto-detect supported)

📦 Included with purchase

- Full config.lua with 165+ puddle profiles, 145+ footwell profiles, 50+ phone-holder vehicles
- HTML radar + plate UI, custom streamed phone & plate assets

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💸 PURCHASE

🛍️ Store: https://jamzscripts.tebex.io/
▶️ Demo Video: YouTube Preview

🚀 Outfit every car on your server — lights, gadgets, plates, and storage that actually slick.