Dealership Creator
The creator is the form behind New dealership and Edit on the Dealerships tab of the Admin Panel. One dealership is one scrolling page; the list on the left jumps to a section. Only server admins can use it.
Nothing is saved until you press Create dealership (new) or Save changes (existing). If something is missing, the creator lists it at the top, for example Spawn points · Add at least one spawn point for purchased vehicles. Click a line to jump to it. A saved dealership changes for every player straight away, without a restart.
General
| Field | What it does |
|---|---|
| Name | The name players see, up to 48 characters. |
| Id | Filled in from the name. Lowercase letters, numbers, dashes and underscores, up to 40 characters. The server and other scripts refer to the dealership by it, and it can’t be changed after the dealership is created. |
| Player-owned / Public | Who runs the dealership, see below. |
| What it sells | Road vehicles, Boats or Aircraft. A dealership only sells catalogue vehicles of its own type. |
| Enabled | A disabled dealership is hidden from players: no blip, no entrance and no display vehicles. |
| Map blip | Shows the dealership on the map at its first showroom entrance. Pick the Sprite, Colour, Scale and Label. An empty label uses the dealership name. |
Server-run or player-owned
| Public | Player-owned | |
|---|---|---|
| Run by | The server | Players |
| Stock | Unlimited | Its own stock, filled with stock orders |
| Staff and account | None | Staff, ranks and a dealership account |
| Buying | Customers buy straight from the showroom | From the showroom when Customers can purchase is on, and from staff in person |
| Prices | Set by you in the Prices section | Set by staff in the management panel |
| Extra sections | Prices | Staff, Stock deliveries |
Who owns a player-owned dealership
Players can’t buy a dealership from the server. The owner is set in two ways:
- By you. In the Staff section, pick the player under Owner (online players only), or paste a character identifier under Or enter an identifier for a player who is offline. That is the citizen ID on QBCore and Qbox and the identifier on ESX. The owner has full access to the management panel.
- By the current owner. With Owner can sell the dealership on, the owner can sell the dealership or hand it over to a player standing nearby, for a price the owner chooses. See Account & Settings.
A new dealership without an owner can only be managed by server admins, see Managing as admin.
Staff
Player-owned dealerships only. Choose how staff are handled:
| Mode | How it works |
|---|---|
| Built-in roles | The owner hires players from the management panel and gives each a role from Config.Ranks. See Team & Ranks. |
| Server job | Everyone with the chosen server job is staff. Under What each grade may do, tick the permissions of each job grade: Full access, Employees, Stock and pricing, Finances, Sell, Deliver and Records. A grade with nothing ticked counts as staff but can’t use the management panel. |
With Built-in roles you can also switch on Also set a server job. Pick the Server job and a Job grade for each role: hiring, changing a role and firing then set the employee’s job and grade while they are online. A fired employee who still has that job gets Config.UnemployedJob.
A dealership on Server job has no owner and can’t be sold or handed over.
Vehicles and prices
Vehicles holds the categories the dealership deals in. Only categories that hold vehicles of its type in the catalogue are listed, with the number of vehicles in each. Pick at least one.
When you create the dealership, every catalogue vehicle of its type in those categories is put on its stock list. Changing the categories later does not change the stock list: use Sync stock on the Vehicles tab. See Vehicle Catalogue.
Public dealerships also have a Prices section, see Pricing.
Features
| Setting | What it does |
|---|---|
| Customers can purchase | Off: the showroom is for browsing only and vehicles are sold by staff in person. See Buying a Vehicle. |
| Company purchases | Players can pay from their job or gang account. Shown while Customers can purchase is on. Which companies may buy is set under Access, and Config.CompanyPurchases.Enabled = false turns it off for the whole server. |
| Financing | Customers may pay in instalments. The terms come from Config.Finance, and at least one accepted payment method must support financing. See Financing. |
| Test drives | Needs a test drive spawn point. See Test Drives. |
| Vehicle requests | Customers can ask for a vehicle that is out of stock. Player-owned only. See Vehicle Requests. |
| Pay sellers commission | Staff who sell in person get Commission per sale (1 to 100 percent) from the dealership account. The owner can change the share later. Player-owned only. See Staff Sales. |
| Covered hand-over | Cars sold by staff wait under a car cover. From a price of sets the lowest sale price that gets the cover; 0 covers every sale. Player-owned car dealerships only. See Covered Hand-over. |
| Trade-ins | Customers hand in a vehicle they own for credit towards a purchase. The credit starts from a share (1 to 100 percent) of the vehicle’s catalogue price. |
| Buy-back of customer vehicles | Players sell a vehicle they own to the dealership at a buy-back point. The payout starts from a share (1 to 100 percent) of the vehicle’s catalogue price. |
| Pre-owned lot | Vehicles bought back or taken in trade are resold as pre-owned instead of becoming new stock. Player-owned only. Staff sales only take trade-ins while the lot is on. See Trade-ins, Buy-back & Pre-owned. |
| Showroom tuning | Off, Preview only (customers try parts, vehicles are delivered stock) or Can be bought (parts are fitted and paid for). See Showroom. |
| Accepted payment methods | The methods from Config.PaymentMethods this dealership takes. At least one. |
| Owner can sell the dealership | The owner may sell the dealership or hand it over. Player-owned only. |
A new dealership starts with purchases, financing, test drives, vehicle requests, trade-ins, buy-back and the pre-owned lot switched off. Company purchases, a 10 percent commission and the covered hand-over are on, and Showroom tuning is on Preview only. Choosing Public switches Customers can purchase on.
Stock deliveries
Player-owned dealerships only: how ordered vehicles reach the stock.
| Option | What happens |
|---|---|
| Stock run | Staff drive a truck to the depot and bring the vehicles back on a trailer. Car dealerships only. It needs a Delivery trucks spawn point and a depot in Config.Delivery.Depots; without them, orders arrive by themselves after Wait when a stock run is not possible. See Stock Runs. |
| After a wait | Orders are added to the stock by themselves after Wait before orders arrive. |
| Straight away | Orders are added to the stock as soon as they are placed. |
The wait is entered in hours, up to 168 (0.5 is half an hour). Boats and aircraft never use stock runs.
Vehicle colours, access and theme
Vehicle colours decides which colour a customer can choose for a new vehicle:
- Dealer colours: a list you put together, up to 48 colours, each with a name. They cost nothing extra and are shown in the order of the list.
- Mix your own colour: customers pick any colour. Price of an own colour is added to the vehicle price; 0 offers it for free.
- Both off: vehicles are sold in their factory colour.
Access has two lists of jobs and gangs, each row with a Minimum grade:
- Who may enter the showroom. No rows: everyone may enter.
- Which companies may buy for their fleet. No rows: any job or gang can buy, and only bosses can pay unless
Config.CompanyPurchases.MinGradeallows lower grades.
Gang rows have no effect on ESX, which has no gangs.
Theme gives the dealership its own colours, see Themes.
Area
Draw zone lets you outline the premises in the world (see Placing things in the world). Height is counted from the lowest corner. The Layout and location map under it shows everything you have placed.
The area is used for three things:
| Use | With an area | Without one |
|---|---|---|
| Staff tablet | Works inside the area. | Works within Config.Tablet.Radius metres of a management desk or showroom entrance. |
| Showroom floor | Display vehicles must stand inside the area. | They must stand within Config.Display.Range metres of the entrance. |
| NPCs | NPC peds on foot and empty NPC cars are removed from the area and stopped from spawning there. | Nothing is cleared. |
NPC clearing is on for every enabled dealership with an area. Turn it off for the whole server with Config.BlockNpcs = false.
Showroom camera
Where the preview vehicle stands while a customer browses.
- Showcase studio on: customers view the vehicles in a studio that is built only for them. Its look comes from
Config.Showcase. WithConfig.Showcase.Enabled = falsethe switch has no effect. - Showcase studio off: press Set in world and place the vehicle. The heading decides which side customers see first. Until a position is set, the preview vehicle stands on the first spawn point for purchased vehicles.
Zoom distances are the four camera distances customers step through, 5, 8, 12 and 8 metres by default. Use larger values for trucks and aircraft.
Interaction points
The places players walk up to. Each list takes up to 24 points.
| List | Used for | Shown when |
|---|---|---|
| Showroom entrance | Customers open the showroom. At least one is required. | Always |
| Management desk | Staff open the management panel. | Player-owned |
| Buy-back point | Players bring a vehicle they want to sell. | Buy-back of customer vehicles is on |
Add point opens a window where you choose what the point is:
| Type | What it is |
|---|---|
| Point | A spot on the ground with a Radius of 0.5 to 25 metres. |
| Ped | A character standing at the spot, with an optional Scenario such as Holding a clipboard. |
| Object | A prop such as a laptop or a desk. |
| Vehicle | A parked, locked vehicle in the Vehicle colour you pick. |
| Zone | An area you outline. Players interact anywhere inside it. |
- Model is the spawn name for a ped, object or vehicle. Check confirms the game has it.
- How players use it is Press E nearby or Target eye (
ox_targetorqb-target). Without a target script, the target eye falls back to the E key. Zones always use the key. - Map blip adds an extra blip at this point.
- Marker draws a 3D marker at the spot. Showroom entrances and buy-back points can use a Floor sign instead of a Game marker: an animated sign on the ground. The buy-back sign is car-sized and only shown to players who are driving.
Spawn points
| List | Used for |
|---|---|
| Purchased vehicles | A bought vehicle appears on the first of these points that is free. At least one is required. |
| Test drives | Where a test drive vehicle appears. Required while Test drives is on. |
| Delivery trucks | Where the stock run truck appears and where ordered stock is dropped off. Player-owned car dealerships only. Leave room for a truck and trailer. |
Add my current position adds the spot you stand on (or your vehicle’s position) with your heading. Place in world lets you aim at the spot. Each list takes up to 32 points. Place boat points on the water and aircraft points on a helipad or runway.
Placing things in the world
Draw zone, Set in world, Place in world and Draw in world close the panel and give you a free camera. The keys are shown on screen, and the panel opens again where you left it when you are done.
| Key | Action |
|---|---|
W A S D, mouse | Fly and look around |
Q / E | Down / up |
Shift | Faster |
Alt | Slower, and finer steps for the scroll wheel |
LMB or Enter | Place here |
| Scroll | Turn the vehicle, ped or prop. For a Point, the scroll wheel and the up and down arrows also change its size. |
Backspace, RMB or Esc | Cancel |
Drawing an area works a little differently:
| Key | Action |
|---|---|
LMB | Add corner. Click the first corner again to close the area. |
Enter | Finish, from three corners. |
| Scroll | Height |
Backspace or RMB | Undo corner |
Esc | Cancel |
A see-through copy of the vehicle, ped or prop shows where it will stand, and points that are already placed are marked in white. Your character stays frozen where it stands while you place.
Config.Placement = { Range = 150.0, Speed = 10.0 }Range is how far the camera may fly from where you stand, in metres. Speed is how fast it moves, in metres per second.
Limits
| What | Limit |
|---|---|
| Corners of an area or zone | 3 to 64 |
| Area height | 1 to 200 metres |
| Interaction points per list | 24 |
| Spawn points per list | 32 |
| Dealer colours | 48 |
| Zoom distances | 1 to 60 metres |
| Wait before orders arrive | Up to 168 hours |

