Realistic Vehicle Key System (ESX / QBCore / Ox Inventory)

An all-in-one vehicle key system featuring physical keys with metadata, smart remotes, realistic hotwiring, alarm upgrades, GPS tracking, and full Ox Inventory integration. Designed for serious roleplay and advanced vehicle security.

GG Vehicle Keys is a comprehensive system designed for roleplay servers that demand a realistic and modern vehicle experience, going far beyond simple lock/unlock commands.

🖥️ Every vehicle generates its own physical key with unique metadata (plate, lock code, model info). Players can:

- Store and trade physical keys in their inventory (Ox Inventory / ESX / QB).

- Use the key item directly as a remote for that specific car.

- Change vehicle locks if keys are lost or stolen (invalidating old keys).

- Install alarm upgrades for high-end security.

- Hotwire or hack vehicles when keys are unavailable.

For convenience, the script also offers a Universal Smart Remote ( car_remote ). Once registered, this single item allows players to control all their owned vehicles via a sleek, modern NUI menu.

📦 Built with a focus on:

- 🚀 Performance: Optimized code with minimal loops.

- 🚀 Integration: Seamless support for ESX, QBCore, and Ox Inventory.

- 🚀 Flexibility: Highly configurable features.

- 🚀 Developer Friendly: Easy debugging via Config.Debug .

- 🚀 Localization: Multi-language support (EN & MY included).

🔌 Key Features

🔥  Physical Keys with Full Metadata

  - Uses vehiclekey item with metadata for plate , lock , model , name , and registered status.

  - Configurable option to require physical keys for starting the engine.

  - Easily spawn keys via car dealers, jobs, or custom commands.

🔥  Smart Remote (NUI)

  - Universal Remote ( car_remote ): One device to control all owned vehicles.

  - Direct Key Access: Using a physical vehiclekey opens the remote locked to that specific car.

  - Remote Functions: Lock/Unlock, Engine Toggle, Door Control (all/individual), Alarm Toggle, GPS Tracker, and Roof/Hover control (for specific vehicles like Deluxo/Oppressor).

🔥  Advanced Lock & Security

  - Unique lock codes stored in the database.

  - Re-keying System: Changing a vehicle's lock generates a new code, rendering old keys useless.

  - Alarm Upgrades: Supports installation of high-end alarm systems via item usage.

🔥  Hotwire & Hacking System

  - Hotwire: Minigame-based engine starting for cars without keys.

  - Risks: Failed attempts can break lockpicks, cause electric shocks, or trigger alarms.

  - High-End Hacking: Support for thermal_hacking and hackerdevice items to bypass advanced security (configurable).

🔥  Temporary Keys & Job Support

  - Full support for temporary keys (perfect for job vehicles, rentals, or mission cars).

  - Players can use vehicles without needing full database ownership.

🔥  GPS & Police Integration

  - GPS tracking system for stolen or lost vehicles.

  - Police Alerts: Configurable blips ( PoliceVehicleBlipTime ) and alerts when hotwiring or hacking occurs.

  - Customizable alert chances based on day/night cycles.

🔥  Inventory & Framework Deep Integration

  - Ox Inventory: Full metadata support, ox_inventory:usedItem hooks, and displayed plate numbers on items.

  - ESX & QBCore: Pre-configured bridges ( bridge/esx , bridge/qb ) included.

  - Uses native notifications and callbacks.

🔥  Quality of Life

  - Configurable HUD: Move the engine/lock HUD to fit your server's UI ( Config.HudStartPosition ).

  - StartAssist Camera: Cinematic camera effect when toggling the engine.

  - Debug Mode: A global Config.Debug flag to easily hide/show all debug prints during development or production.

⚙️ Requirements

- FXServer (Latest Artifacts recommended)

- Framework: ESX Legacy OR QBCore

- Database: OxMySQL

- Inventory: Ox Inventory (Highly Recommended for full metadata features) / ESX Default / QB Inventory

⚙️ Config Highlights

- Config.UsePhysicalKeys – Enforce physical key requirement for engine start.

- Config.PhysicalKeysItem / Config.RemoteItem – Customizable item names.

- Config.HotwireChance – Adjust difficulty and success rates.

- Config.HighEndItem / Config.HackerDeviceItem – Define items for advanced thefts.

- Config.PoliceAlert / Config.PoliceJobs – Customize police integration.

- Config.Debug – Toggle all script logging with one boolean.

If you are looking for one script that covers physical keys, modern remotes, realistic hotwiring, security upgrades, and temporary keys—without needing to mash together 3 or 4 different resources— GG Vehicle Keys is your "drop-in" solution.

The heavy logic is already handled. Simply integrate with your car dealer or job scripts using the provided exports and events.

🔒 Asset Escrow Protected: Securely delivered via FiveM Keymaster.