VehiclesRework

drs_vehicleshop

A trusted purchase path from catalogue to keys.

A DRS-maintained multi-shop vehicle seller for Qbox and QBCore with server-authoritative quotes, durable purchase recovery, factory checkout options, and garage-aware delivery.

QboxQBCore+5 integrations

Download Current main branch snapshot, not a tagged release package

Documentation

GitHub Issues

Version: 1.0.1-drs.8
Updated: Aug 30, 2026
License: MIT
Source: Open source
Readiness: Stable

Resource previewFactory checkout

1 / 6

screenshotFactory checkout

The road catalogue keeps inventory visible while paint, registration, and delivery choices are configured in one checkout panel.

On this page10 sections

01 / OVERVIEW

What it does

Type: Multi-shop vehicle sales system
Best for: Qbox or QBCore road, marine, and aviation dealerships
Delivery: Server-created handoff or direct-to-garage staging

drs_vehicleshop reworks the QR Vehicle Shop foundation into a server-authoritative sales system for road, marine, and aviation dealerships. Players can browse searchable catalogues, test drive configured models, choose factory paint and registration options, and select drive-away or garage delivery when the shop supports it.

The server resolves prices, access rules, plates, options, garages, and delivery locations from trusted configuration. Purchases are journaled from plate reservation through payment, ownership, entity creation, keys, and final handoff so blocked spawns, disconnects, restarts, and incomplete delivery acknowledgements converge to a recoverable stored vehicle.

02 / HOW IT WORKS

From catalogue to durable ownership

01
Browse a configured shop
Search a road, marine, or aviation catalogue with server-controlled categories, access rules, inventory, and pricing.
02
Configure and quote
Choose allowed paint, registration, and delivery options; the server returns a short-lived quote resolved from trusted configuration.
03
Journal the purchase
A unique plate, payment, ownership row, garage registration, and delivery state are recorded through a durable order workflow.
04
Deliver or recover
The server creates the exact vehicle and issues a one-use handoff; failed or interrupted deliveries return safely to stored state.

03 / WHAT CHANGED

What changed in this edition

Authoritative quote and purchase flow

Clients submit option identifiers rather than trusted totals or vehicle properties; the server revalidates the full quote before payment.

Durable delivery recovery

Personal purchase, plate-reservation, and society-fleet journals protect interrupted payments, ownership writes, entity creation, and garage handoff.

Factory checkout

Curated paints, plate prefixes and styles, and drive-away or garage delivery can be priced and restricted independently.

DRS fleet bridge

An allowlisted Qbox-first server API supports idempotent society purchases through DRS Garages and supported banking providers.

04 / FEATURES

Core features

Server-authoritative checkout

Trusted configuration determines pricing, eligibility, plates, options, garages, and delivery while short-lived quotes prevent client-authored totals or properties.

Recoverable vehicle delivery

Journaled orders and server-created vehicles protect ownership through blocked spawns, failed integrations, disconnects, restarts, and handoff timeouts.

Configurable factory options

Offer curated paint, registration prefixes, plate styles, test drives, and drive-away or direct-to-garage delivery from one checkout flow.

Personal and society sales

Run ordinary player dealerships and an allowlisted Qbox society fleet service with job, boss, grade, banking, catalogue, and garage validation.

Additional capabilities7 supporting features

Road, boat, and aircraft storefronts
Search, sorting, category ordering, and lazy-loaded vehicle artwork
Server-managed timed test drives
Police-restricted emergency catalogue
Bundled add-on imagery with official Cfx render fallback
Automatic QR journal identity migration
One-use delivery acknowledgements and restart reconciliation

05 / CONFIGURATION

Configurable systems

The resource exposes these major systems for server-specific setup. Exact options and examples remain in the technical documentation.

Framework, target, keys, and garage providers
Dealership locations, peds, blips, categories, and catalogues
Paints, plate prefixes, plate styles, and checkout fees
Drive-away and direct-to-garage delivery
Quote lifetime, cooldowns, and handoff timeouts
Test-drive geofencing and cleanup
Category access rules
Society fleet catalogues, callers, grades, and banking provider
Vanilla and add-on vehicle imagery

View configuration documentation

06 / COMPATIBILITY

Compatibility at a glance

Framework: QboxQBCore
Required: ox_lib, oxmysql, and OneSync
Interaction: ox_target or qb-target
Garage: drs_garages preferred; lunar_garage legacy fallback
Resource name: Must remain drs_vehicleshop

Full compatibility and configuration

Technical details3 implementation facts

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

07 / LIMITATIONS

Known limitations

The public repository currently has no tagged GitHub release; pin the tested main-branch commit used by your server.
Society fleet checkout is Qbox-first and requires DRS Garages plus a supported society banking provider; it fails closed when any authority or service check is unavailable.
Some configured add-on models still require authentic local renders and intentionally show the styled unavailable-image state when no verified image exists.

08 / UPSTREAM

Differences from upstream

Upstream projectQRDevelopment qr-vehicleshop

Base version1.0.0

The DRS edition retains the credited storefront foundation while replacing the purchase, delivery, recovery, database-migration, and integration paths.

Differences between QRDevelopment qr-vehicleshop and this maintained edition
Area	Upstream	drs_Dev edition
Identity	qr-vehicleshop namespace	drs_vehicleshop namespace with one legacy client open-shop alias
Purchases	Inherited client/server checkout	Short-lived authoritative quotes with complete server revalidation
Delivery	Client-oriented spawn and handoff	Server-created entity, one-use acknowledgement, and safe garage fallback
Recovery	No durable end-to-end order journal	Personal and society journals with restart reconciliation and review states
Checkout	Base vehicle selection	Factory paint, registration, delivery options, access rules, and fleet checkout

09 / INSTALLATION

Ready to install?

Continue in documentation

Requirements, installation, framework configuration, integration setup, and troubleshooting are covered in the documentation.

Read installation guide

10 / RELEASE & SOURCE

Release & Source

Current build

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

Reworked checkout around server-authoritative quotes, durable purchase recovery, and server-created delivery.
Added factory options, direct-to-garage staging, DRS Garages integration, society fleet checkout, and automatic QR journal migration.
Added the police-restricted emergency catalogue and expanded bundled vehicle imagery.

View repository history

Provenance

Origin: Rework
Maintainer: DrSnyder
License: MIT
Source: Open source
Upstream: 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 maintained source