Introduction

ars_cardealer is an escrow-safe FiveM vehicle dealership resource with a Preact NUI frontend. It runs on QBCore, QBox, and ESX behind a unified Bridge interface, and is powered by ox_lib and oxmysql. The resource supports business ownership, financing with APR plans, test drives (self and assisted), employee commissions, trade-ins, sell-to-dealer, vehicle transfers, and a full in-game admin creator panel.

Features

Core Features

• Multi-framework — QBCore, QBox, and ESX behind one Bridge global. Auto-detected or pinned in config.lua.
• DB-backed catalog — vehicles live in ars_cardealer_vehicles, editable in-game, importable from the active framework via Bridge.GetVehicles().
• Browse + selective import — preview the framework’s vehicle catalog by category, then import a subset and assign to a dealership in one click.
• Per-shop admin overrides — each shop can override purchase, test-drive, financing, colour mode, currency, and delivery mode independently.
• Business ownership — players buy and run dealerships with balance, transactions, employees, roles, commission, and coupons.
• Financing — APR plans with down payment, scheduled play-time-based payments, grace periods, and repossession.
• Test drives — routing-bucket isolation, optional deposit, auto-expiry sweep, cooldown, and distance cap.
• Delivery trucking — instant, auto (delayed), and trucking (drive the truck yourself) restock modes per shop.
• Employee-led direct sales — sell to nearby customers with per-role commission payouts.
• Trade-ins and sell-to-dealer — trade-in credit against purchases; outright sale of owned vehicles for bank payout.
• P2P vehicle transfer — hand ownership to a nearby player with recipient consent.
• Purchase contracts — OKOK-style signed agreement with name matching and offer expiry.
• Image capture — in-game studio screenshot with green-screen removal for catalog vehicle images.
• ox_lib powered — locales, callbacks, notifications, zones, and target integration.
• Escrow-safe — no require(). Buyer-editable files are isolated in escrow_ignore.

Integrations

• Frameworks: QBCore (qb-core), QBox (qbx_core), ESX (es_extended)
• Dependencies: oxmysql, ox_lib, screenshot-basic
• Target systems: ox_target, qb-target, qtarget (auto-detected or pinned)
• Third-party hooks: okokContract, qb-vehiclesales, Discord webhooks
• Key systems: qb-vehiclekeys, wasabi_carlock, qs-vehiclekeys, okokGarage, t1ger_keys, Renewed-Vehiclekeys, MrNewbVehicleKeys, MojiaVehicleKeys, sna-vehiclekeys, ars_vehiclekeys

Requirements

• oxmysql — database layer
• ox_lib — UI library, callbacks, locales
• screenshot-basic — vehicle image capture feature
• A supported framework — qb-core, qbx_core, or es_extended
• A supported target resource — ox_target, qb-target, or qtarget (required; the catalog opens only by targeting the salesman ped)
• NUI is pre-built — no build tools or Node.js required on the server

Commands

Player Commands

Command	Description
/myfinance	Open your vehicle financing and active loans from anywhere
/transfervehicle	Transfer ownership of an owned vehicle to a nearby player
Target the salesman ped	Browse and purchase vehicles at a dealership

Admin Commands

Command	Description
/arscardealer	Open the admin shop control panel
/readjustdisplay	Reposition the nearest dealership display vehicle

Database Tables

The schema is applied automatically on resource start by server/boot.lua using idempotent CREATE TABLE IF NOT EXISTS statements. No manual SQL import is needed on a fresh database (upgrades from older builds require a re-import — see Installation).

Core Tables

Table	Purpose
ars_cardealer_shops	Dealership definitions (zones, blips, displays, per-shop overrides, employee roster)
ars_cardealer_vehicles	Global vehicle catalog (label, category, price, stock, stats, images)
ars_cardealer_shop_stock	Per-shop inventory — one row per (dealer, model) with retail price and stock
ars_cardealer_shop_ownership	Player ownership of ownable dealerships (balance, open state)
ars_cardealer_transactions	Full audit log of every sale (payments, financing, trade-ins, attribution)
ars_cardealer_financing	Active vehicle loans (principal, payments, status, delinquency timeline)
ars_cardealer_coupons	Discount coupon codes (single-use, multi-use, expiring)
ars_cardealer_coupon_uses	Per-player coupon redemption tracking
ars_cardealer_used_stock	Used vehicles acquired via trade-in, resold at the dealership
ars_cardealer_deliveries	Stock restock orders (instant, auto, trucking status tracking)
ars_cardealer_audit_log	Privileged action log (hires, funds, edits, ownership changes)
ars_cardealer_commissions	Per-role employee commission ledger
ars_cardealer_settings	Admin-editable live settings (overrides config.lua defaults)

---

Note: This guide is written by a third party. If you find any incorrect or outdated information, please contact us on Discord so we can update it for you.