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 /dealership subcommands — no config editing for world setup.
  • Optional credit-based financing - Connect oxide-banking to drive interest rates from a player's credit score and invoice missed payments.

Requirements

ResourceRequiredPurpose
ox_libYesLocale, zones, callbacks, and vehicle helpers
oxmysqlYesDatabase persistence
o-linkYesFramework bridge — character, job, money, inventory, vehicles, notify, target, and phone abstraction
oxide-bankingNoCredit-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:

server.cfg
ensure ox_lib
ensure oxmysql
ensure o-link
ensure oxide-banking      # optional — credit-based finance rates
ensure oxide-dealerships

Import 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