Bablo ResourcesDocs

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

FieldWhat it does
NameThe name players see, up to 48 characters.
IdFilled 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 / PublicWho runs the dealership, see below.
What it sellsRoad vehicles, Boats or Aircraft. A dealership only sells catalogue vehicles of its own type.
EnabledA disabled dealership is hidden from players: no blip, no entrance and no display vehicles.
Map blipShows 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

PublicPlayer-owned
Run byThe serverPlayers
StockUnlimitedIts own stock, filled with stock orders
Staff and accountNoneStaff, ranks and a dealership account
BuyingCustomers buy straight from the showroomFrom the showroom when Customers can purchase is on, and from staff in person
PricesSet by you in the Prices sectionSet by staff in the management panel
Extra sectionsPricesStaff, 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:

ModeHow it works
Built-in rolesThe owner hires players from the management panel and gives each a role from Config.Ranks. See Team & Ranks.
Server jobEveryone 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

SettingWhat it does
Customers can purchaseOff: the showroom is for browsing only and vehicles are sold by staff in person. See Buying a Vehicle.
Company purchasesPlayers 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.
FinancingCustomers may pay in instalments. The terms come from Config.Finance, and at least one accepted payment method must support financing. See Financing.
Test drivesNeeds a test drive spawn point. See Test Drives.
Vehicle requestsCustomers can ask for a vehicle that is out of stock. Player-owned only. See Vehicle Requests.
Pay sellers commissionStaff 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-overCars 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-insCustomers 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 vehiclesPlayers 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 lotVehicles 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 tuningOff, Preview only (customers try parts, vehicles are delivered stock) or Can be bought (parts are fitted and paid for). See Showroom.
Accepted payment methodsThe methods from Config.PaymentMethods this dealership takes. At least one.
Owner can sell the dealershipThe 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.

OptionWhat happens
Stock runStaff 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 waitOrders are added to the stock by themselves after Wait before orders arrive.
Straight awayOrders 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.MinGrade allows 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:

UseWith an areaWithout one
Staff tabletWorks inside the area.Works within Config.Tablet.Radius metres of a management desk or showroom entrance.
Showroom floorDisplay vehicles must stand inside the area.They must stand within Config.Display.Range metres of the entrance.
NPCsNPC 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. With Config.Showcase.Enabled = false the 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.

ListUsed forShown when
Showroom entranceCustomers open the showroom. At least one is required.Always
Management deskStaff open the management panel.Player-owned
Buy-back pointPlayers 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:

TypeWhat it is
PointA spot on the ground with a Radius of 0.5 to 25 metres.
PedA character standing at the spot, with an optional Scenario such as Holding a clipboard.
ObjectA prop such as a laptop or a desk.
VehicleA parked, locked vehicle in the Vehicle colour you pick.
ZoneAn 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_target or qb-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

ListUsed for
Purchased vehiclesA bought vehicle appears on the first of these points that is free. At least one is required.
Test drivesWhere a test drive vehicle appears. Required while Test drives is on.
Delivery trucksWhere 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.

KeyAction
W A S D, mouseFly and look around
Q / EDown / up
ShiftFaster
AltSlower, and finer steps for the scroll wheel
LMB or EnterPlace here
ScrollTurn the vehicle, ped or prop. For a Point, the scroll wheel and the up and down arrows also change its size.
Backspace, RMB or EscCancel

Drawing an area works a little differently:

KeyAction
LMBAdd corner. Click the first corner again to close the area.
EnterFinish, from three corners.
ScrollHeight
Backspace or RMBUndo corner
EscCancel

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.

LUA
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

WhatLimit
Corners of an area or zone3 to 64
Area height1 to 200 metres
Interaction points per list24
Spawn points per list32
Dealer colours48
Zoom distances1 to 60 metres
Wait before orders arriveUp to 168 hours