nc-vehiclekeys — Physical Vehicle Keys, Theft & Security System

Real vehicle keys, real theft mechanics — not a lock toggle.

A complete vehicle key system for FiveM built around real theft mechanics instead of a simple lock toggle. Keys are physical inventory items carrying plate, key type, and lock code metadata. Stealing a car means carjacking the driver, lockpicking the door, hotwiring the ignition, smashing the window, or looting the keys off a dead body — each with its own minigame and a 4-tier vehicle security system that makes higher-end vehicles genuinely harder to steal.

Physical Key Items

• ✅ Keys are real inventory items carrying plate, key type, and lock code metadata 
• ✅ Plate shown directly in the item label 
• ✅ 5 key types — Standard, Sedan, Sports, Premium, SUV/Truck — auto-assigned per vehicle model

NPC Carjacking

• ✅ Hold a driver at gunpoint for a weighted outcome: surrender & flee, refuse & flee, or fight back 
• ✅ Loot keys from dead bodies with a randomized search timer

Lockpicking

• ✅ Minigame-driven, gated by the vehicle's security level 
• ✅ Chance to break your lockpick on failure

Hotwiring

• ✅ Minigame-driven ignition bypass with its own success chance and cooldown

Smash Window Minigame

• ✅ Button-mash style minigame with looping smash animation 
• ✅ Scales in difficulty with vehicle security

4-Tier Security System

• ✅ Upgrade a vehicle through 3 additional security levels via an NPC 
• ✅ Each level raises the difficulty of every theft method

Key Management

• ✅ Reset Keys — invalidate every key in existence for a vehicle and issue a fresh one 
• ✅ Temporary Keys — non-transferable keys for rentals, job vehicles, or admin spawns 
• ✅ Master Key — admin-only key that bypasses the lock system entirely 
• ✅ Stolen Key Auto-Cleanup — keys from stealing NPC vehicles are tagged and wiped on restart

Random Lock States

• ✅ Parked and NPC vehicles are randomly locked for realism

Police Dispatch Integration

• ✅ Lockpicking, hotwiring, smashing, and carjacking can all trigger a configurable police alert

Engine Immobilizer

• ✅ Vehicles cannot be driven without a verified key, temp key, master key, or successful hotwire 
• ✅ Enforced on a tight loop that can't be bypassed by auto-engine-start

Full Adapter Architecture

• ✅ Minigames, dispatch, targeting, inventory, and framework are all abstracted behind swappable adapters 
• ✅ Change one line in the config, no core code touched

qb-vehiclekeys Drop-In Compatibility

• ✅ Legacy events and exports continue to work if you're migrating from qb-vehiclekeys

Commands & Keybinds

QBCore · QBox · ESX — auto-detected, just drop it in and it works.

https://youtu.be/JZKrSNA79nM

• ox_lib
• oxmysql
• QBCore, QBox, or ESX (auto-detected)
• ox_target or qb-target (required)
• t3_lockpick — default lockpicking minigame (swappable)
• mgc — default hotwire & smash minigame (swappable)
• ps-dispatch — optional, for police alerts

Delivery & Setup

This product is delivered automatically via Tebex/Keymaster immediately after purchase. Full installation and configuration documentation: https://docs.noxcore.me/nc-vehiclekeys

Quick setup:

1. Download from store.noxcore.me

2. Place nc-vehiclekeys in your server's resources folder

3. Run the included database.sql

4. Configure items in your inventory (see ITEM_INSTALL/README.txt)

5. Add ensure nc-vehiclekeys to server.cfg after ox_lib, oxmysql, your framework, and target system

6. Start the server — automatically stops conflicting key systems (qb-vehiclekeys, qbx_vehiclekeys)

Support

Discord: https://noxcore.me/discord Response time: KST 13:00–22:00

License Terms

• Licensed for use on one server per purchase (unless multi-server license purchased)

• Resale or redistribution of source files is prohibited

• Digital product — see refund policy: https://store.noxcore.me/Policy