Description

ns_VehicleKeys

Keys that actually mean something.

Most key scripts answer one question: do you have the key, yes or no. This one models the thing itself — every vehicle has a VIN, every key is cut against a lock revision, and changing the lock at a locksmith kills every other copy in the world at the same instant.

Lend your car to someone and want them out of it? Buy new keys. Their key is now a piece of metal.

The lock revision system

This is what separates it from every other key script on the market.

Each vehicle carries a lock revision number
Each issued key stores the revision it was cut against
A key only works while those numbers match
Rekeying increments the vehicle and reissues to the owner alone

Nothing has to hunt down old keys. Shared keys, stolen copies, an ex-partner's spare — they all stop matching at once. It's how a real locksmith works, and it gives your players a reason to care about who they hand keys to.

Realistic key ownership

VIN assigned per vehicle, derived from plate and model
Key items with full metadata — plate, VIN, revision, expiry
Backup keys, lost key replacement and lock changes at a locksmith NPC
Share keys with any nearby player, revoke them individually
Optional key expiry with advance warning
Motorcycles can't be locked, bicycles need no key at all

Ignition

Engine won't crank without the key
Insert and remove key animations
Push-to-start on supercars, no key turn needed
Hotwiring with a four-stage skill check
Broken ignition — badly damaged engines refuse to start
A hotwired car can't be locked or switched off until a real key shows up

Theft

Lockpicking with a skill check, breakable picks, separate advanced tier
Failed attempts sound the alarm and page dispatch
Alarm bypass tool with a failure chance
Police alerts through eight dispatch systems

Alarm

Horn and hazards on a configurable timer
Triggers on a broken window
Triggers if the car moves with no fob nearby
Cancel remotely from the fob

Keyless and passive

Unlock as you approach, lock as you walk away
Relocks itself if you never opened a door
Remote fob battery that drains and needs replacing
Every behaviour toggleable, per-model exclusions

Police and tow

Department vehicles openable by on-duty officers
Seize a suspect's keys
Registration lookup — owner, VIN, keys issued, lock revision
Tow operators get expiring temporary access
Abandoned vehicle and impound support

The key fob

The interface is the fob itself, not a command list. Press a key and it comes out on screen — click its buttons to lock, unlock, pop the boot or sound the alarm. No menu, no overlay.

Works with what you already run

Everything auto-detects. Install it and it finds your stack.

Frameworks

qb-core · qbx_core · es_extended · vRP

Notifications

ox_lib · esx_notify · okokNotify · pNotify · mythic_notify · rtx_notify · brutal_notify · origen_notify · wasabi_notify · qb

Targets

ox_target · qb-target · qtarget

Dispatch

ps-dispatch · qs-dispatch · rcore_dispatch · codem-dispatch · cd_dispatch · cd_dispatch3d · tk_dispatch · fd_dispatch

Inventories

ox_inventory · qb-inventory · qs-inventory · core_inventory · codem-inventory · esx

Your old key resource is force-stopped automatically — qb-vehiclekeys, qbx_vehiclekeys, qs-vehiclekeys, MrNewbVehicleKeys, Renewed-Vehiclekeys, p_vehiclekeys, mk_vehiclekeys and both ak47 versions.

For developers

Full client and server exports for garages, dealerships and job scripts
ox_lib callbacks for key checks and vehicle data
Custom documentation page included, not a README dump
Database tables created automatically on first start

exports['ns_VehicleKeys']:GiveKeys(src, plate, model)
exports['ns_VehicleKeys']:HasKeys(src, plate, model)
exports['ns_VehicleKeys']:ChangeVehicleLock(plate, model, keepIdentifier)

Languages

English · Spanish · Portuguese · Brazilian Portuguese · French · German · Turkish · Polish · Hungarian · Chinese

All ten complete. Copy a file to add your own — missing keys fall back to English, so partial translations are safe.

Open source

config.lua and all ten locale files are fully editable. Every price, range, timer, animation, blacklist and keybind is yours to change. HTML and CSS for the fob are open too, so you can restyle or resize it.