[Preview Video]

This script protected escrow system

[Discord]

[Docs]

izzy-dealership — Dealership & Gallery System for FiveM

📦 Overview

* Full vehicle dealership on your server — showroom, sales, stock, and employee panel

* Works with ESX and QBCore (Config.Framework — auto)

* Database: insertme.sql — dealerships, vehicles, stock, sales, orders, coupons

* Ready galleries in config: pdm, galeri (cars + bikes)

* Dealership blips on the map (Config.DealershipsBlip)

👤 Profile area (management & admin menu)

* Your in-game character photo (mugshot) in the top corner

* Dealership name and logo beside it — your gallery’s identity

* In the customer showroom: dealership logo + name (branding, not your personal avatar)

🚗 Customer showroom

* Green marker — showroom spot (Config.Markers.Showroom)

* Vehicles by category — only in-stock items are listed

* Search and filter (A–Z, price, newest/oldest)

* Arrow through the list, 3D preview of each car

* Right-click — rotate the camera (Right Click hint)

* Pick a color — preset palette (Config.DefaultColors) + custom hex picker

* Live performance bars — speed, power, brakes, handling, and related stats

* Discount badge when the dealership has an active sale

🛒 Buying a vehicle

* Purchase — cash or bank (you choose payment method)

* Enter a coupon code for a percentage off

* Out of stock = vehicle drops off the list

* Plate format from server config (Config.PlateFormat — e.g. 1AA111AA)

* Keys: qb-vehiclekeys or Renewed-Vehiclekeys when installed

🏁 Test drive (Config.TestDrive)

* If enabled: test drive — 60 seconds, 1000 m range

* Test plate: TESTCAR

* Ends when time runs out or press E

* Menu closes during the test; countdown on screen

👮 Job garages (Config.JobDealerships)

* No SQL / management / stock — config list only

* Example: police_garage — police job only, fixed vehicles and prices

* No full dealership owner panel on job garages

💼 Dealership management (red marker — Management)

* Menu tabs depend on your rank (Config.EmployeeRanks):

  * Dashboard — balance, deposit / withdraw (if allowed), recent sales, quick links

  * Vehicles — stock, price, edit, place orders (Config.OrderWaitTime — default 30 s wait)

  * Orders — pending stock orders

  * Sales — who bought what, search and filters

  * Categories — add / edit / remove

  * Employees — invite, rank, salary (Config.DefaultSalary, salary every Config.SalaryTime minutes)

  * Discount — % off whole dealership or selected vehicles

  * Coupon codes — create codes, expiry, specific vehicles, edit / delete

  * Settings — dealership name, logo URL, blip color

  * Display — showcase vehicles (if you have display permission)

* Default ranks:

  * Manager — vehicles, orders, deposit, sales, edit, discount, categories, dashboard

  * Staff — sales + dashboard

* Ownership transfer — hand the dealership to a nearby player (admin permission required per locale)

🛠️ Admin panel (Config.AdminCommand — dealeradmin)

* Your mugshot + admin header

* Global vehicle database — add, edit, assign categories

* Dealership list — create dealerships, assign to players (giveDealership)

* Config.EditButton — hide or show edit buttons

🌍 Languages

* Config.Locale — en, tr, pr, fr, de (5 languages in shared/locales.lua)

* UI and notifications follow the language you pick

⚙️ Server settings (config summary)

* Config.MoneyType — default payment type (cash / bank)

* Config.DefaultProfitMargin — default profit margin 10%

* Config.Distance — marker distance 2.0

* Config.drawtextorfloating — 3D text or floating text at markers

* Vehicle types: car, bike, helicopter, boat, airplane

* Hundreds of pre-filled vehicles in insertme.sql

🛠️ Setup (server owners)

* Import insertme.sql → ensure izzy-dealership

* shared/config.lua — gallery coords, job garages, ranks

* functions/ and shared/ editable outside escrow

* MySQL: mysql-async, oxmysql, or ghmattimysql