JG Docs
Dealerships

Installation

DealershipsJG DealershipsPurchase on the JG store

Download & unzip

Unzip the jg-dealerships-bundle and open it - the folders inside are the resources for your server.

Add the resources to your server

Drag jg-dealerships into a new folder called [jg] within your server's resources folder.

If you don't plan on using our new default Text UI, jg-textui, you don't need to transfer it to your server. You can choose a different Text UI script in the config.

Update your server.cfg

In your server.cfg, add a new line after all your other resources have started:

ensure [jg]

You should probably disable qb-vehicleshop or esx_vehicleshop because there will be location clashes.

Migrating from v1?

If you're upgrading and want to keep all of your existing data, stop here and follow Migrating from v1 first.

Configure the script

Core options live in config/config.lua. Most are set to auto, so in some cases you may not need to edit this file at all - the important ones are Localisation, Framework & Integrations and Interaction Methods. Custom dealership categories are also added here, under Config.Categories.

Set Config.Debug = true while troubleshooting to print debug messages and draw dealership and interaction zones in-game. Set it back to false during normal use.

Locations and vehicles are managed entirely in-game - see Setting Up Locations and Adding Vehicles next.

Set up business banking

Config.UseFrameworkJobs = true is enabled by default. With it enabled, every dealership business needs a society bank account that matches its internal job name.

Follow Society Banking before staff use the business. The same page covers accounts used by Society Purchase.

JG Vehicle Keys

Use a Dealerships build with the native Vehicle Keys integration for purchase keys and temporary test-drive access.

Select the key system

Set this in jg-dealerships/config/config.lua:

jg-dealerships/config/config.lua
Config.VehicleKeys = "jg-vehiclekeys"

Set the start order

Start Vehicle Keys before Dealerships. Replace the earlier ensure [jg] line in server.cfg with these lines after your framework, inventory, ox_lib and oxmysql:

server.cfg
ensure jg-vehiclekeys
start [jg]

Restart and test

Fully restart your server. Buy a personal vehicle and a society vehicle. Check that the purchaser receives a usable key. Test a purchase with a full inventory, then free a slot and check delivery. End a test drive and check that its temporary key no longer gives access.

Society purchases give the key to the purchaser while keeping the society as the vehicle's legal owner. See Vehicle sales for the buyer-key setting.

Troubleshooting

Last updated 14 October 2026

On this page