**The complete dealership experience for your server.**

Showroom with 3D preview, a business mode with real employees, signed purchase contracts, stock & truck deliveries, financing, trade-ins and a full seller tablet. Built for ESX & QBCore.

---

## ✨ Showroom

- Modern catalog with categories, search and live vehicle stats (top speed, acceleration, braking, traction, seats)

- **3D preview** with orbit camera – drag to rotate, scroll to zoom

- Live primary & secondary color selection

- **Test drives** – free or paid, time limit, max radius, auto-return

- Custom plates for a fee

- Pay with **cash, bank, credit card or financing**

- **Promotions** with "-10%" badges and strike-through prices

- Customers can **book appointments** (test drive or consultation)

- Optional driver's license check

## 🏢 Business Mode

- Employees sell through **purchase contracts** – the customer reviews and **signs with the mouse**

- **Commission per grade**, the rest goes to the business account

- Self-service when no seller is online (always / only offline / never) with markup

- **Stock system** with new and used vehicles

- **Showroom display vehicles** placed in-game with name & price

- **Order from the importer** – 3 delivery modes:

- 🚛 **Realistic:** drive a truck + trailer loaded with the ordered cars to the dealership

- ⏱️ **Semi:** delivered after a waiting time

- ⚡ **Instant**

## 📱 Seller Tablet (usable item)

- Overview with revenue, stats and 7-day chart

- Contracts, stock & displays, orders, sales history with VIN & signature

- **Customer file** – purchases, financing, appointments, notes & regular-customer discount

- **Appointments** – accept, complete or cancel customer bookings

- **Trade-in** – take the customer's old car as part payment, it becomes a used car

- **Seller ranking** – employee of the month & monthly sales goal with automatic bonus

- **Plate lookup** – owner, VIN, purchase history, financing and location

- **Advertising** – send an ad to all players (paid, with cooldown)

- Tablet prop animation, works anywhere while on duty (configurable)

## 👔 Boss Menu

- Business account with deposit & withdraw

- Commission per grade, sales goal & bonus

- Hire, promote, fire (also offline), pay bonuses

- Adjust prices within limits

- **Promotions** for all vehicles, a category or a single model

- Toggle self-service, test drives, financing and buyback

- Activity log

## 💳 Financing

- Plans with down payment, interest and number of installments

- Installments are charged automatically from the bank account

- Missed payments: reminder → **vehicle locked** → **impounded**

- Pay installments or pay off early with `/finanzierung`

- Locate vehicles with overdue payments

## 🔁 Buyback

- Sell your own car to the dealership – offer based on list price & condition

- No buyback while financing is open

- Bought cars become used stock

## ⚙️ Setup & Integration

- **In-game setup** with `/dealeradmin` – create dealerships, set all points, display slots and settings

- Multiple dealerships (cars, bikes, boats, aircraft) with their own catalog

- **Vehicles loaded from the database** (ESX `vehicles` table / QBCore shared vehicles) or config – reload live with `/dealerreload`

- Admin access via identifiers (no ACE needed)

- Database tables are created automatically

- Discord webhook logs

- Clean dark UI (ox_lib style), German locale included, easy to translate

**Works perfectly with:**

- **CY Garages** – bought cars go straight into the garage, financing locks & impounds

- **CY Banking Pro** – bank & credit card payments, business accounts, treasury

---

## 📦 Requirements

- ESX Legacy **or** QBCore

- ox_lib

- oxmysql

**Optional:** cy-garages, cy-banking, ox_inventory

## 🔒 Info

- Escrow protected – `config.lua` is fully editable

- Free updates

- Support via Discord