Skip to main content

Installation

Prerequisites​

Before installing FR Dealership make sure your server has:

  • oxmysql starting before fr_dealership
  • ESX Legacy (es_extended) or QBCore (qb-core) — the script auto-detects them at runtime; no configuration needed

Steps​

1. Copy the folder​

Download the zip from fiverank.gg/recursos/fr-dealership and copy the fr_dealership folder into your server's resources directory:

resources/
└── fr_dealership/
    ├── client/
    ├── server/
    ├── html/
    ├── locales/
    ├── sql/
    ├── config.lua
    └── fxmanifest.lua

2. Add to server.cfg​

ensure fr_dealership

Make sure oxmysql and your framework start before fr_dealership.

3. Restart the server​

On first start the script automatically creates the tables fr_owned_vehicles, fr_vehicle_loans and fr_finance_bans. The console will print:

[fr_dealership] tables ready
[fr_dealership] Framework detected: ESX   (or QBCore)

If you don't see these messages, check the Troubleshooting section.

(Optional) Import SQL manually​

If you prefer to create the tables yourself before starting, import the included file:

mysql -u user -p database_name < resources/fr_dealership/sql/fr_dealership.sql

The script is idempotent — safe to run multiple times without duplicating data.

File structure​

fr_dealership/
├── client/
│   ├── framework.lua       ← ESX / QBCore bridge (client)
│   └── main.lua            ← NUI logic, showroom, garage, test drive
├── server/
│   ├── framework.lua       ← ESX / QBCore bridge (server)
│   ├── main.lua            ← purchase validation, garage, ownership
│   └── finance.lua         ← instalments, impounding and repossession
├── html/
│   ├── index.html          ← glassmorphism NUI
│   ├── style.css
│   └── script.js
├── locales/
│   ├── locale.lua          ← localisation system
│   ├── en.lua
│   └── es.lua
├── sql/
│   └── fr_dealership.sql   ← SQL script (tables + indices)
├── config.lua              ← all configuration here
└── fxmanifest.lua
Quick check

Join the server and walk to the showroom coordinates (-56.94, -1096.6, 26.42 by default). Press E — if the NUI opens, the script is working.