VehiclesMajor rebuild

drs_vehicleshop

From browsing to keys, with a safer checkout.

Lets players browse, test drive, customize, and buy cars, boats, or aircraft on Qbox and QB-Core servers. They can drive away or send the vehicle to a garage, and interrupted purchases can be recovered.

QboxQBCoreAlso works with 5 other systems

Download latest code This is the latest code from GitHub, not a packaged release. Test it before using it on a live server.

Setup guide

Source code Report a problem

Version: 1.0.1-drs.8
Updated: Aug 30, 2026
License: MIT
Code access: Open-source code
Status: Stable

Sections9 sections

Resource previewRoad catalog

1 of 6

screenshotRoad catalog

Search, sorting, brands, and ordered categories organize large road inventories.

01 / OVERVIEW

What it does

Type: Multi-shop vehicle sales system
Best for: Qbox or QBCore road, marine, and aviation dealerships
Delivery: Drive away or send the purchase to a garage

drs_vehicleshop turns the original QR Vehicle Shop into a safer sales system for car, boat, and aircraft dealerships. Players can search the catalog, test drive allowed models, choose paint and registration options, then drive away or send the purchase to a garage.

The server, not the player's game, decides the price, who can buy, the plate, and where the vehicle goes. Each purchase step is saved. If a player disconnects, the server restarts, or the spawn point is blocked, the vehicle can be recovered in storage instead of being lost.

02 / HOW IT WORKS

From choosing a vehicle to getting the keys

01
Browse a shop
Search a car, boat, or aircraft catalog with the categories, access rules, stock, and prices set by the server owner.
02
Choose the options
Pick an allowed paint, registration, and delivery method. The server checks the choices and gives the player a short-lived final price.
03
Record the purchase
The script saves the plate, payment, ownership, garage, and delivery progress one step at a time.
04
Deliver or recover the vehicle
The server creates the purchased vehicle. If delivery fails or is interrupted, the vehicle returns safely to storage.

03 / FEATURES

Core features

Checkout controlled by the server

Server settings decide prices, buyer access, plates, options, garages, and delivery. The player's game cannot choose its own total or vehicle details.

Vehicle delivery that can recover

Saved orders and server-created vehicles protect a purchase if the spawn is blocked, another script fails, a player disconnects, or the server restarts.

Configurable factory options

Offer allowed paints, registration prefixes, plate styles, test drives, and drive-away or direct-to-garage delivery in one checkout.

Personal and job-fleet sales

Run normal player dealerships and a Qbox job-fleet service that checks the job, boss access, rank, bank account, catalog, and garage.

What changed in this edition

Prices checked by the server

The player's game sends its choices, not a price it can control. The server checks the complete order again before taking payment.

Purchases can recover after a problem

Recovery records protect personal and job-fleet purchases if payment, ownership, vehicle creation, or garage delivery is interrupted.

Factory checkout

Allowed paints, plate prefixes and styles, and drive-away or garage delivery can each have their own prices and restrictions.

Job-fleet purchases

Approved Qbox server scripts can buy job-owned vehicles through DRS Garages and supported banking systems without creating duplicates when a request is repeated.

More features7 more items

Road, boat, and aircraft storefronts
Search, sorting, ordered categories, and vehicle pictures that load as needed
Server-managed timed test drives
Police-restricted emergency catalog
Included pictures for add-on vehicles, with official Cfx pictures used when needed
Automatic upgrade of older QR purchase records
One-use delivery confirmation and recovery after restarts

04 / SETUP OPTIONS

What you can change

These are the main parts you can adjust for your server. The setup guide lists every option and example.

Server framework, interaction, keys, and garage systems
Dealership locations, staff characters, map markers, categories, and catalogs
Paints, plate prefixes, plate styles, and checkout fees
Drive-away and direct-to-garage delivery
How long prices remain valid, cooldowns, and delivery time limits
Test-drive boundaries and cleanup
Category access rules
Job-fleet catalogs, approved calling scripts, ranks, and banking system
Vanilla and add-on vehicle imagery

See every setup option

05 / REQUIREMENTS

What it works with

Server framework: QboxQBCore
Required: ox_lib, oxmysql, and OneSync
Interaction: ox_target or qb-target
Garage: drs_garages preferred; older lunar_garage support available
Resource name: Must remain drs_vehicleshop

See all requirements and setup options

Technical details3 details

Runtime: FiveM Lua with OneSync
Interface: HTML, CSS, and JavaScript NUI
Database: oxmysql with player_vehicles and DRS recovery records

06 / LIMITATIONS

Known limitations

There is no packaged GitHub release yet. Save the exact tested code version used by your server instead of automatically following future changes.
Job-fleet checkout is built for Qbox and requires DRS Garages plus a supported job-account system. It refuses the purchase if it cannot complete an ownership or service check.
Some configured add-on models still require authentic local renders and intentionally show the styled unavailable-image state when no verified image exists.

07 / ORIGINAL PROJECT

Changes from the original

Original projectQRDevelopment qr-vehicleshop

Base version1.0.0

This edition keeps the original shop interface but rebuilds how purchases, delivery, recovery, database upgrades, and garage connections work.

Differences between QRDevelopment qr-vehicleshop and this drs_Dev edition
Area	Original	drs_Dev edition
Name	qr-vehicleshop	drs_vehicleshop, with one old open-shop event kept for compatibility
Purchases	Original client and server checkout	Short-lived prices checked again by the server before payment
Delivery	Player's game creates and receives the vehicle	Server creates the vehicle, confirms delivery once, and falls back to the garage
Recovery	No record covering the complete purchase	Personal and job-fleet recovery records survive restarts and flag orders that need review
Checkout	Base vehicle selection	Factory paint, registration, delivery options, access rules, and fleet checkout

08 / INSTALLATION

Ready to install?

Open the setup guide

The guide covers requirements, installation, server setup, connections to other resources, and troubleshooting.

Read the installation guide

09 / VERSION & SOURCE CODE

Version and source code

Latest version

v1.0.1-drs.8Repository snapshot · Aug 2026

Rebuilt checkout around prices checked by the server, purchase recovery, and vehicles created by the server.
Added factory options, direct-to-garage delivery, DRS Garages support, job-fleet checkout, and automatic upgrades for old QR purchase records.
Added the police-restricted emergency catalog and expanded the included vehicle pictures.

View change history

Credits and license

Project type: Major rebuild
Maintainer: DrSnyder
License: MIT
Code access: Open-source code
Original project: QRDevelopment qr-vehicleshop

DRS-maintained rework of QRDevelopment/qr-vehicleshop. Original RaySist and QR Development attribution and the MIT license are retained in the public repository.

View source code on GitHub