Oxide Dealerships
Database-driven vehicle dealership system with a 3D catalog, test drives, in-house financing, trade-ins, and player-owned lots for FiveM servers.
Oxide Dealerships is a complete vehicle dealership system for FiveM that replaces the legacy qb-vehicleshop / esx_vehicleshop flow. It is database-driven and runtime-configurable: dealerships, lot zones, greeters, showroom display cars, blips, test-drive spawns, accepted payment methods, and job restrictions are all set up from an in-game admin panel rather than from config files. Players browse a 3D catalog with a cinematic preview, take test drives, finance purchases with automatic bank payments and repossession on default, trade vehicles in, and can even buy and run dealerships themselves — hiring staff, ordering stock, setting prices, and closing in-person contract sales from a windowed management dashboard.
Four NPC dealerships (cars, boats, aircraft, and trucks) are seeded on install and ready to use out of the box.
Key Features
- Three dealership types - NPC-operated shops with unlimited catalog stock, player-owned shops with real inventory and profit, and for-sale plots players buy to become owners.
- 3D browsing catalog - Customers browse the lineup at a greeter, rotate each vehicle in a cinematic preview scene, and try preset paint colors before buying.
- Test drives - Timed test drives for cars, boats, planes, and helicopters, configured per dealership with automatic vehicle cleanup.
- Flexible payments - Cash, bank, or any custom currency a lot accepts — money accounts or inventory items such as a VIP token.
- In-house financing - Configurable down payment, term length, and interest; payments pull automatically from the bank, with missed-payment tracking and repossession on default. Players manage loans through
/myloans. - Trade-ins - Hand over an owned vehicle for instant value, taken as cash or applied toward a purchase. Traded and repossessed cars re-list on the used lot keeping their real plate.
- Management tablet - A windowed dashboard (
/managedealership) where owners and staff handle stock, pricing, employees, balance, sales, payment methods, and promotions. - Employees and commission - Managers and salespeople earn a commission cut on sales they close while on the lot, including in-person contract sales the buyer signs.
- Promo codes - Global or shop-scoped coupons with usage caps, expiry, and model or category restrictions.
- Showroom showcase - Display vehicles with optional turntable rotation and a hold-key stat card showing specs, price, and a finance teaser.
- In-game admin toolkit - A full admin dashboard (
/dealership admin) plus 19/dealershipsubcommands — no config editing for world setup. - Optional credit-based financing - Connect
oxide-bankingto drive interest rates from a player's credit score and invoice missed payments.
Requirements
| Resource | Required | Purpose |
|---|---|---|
ox_lib | Yes | Locale, zones, callbacks, and vehicle helpers |
oxmysql | Yes | Database persistence |
| o-link | Yes | Framework bridge — character, job, money, inventory, vehicles, notify, target, and phone abstraction |
oxide-banking | No | Credit-score-based finance rates and missed-payment invoicing |
Oxide Dealerships works on QBCore, QBX, and ESX through o-link with no framework-specific edits.
Quick Start
Place oxide-dealerships in your server's resources folder.
Build the interface: open the resource's web folder and run npm install followed by npm run build. This creates the web/dist folder the resource needs — skipping it is the number one cause of a blank catalog.
Start ox_lib, oxmysql, and o-link before oxide-dealerships in your server.cfg:
ensure ox_lib
ensure oxmysql
ensure o-link
ensure oxide-banking # optional — credit-based finance rates
ensure oxide-dealershipsImport sql/install.sql against your database. This creates seven tables and seeds four ready-to-use NPC dealerships.
Grant yourself admin so the /dealership commands work, then run /dealership list in game to confirm.
See the Installation Guide for the full setup flow.
World setup lives in the database
The config files set the rules of the game — finance terms, trade-in rates, payment methods. The actual dealerships in your world (lot zones, greeters, blips, spawn points, job restrictions) live in the database and are created and edited in-game with the admin dashboard and /dealership commands.
Documentation
Installation
Prerequisites, the web build step, database, and per-framework setup.
Configuration
Every setting in all eight config files.
Features
How every system works, from the catalog to financing.
Admin
The 19 /dealership commands and the admin dashboard.
Exports
Integration notes for developers.
Troubleshooting
Common issues and fixes.