Bablo ResourcesDocs

Configuration

All configuration lives in config.lua. Dealerships, the vehicle catalogue, part prices, vehicle pictures and themes are managed in game in the admin panel, so this file holds the server-wide rules and the defaults.

Changes to config.lua need a resource restart to take effect (restart bablo-dealerships in the console).

config.lua is a shared file, so it is sent to every player. Never put a secret in it. The Fivemanage key for the photo studio goes in server.cfg, see Photo Studio.


Debug

LUA
Config.DEBUG = false

Prints extra lines in the server console and in each player’s F8 console, for example which framework, target and inventory were detected and who saved a dealership. It also adds test commands that every player can run, and one of them teleports. See Commands.

Keep Config.DEBUG = false on a live server.


Framework

LUA
-- auto | qbcore | esx | qbox
Config.Framework = "auto"

auto checks for es_extended, then qbx_core, then qb-core, and waits up to 5 seconds for one of them to start. Force a value only if detection picks the wrong one. With any other value, or when no framework is found, no bridge is loaded and the script does not work.

Each framework has its own open bridge files in frameworks/<framework>. See Exports & Events.


Language

LUA
Config.Locale = "en"

The language of the script’s texts, loaded from locales/<locale>.json (en and sv ship with the resource). See Languages for how to add one.


Inventory

LUA
Config.Inventory = 'auto'

The inventory resource the staff tablet item is handed out through and looked up in. Nothing else in the script uses the inventory.

auto uses the first started one of: ox_inventory, qb-inventory, ps-inventory, codem-inventory, core_inventory, origen_inventory, tgiann-inventory, and waits up to 5 seconds for one to start. On ESX, when none of them runs, the ESX default inventory (esx) is used. Each one is a file in src/inventories.

Set one of those names to force it. Only force an inventory that runs on your server: a forced inventory is never replaced by another one. When no inventory is found, the Tablet button is not shown in the management panel. See Staff tablet.


Target and prompts

LUA
Config.Target      = "auto"   -- auto | ox_target | qb-target | standalone
Config.Interaction = "auto"   -- auto | ox_lib | standalone
SettingUsed for
Config.TargetInteraction points that are set to Target eye in the dealership creator. auto uses ox_target when it runs, then qb-target, otherwise standalone. With standalone those points fall back to the E key.
Config.InteractionThe prompt on screen, for example [E] Browse vehicles. ox_lib shows the ox_lib text UI, standalone shows GTA’s own help text. auto uses ox_lib.

Points set to Press E nearby and every zone always use the E key, whatever the target setting is. The bridge files are in src/interactions.


Currency

LUA
Config.Currency = {
    pattern   = '$ %s',
    thousands = ',',
    account   = 'bank', -- cash | bank
}

How money is written in every panel, in notifications and on the windscreen price tags. pattern uses %s as the number placeholder and thousands is the separator between groups of three digits. The default shows $ 149,900; pattern = '%s kr' with thousands = ' ' shows 149 900 kr.

account is not read by the script. Which money account a purchase is paid from is set per payment method below.


Payment methods

LUA
Config.PaymentMethods = {
    { id = 'bank', label = 'Bank account', account = 'bank', finance = true },
    { id = 'cash', label = 'Cash',         account = 'cash', finance = false },
}

The ways to pay at a dealership. Each dealership picks the ones it takes under Accepted payment methods in the creator and has to accept at least one.

FieldDescription
idUnique name of the method. Dealerships save this id.
labelThe name players see. A payment.<id> key in your locale file replaces it, see Languages.
accountThe framework money account that is charged, for example bank or cash. On ESX cash is the money account. Left out, the id is used.
financetrue lets customers use this method to buy on finance.

Keep a method with the id bank. Instalments are collected from it, and withdrawals from the dealership account, commission, trade-in and buy-back payouts are paid into it. Without one, instalments come from the first method with finance = true, and payouts go to the first method in the list or to the one the sale was paid with.

Dealerships save the id of the methods they accept. After you rename or remove a method, open each dealership in the creator and choose its payment methods again.


Admin command

LUA
Config.AdminCommand = 'dealereditor'
 
Config.AdminAce = 'bablo.dealerships.admin'

Config.AdminCommand is the chat command that opens the admin panel with the Dealerships, Vehicles, Photo studio, Part prices and Theme tabs. See Admin Panel.

Only server admins can open it. Everyone else gets You are not allowed to do that.

FrameworkWho counts as a server admin
QBCorePlayers with the admin or god permission
QboxPlayers with the admin permission
ESXPlayers in the admin or superadmin group
AllAnyone with the ACE command, or the ACE in Config.AdminAce

Config.AdminAce gives a group access without making it a framework admin. Example for server.cfg:

PLAINTEXT
add_ace group.admin bablo.dealerships.admin allow

Server admins can also open the management panel of every dealership with full access.


Units and dates

LUA
Config.SpeedUnit = 'kph'      -- kph | mph
Config.DistanceUnit = 'km'    -- km | mi
Config.DateLocale = 'en-US'
OptionDescription
SpeedUnitUnit of the top speed in the showroom: kph or mph. Anything else counts as kph.
DistanceUnitUnit of mileage and of the stock run distances: km or mi. Anything else counts as km.
DateLocaleHow dates and times are written in the panels, as a locale tag such as en-US, en-GB or sv-SE.

Categories

LUA
Config.Categories = {
    compacts = 'Compacts', sedans = 'Sedans', suvs = 'SUVs', coupes = 'Coupes', muscle = 'Muscle',
    sportsclassics = 'Sports Classics', sports = 'Sports', super = 'Super', motorcycles = 'Motorcycles',
    offroad = 'Off-road', industrial = 'Industrial', utility = 'Utility', vans = 'Vans', cycles = 'Cycles',
    boats = 'Boats', helicopters = 'Helicopters', planes = 'Planes', service = 'Service', emergency = 'Emergency',
    military = 'Military', commercial = 'Commercial', openwheel = 'Open Wheel',
}

The names shown for vehicle categories. The key is the category id saved on a catalogue vehicle, the value is what players read. A category that is not listed here shows its id with a capital first letter, so add a line for categories of your own, for example imports = 'Imports'.


Vehicle pictures

LUA
Config.VehicleImages = 'https://assets.babloresources.com/vehicles/{car}.webp'

Where vehicle pictures in the panels load from. {car} is replaced with the spawn name in lower case.

A picture you took yourself in the Photo Studio is always used first. This address is only used for vehicles without an own picture, and only while Use the Bablo CDN for vehicles without an own picture is on in the Photo studio tab.

Set it to false to show no pictures at all, your own ones included. Vehicles then show an icon.


Tuning

LUA
Config.Tuning = {
    DefaultMode = 'purchase', -- mode a new dealership starts with
    TestDrive   = true,      -- test drives keep the parts the customer picked
    MinPrice    = 250,       -- no part is cheaper than this
    -- part price as a share of the vehicle price, one value per level (0.03 = 3%)
    Prices = {
        engine       = { 0.03, 0.05, 0.07, 0.09 },
        transmission = { 0.015, 0.025, 0.035 },
        brakes       = { 0.012, 0.02, 0.028 },
        suspension   = { 0.006, 0.01, 0.014, 0.018 },
        turbo        = { 0.06 },
        bodywork     = { 0.006, 0.009, 0.012, 0.015, 0.018, 0.021 },
        extras       = { 0.002, 0.003, 0.004 },
    },
    -- flat price per wheel category
    Wheels = { sport = 3200, muscle = 2800, lowrider = 3400, suv = 3000, offroad = 3600, tuner = 4200, highend = 6800, street = 2400, track = 5200, bike = 1800 },
}

Showroom tuning lets customers try parts on the showroom vehicle. Each dealership picks its mode under Showroom tuning in the creator: Off, Preview only or Can be bought.

OptionDescription
DefaultModeThe mode a dealership gets when you import it from the presets: off, preview or purchase. The boat and aircraft presets are always off. A dealership you create yourself starts on Preview only.
TestDrivetrue: a test drive started from the showroom keeps the parts the customer picked there. false: the test drive vehicle is stock.
MinPriceNo part costs less than this.
PricesThe price of a part as a share of the vehicle’s price, one value per level, up to 10 levels.
WheelsA flat price per wheel category, whatever the vehicle costs.

The groups in Prices:

GroupParts
engineEngine
transmissionTransmission
brakesBrakes
suspensionSuspension
turboTurbo (fitted or not, so one level)
bodyworkSpoiler, front and rear bumper, side skirts, exhaust, grille, hood, roof and livery
extrasWindow tint, plate style and xenon lights

A part costs the vehicle’s price times the share of its level, rounded to the nearest 50 and never less than MinPrice. On a $ 100,000 vehicle the first engine level is $ 3,000. A level above the last value in the list costs the last share plus 0.1% of the vehicle’s price for each extra level.

The same prices decide what fitted parts add to trade-in, buy-back and pre-owned prices.

MinPrice, Prices and Wheels are the starting values. Once prices are saved on the Part prices tab of the admin panel, the saved prices are used on the whole server. Config prices on that tab goes back to the values in this file. See Pricing.


Ranks

LUA
Config.Ranks = {
    { name = 'General Manager',  about = 'Runs the dealership alongside the owner.',                          permissions = { 'admin' } },
    { name = 'Sales Manager',    about = 'Leads the sales floor: hires staff, sets prices and closes deals.', permissions = { 'employees', 'inventory', 'sell', 'deliver', 'records' } },
    { name = 'Stock Controller', about = 'Orders vehicles, sets prices and brings stock in.',                 permissions = { 'inventory', 'deliver', 'records' } },
    { name = 'Accountant',       about = 'Looks after the dealership account and the books.',                 permissions = { 'finances', 'records' } },
    { name = 'Sales Advisor',    about = 'Sells vehicles and takes customers on test drives.',                permissions = { 'sell', 'records' } },
    { name = 'Driver',           about = 'Collects ordered stock from the depot.',                            permissions = { 'deliver' } },
    { name = 'Trainee',          about = 'Sells under supervision and sees no records.',                      permissions = { 'sell' } },
}

The ranks that can be given to employees in the Team tab of the management panel, listed in this order. They apply to dealerships whose staff use Built-in roles. A dealership that is set to Server job uses the grades of that job instead, with the permissions ticked per grade in the creator. See Team & Ranks.

FieldDescription
nameThe rank name, shown in the panel and on job offers. It is saved with each employee, so every name has to be different.
aboutA short description shown with the rank.
permissionsWhat the rank may do, from the list below. Names that are not in the list are ignored.
PermissionShown asAllows
adminFull accessEverything below.
employeesManage the teamHire, change ranks and fire. Only for ranks whose permissions the staff member holds too.
inventoryManage stock and pricingOrder vehicles, cancel orders, set prices, run the pre-owned lot and the showroom floor, and answer vehicle requests.
financesManage the accountSee the dealership account, deposit, withdraw and save the settings.
sellSell vehiclesSell to customers in person, start test drives and see vehicle requests.
deliverCollect stockSee the orders and go on stock runs.
recordsView recordsThe dashboard, the sales records and the order list.

The owner of a dealership always has full access and needs no rank.

An employee whose rank name is no longer in this list loses access to the management panel until someone gives them another rank in the Team tab. Rename ranks before players are hired, not after.


Staff discount

LUA
Config.MaxStaffDiscount = 50

The highest value a dealership can enter under Largest discount on a sale in the Settings tab of the management panel, in percent. A dealership starts at 0, so staff give no discount until it is raised there. Use 0 to 50; a higher value counts as 50.

A discount never takes a vehicle below the lowest price set for it in the catalogue.


Trade-ins and pre-owned

LUA
Config.TradeInPercent = 55
 
Config.UsedStartPrice = 0.75
 
Config.UsedPartsPercent = 50
OptionDescription
TradeInPercentTrade-in credit as a percentage of the catalogue price (1 to 100). It is used for dealerships imported from the presets and for any dealership that has no value of its own. In the creator the value is set under Trade-ins.
UsedStartPriceThe share of the catalogue price a traded-in or bought-back vehicle is put on the pre-owned lot for (0.75 = 75%), until the dealership sets its own under Asking price on the pre-owned lot.
UsedPartsPercentThe percentage of what the fitted tuning parts are worth that is added to trade-in, buy-back and asking prices (0 to 100), until the dealership sets its own under Fitted tuning parts count for.

A dealership sets its own values in the Settings tab of the management panel, under Pre-owned vehicles. The asking price is rounded to the nearest 100 and is never lower than what the dealership paid for the vehicle. Mileage lowers the trade-in credit and the asking price, but not what the parts add, see Mileage. See Trade-ins, Buy-back & Pre-owned.


Mileage

LUA
Config.Mileage = {
    Source = 'auto',   -- auto | bablo-hud | jg | framework | none (auto = bablo-hud, then jg-vehiclemileage, then the framework)
    FreeKm = 20,       -- km driven before the value starts to drop
    LossPer100Km = 4,  -- percent of the vehicle's value lost per 100 km over FreeKm
    MaxLoss = 40,      -- most percent mileage can take off
}

Where a vehicle’s mileage is read from and how much value it takes off trade-ins, buy-backs and pre-owned asking prices.

SourceMileage comes from
autobablo-hud when it runs, then jg-vehiclemileage when it runs, otherwise your framework.
bablo-hudThe mileage table of bablo-hud.
jgThe mileage column that jg-vehiclemileage adds to your vehicle table.
frameworkQBCore and Qbox: drivingdistance in player_vehicles. ESX: mileage in the saved vehicle properties.
noneMileage is ignored: every vehicle counts as 0 km and nothing is taken off.

An unknown value counts as auto. A vehicle that the chosen source has no mileage for falls back to the framework value.

OptionDescription
FreeKmKilometres a vehicle can be driven before its value starts to drop.
LossPer100KmPercent of the value lost for every 100 km above FreeKm.
MaxLossThe most mileage can take off, in percent (0 to 100).

With the defaults a vehicle with 520 km loses 20% of its trade-in value, and the loss stops growing at 1,020 km. The three numbers are always in kilometres, also when Config.DistanceUnit is mi.

A pre-owned vehicle keeps its mileage when it is sold on.


Finance

LUA
Config.Finance = {
    Payments = 12,
    MaxPayments = 20, -- most payments staff can set when selling on finance
    DownPayment = 0.1,
    Interest = 0.1,
    IntervalHours = 12,
    GraceHours = 24,
    MaxActive = 5, -- financed vehicles one player can have at a time
    Bank = {
        Enabled = true,      -- register finance as a loan in bablo-banking (needs its loans enabled)
        RequireScore = true, -- refuse finance when the bank would refuse a loan
        RateFromTier = true, -- add the bank credit tier's rate modifier to Interest
    },
}

The terms for buying on finance. Financing also has to be on for the dealership (Financing in the creator) and the customer has to pay with a method that has finance = true. See Financing.

OptionDescription
PaymentsNumber of instalments when a customer buys on finance in the showroom (1 to MaxPayments).
MaxPaymentsThe most instalments staff can set when they sell on finance in person.
DownPaymentShare of the total that is paid at purchase (0.1 = 10%, at most 0.9). Staff can set 0 to 99 percent on their own sales.
InterestShare added to the price (0.1 = 10%).
IntervalHoursHours between two instalments.
GraceHoursHours the customer has to pay after a missed instalment before the vehicle is taken back.
MaxActiveFinanced vehicles one character can have at the same time.

The total is the price plus interest. The down payment is taken from the total and the rest is split evenly over the instalments. With the defaults a $ 100,000 vehicle costs $ 110,000: $ 11,000 at purchase and 12 instalments of $ 8,250.

The number of instalments, their size and the interval are fixed when the vehicle is bought. Changing these values only affects vehicles bought afterwards.

Bank loans

Bank links financing to bablo-banking. It only does something while bablo-banking runs and has its loans switched on.

OptionDescription
EnabledEvery financed vehicle is registered as a loan at the bank, and payments, missed payments and repossessions are reported to it.
RequireScoreFinance is refused when the bank would refuse the customer a loan: too many loans, a defaulted loan or a credit score that is too low.
RateFromTierThe rate modifier of the customer’s credit tier is added to Interest.

Company purchases

LUA
Config.CompanyPurchases = { Enabled = true, MinGrade = false }

Lets a player pay for a vehicle from their job or gang account. The vehicle is registered to the player who buys it.

OptionDescription
Enabledfalse turns company purchases off on the whole server.
MinGradeThe lowest job or gang grade that may pay from the company account. false = bosses only.

A dealership also needs Customers can purchase and Company purchases on in the creator. When a dealership lists companies under Which companies may buy for their fleet, only those companies can buy there, each from the grade set on its row, and MinGrade is not used.

The job in Config.UnemployedJob never counts as a company. ESX has no gang accounts. Which banking resources the company account is read from is listed on Exports & Events.


Garages

LUA
Config.Garages = { land = 'pillboxgarage', sea = 'lsymc', air = 'intairport' }

QBCore and Qbox save a garage name on every owned vehicle. A vehicle bought at a dealership gets the name for its kind: land for road vehicles, sea for boats and air for aircraft. Use garage names from your garage script. A kind that is left out gets pillboxgarage.

ESX does not use this setting. There a bought vehicle is saved in owned_vehicles with the type car, boat or aircraft.


Test drives

LUA
Config.TestDrive = { Seconds = 120 }
LUA
Config.TestDrive.MaxActive = 5
OptionDescription
SecondsHow long a test drive lasts when a customer starts it from the showroom. Test drives started by staff have no timer.
MaxActiveTest drives the staff of one dealership can have out at the same time. 0 = no limit.

MaxActive is not inside the Config.TestDrive table. It is set on its own line further down the file, after Config.SaleOfferSeconds. Keep that line below Config.TestDrive = { ... }.

Test drives also have to be on for the dealership and need a test drive spawn point. See Test Drives.


Orders

LUA
Config.Orders = { DealerCost = 0.8, Minutes = 30, MaxQuantity = 99 }

How player-owned dealerships order stock. See Stock & Orders.

OptionDescription
DealerCostShare of the catalogue price the dealership pays for each ordered vehicle (0.8 = 80%, from 0 to 2).
MinutesMinutes until an order arrives by itself, for dealerships that have no wait of their own saved, such as the ones imported from the presets (1 to 10080). In the creator the wait is Wait before orders arrive under Stock deliveries.
MaxQuantityThe most vehicles in one order (1 to 99).

Delivery

LUA
Config.Delivery = {
    Truck = 'packer',
    Trailer = 'tr2',
    MaxMinutes = 60,
    Sizes = { suvs = 'medium', offroad = 'medium', vans = 'medium', industrial = 'large', commercial = 'large', utility = 'large', service = 'large', military = 'large' }, -- small (default) | medium | large
    Depots = {
        { label = 'Port of Los Santos',    coords = vector4(141.12, -3204.31, 5.85, 267.5) },
        { label = 'Sandy Shores Airfield', coords = vector4(1742.83, 3266.83, 41.24, 102.64) },
    },
}

Stock runs: staff drive a truck from the dealership to a depot and bring the ordered vehicles back on a car trailer. See Stock Runs.

OptionDescription
TruckSpawn name of the truck. It waits at the dealership.
TrailerSpawn name of the car trailer. It waits loaded at the depot.
MaxMinutesMinutes before a run is called off (5 to 720). The vehicles are then back at the depot and can be collected again.
SizesThe trailer space a vehicle takes, by category or by spawn name: small (the default), medium or large. A spawn name wins over its category.
DepotsThe places a run can collect from. Each has a label and coords as a vector4, where the 4th number is the heading. One depot is picked at random for every run.

The trailer has 6 slots. A small vehicle takes 1 slot, a medium one 1.5 and a large one 2. The size is saved with the order when it is placed.

A stock run is only offered at a player-owned dealership for road vehicles that is set to Stock run, has a Delivery trucks spawn point and has at least one depot here. In every other case orders arrive by themselves after the wait.


Offers

LUA
Config.Offers = { JobSeconds = 60, TransferSeconds = 90, Distance = 15.0 }
OptionDescription
JobSecondsSeconds a player has to answer a job offer (15 to 600).
TransferSecondsSeconds a player has to answer an offer to take over a dealership (15 to 600).
DistanceHow close the other player has to stand, in metres, to be offered a job, a dealership, a sale or a test drive (2 to 100).

Requests

LUA
Config.Requests = { MaxOpen = 5, KeepDays = 14 }
OptionDescription
MaxOpenRequests one customer can have waiting at one dealership (1 to 50). A request that staff marked as ordered still counts.
KeepDaysRequests older than this many days are deleted, answered or not. 0 keeps them forever. This is checked once an hour.

See Vehicle Requests.


Scrap value

LUA
Config.ScrapShare = 0.12

The share of the catalogue price the dealership account receives when staff scrap a vehicle on the pre-owned lot (0.12 = 12%, from 0 to 1). The amount is rounded to the nearest 50.


Unemployed job

LUA
Config.UnemployedJob = 'unemployed'

The name of your server’s job for players without work. It is used in two places:

  • A dealership with Also set a server job on gives a fired employee this job, as long as they still hold the dealership’s job.
  • This job never counts as a company for company purchases.

Photo studio

LUA
Config.PhotoStudio = {
    PauseKey = 'SPACE',  -- pauses or resumes a photo shoot
    StopKey = 'BACK',    -- stops a photo shoot early
    LoadSeconds = 12,    -- a vehicle model that takes longer to load is skipped
    Plate = 'DEALER',    -- plate text on photographed vehicles ('' keeps the game's plate)
}

Settings for the photo shoot on the Photo studio tab of the admin panel. See Photo Studio.

OptionDescription
PauseKeyKey that pauses or resumes a photo shoot.
StopKeyKey that stops a photo shoot early. Pictures taken so far are kept.
LoadSecondsA vehicle model that takes longer than this to load is skipped (at least 3).
PlatePlate text on photographed vehicles. '' keeps the plate the game gives the vehicle.

A key is SPACE, BACK (Backspace), RETURN (Enter), DELETE, TAB, a single letter, a single digit or F1 to F12. Any other value falls back to SPACE for pause and BACK for stop.


Finance command

LUA
Config.FinanceCommand = 'myfinance'

The chat command that opens My finance, where a player sees the vehicles they are still paying off and can pay early. Set it to false to have no command. Payment reminders then no longer mention one. See Commands.


Sale offers

LUA
Config.SaleOfferSeconds = 90

Seconds a customer has to sign a sale offer that staff sent them (15 to 600). See Staff Sales.


Display

LUA
Config.Display = { Max = 12, Range = 60.0, Plate = 'DISPLAY', MaxPromo = 50, TagRange = 12.0, Tags = 4 } -- MaxPromo: highest promotion (percent); TagRange/Tags: windscreen price tags shown at once

The showroom floor: display vehicles that staff place around the dealership. See Showroom Floor.

OptionDescription
MaxThe most display vehicles per dealership (at least 1).
RangeFor dealerships without a drawn area: how far from the showroom entrance a display vehicle may stand, in metres (at least 5). With a drawn area the vehicle has to stand inside it.
PlatePlate text on display vehicles, up to 8 characters.
MaxPromoThe highest promotion staff can put on a display vehicle, in percent (0 to 90).
TagRangeHow close a player has to be to a display vehicle to see its windscreen price tag, in metres (at least 4).
TagsThe most price tags drawn at once, nearest first (0 to 6). 0 shows none.

NPCs in dealership areas

LUA
Config.BlockNpcs = true

Keeps NPC peds and parked NPC cars out of every dealership that has an area drawn in the creator. They no longer spawn inside the area, and the ones that wander in are removed. Vehicles that a player drove are left alone. Set it to false to leave the game’s traffic as it is.


Staff tablet

LUA
Config.Tablet = {
    Enabled = true,
    Item = 'bdealer_tablet',  -- inventory item name
    Price = 0,               -- charged to the dealership account per tablet (0 = free)
    Permission = 'sell',     -- staff permission needed to take and use one
    Radius = 60.0,           -- metres around the desk and showroom entrance when a dealership has no drawn area
    Prop = 'prop_cs_tablet',
    Animation = { dict = 'amb@code_human_in_bus_passenger_idles@female@tablet@base', clip = 'base' },
    Bone = 60309,            -- hand bone the prop is attached to (60309 = left hand, 28422 = right hand)
    Offset = vector3(0.03, 0.002, 0.0),
    Rotation = vector3(10.0, 160.0, 0.0),
}

Staff of a player-owned dealership take a tablet with the Tablet button in the management panel and use it from their inventory. It opens Stock and Showroom floor anywhere inside the dealership. See Staff Tablet for the item setup.

OptionDescription
Enabledfalse removes the Tablet button and the item no longer opens anything.
ItemThe inventory item name. The item has to exist in your inventory.
PriceCharged to the dealership account for each tablet. 0 = free.
PermissionThe staff permission needed to take and use a tablet, see Ranks.
RadiusFor dealerships without a drawn area: the tablet works within this many metres of the management and showroom points (at least 5). With a drawn area it works inside the area.
PropThe prop held while the tablet is open.
AnimationThe animation played while the tablet is open: dict and clip.
BoneThe hand bone the prop is attached to: 60309 is the left hand, 28422 the right hand.
Offset, RotationPosition and rotation of the prop on the hand, as vector3.

A tablet belongs to the dealership it was taken from, and a staff member can carry one per dealership. The ESX default inventory stores no item data, so there the tablet opens for the dealership the staff member is standing in.


Stock run

LUA
Config.StockRun = { CancelCommand = 'cancelrun', BayRadius = 12.0, LeaveSeconds = 90, BayTolerance = 1.6 }

Rules for the driver on a stock run. The truck, the trailer and the depots are set under Delivery.

OptionDescription
CancelCommandChat command that gives up the run. false or '' = no command. See Commands.
BayRadiusHow close to the unloading bay the truck has to be for the last step, Park inside the unloading bay, in metres (at least 4). Where the bay is only shown as a marker, stopping within this distance delivers the stock.
LeaveSecondsSeconds the driver may be out of the truck before the run is cancelled (at least 10).
BayToleranceHow far the truck and trailer may stick out of the bay outline and still count as parked, in metres (0 to 5).

Showcase

LUA
Config.Showcase = {
    Enabled = true,
    Mode = 'garage',                          -- garage = the Eclipse Boulevard Garage interior, room = a plain coloured room built by the script
    Garage = { coords = vector4(519.85, -2621.29, -50.0, 132.12), ipl = 'xm3_garage_fix' }, -- where the vehicle stands in the garage
    Air = vector4(-1145.94, -2864.42, 12.95, 150.0), -- aircraft dealerships: a helipad at the airport, false to use the room
    Sea = vector4(-733.5, -1357.5, -0.6, 137.0),    -- boat dealerships: on the water at the marina, false to use the garage
    MaxZoom = 10.0,                           -- furthest the camera can back away in the studio, in metres (walls stop it earlier)
    Style = nil,                              -- garage look: 'immaculate' (white), 'industrial' (concrete), 'indulgent', nil = leave as the server has it
    Coords = vector3(730.0, 2880.0, -80.0),   -- room mode: hidden spot under the map
    Room = { r = 244, g = 245, b = 247 },     -- colour of the room: white studio, or { r = 0, g = 0, b = 0 } for black
    Hour = 12,                                -- clock hour inside the room (12 for a white room, 0 for a black one)
    Floor = 'xs_prop_arena_turntable_b_01a_sf', -- platform under road vehicles, false for none
    Light = { r = 255, g = 250, b = 244 },    -- colour of the spotlights on the vehicle
    Brightness = 1.0,                         -- 0.5 = darker, 2.0 = brighter
    Ring = false,                             -- glowing ring around the platform
    Accent = { r = 255, g = 255, b = 255 },   -- ring colour, nil = the theme accent
    Disc = false,                             -- flat floor disc under the platform
    DiscShade = 9,                            -- 0 = black, 255 = white
    Poles = false,                            -- glowing light tubes standing around the vehicle
    Strips = false,                           -- light strips on the floor leading to the platform
}

The showcase studio shows the showroom vehicles in a studio that is set up only for the player who is browsing, instead of at a spot in the world. It is switched on per dealership with Showcase studio under Showroom camera in the creator. See Showroom.

OptionDescription
Enabledfalse turns the studio off for every dealership.
Modegarage puts the vehicle in the Eclipse Boulevard Garage interior. room builds a plain coloured room. Any other value counts as garage.
GarageGarage mode: coords is where the vehicle stands (vector4) and ipl is the map part that is loaded for the interior.
AirAircraft dealerships: an outdoor spot used instead of the studio (vector4). false uses the room.
SeaBoat dealerships: a spot on the water used instead of the studio (vector4). false uses the garage, or the room in room mode.
MaxZoomThe furthest the camera can back away in the studio, in metres.
StyleGarage mode: the look of the interior, 'immaculate', 'industrial' or 'indulgent'. nil leaves it as it is. The look is put back when the player leaves the showroom.

The rest only applies to the room that the script builds:

OptionDescription
CoordsWhere the room is built (vector3).
RoomColour of the room.
HourThe clock hour while the player is inside.
FloorThe prop under road vehicles. false for none.
LightColour of the spotlights on the vehicle.
BrightnessStrength of the lights: 0.5 is darker, 2.0 is brighter.
RingA glowing ring around the platform.
AccentColour of the ring. nil uses the accent colour of the theme.
DiscA flat disc on the floor under the platform.
DiscShadeShade of the disc from 0 (black) to 255 (white).
PolesGlowing light tubes standing around the vehicle.
StripsLight strips on the floor leading to the platform.

Blocked vehicles

LUA
Config.BlockedVehicles = {
    Categories = { 'military' },
    Trailers = { 'tr2', 'tr3', 'tr4', 'trflat', 'tanker', 'tanker2', 'armytanker', 'cablecar' }, -- plus every model with "trailer" in its name
    Models = {
        'rhino', 'khanjali', 'apc', 'halftrack', 'barrage', 'chernobog', 'thruster', 'scarab', 'scarab2', 'scarab3', 'minitank',
        'insurgent', 'insurgent3', 'technical', 'technical2', 'technical3', 'menacer', 'caracara', 'boxville5', 'limo2', 'trailersmall2',
        'oppressor', 'oppressor2', 'deluxo', 'stromberg', 'toreador', 'vigilante', 'ruiner2', 'scramjet', 'tampa3', 'dune3', 'dune4', 'dune5',
        'blazer5', 'wastelander', 'phantom2', 'boxville5', 'cerberus', 'cerberus2', 'cerberus3', 'bruiser', 'bruiser2', 'bruiser3',
        'brutus', 'brutus2', 'brutus3', 'monster3', 'monster4', 'monster5', 'zr380', 'zr3802', 'zr3803', 'dominator4', 'dominator5', 'dominator6',
        'impaler2', 'impaler3', 'impaler4', 'imperator', 'imperator2', 'imperator3', 'issi4', 'issi5', 'issi6', 'slamvan4', 'slamvan5', 'slamvan6',
        'deathbike', 'deathbike2', 'deathbike3', 'speedo4', 'mule4', 'pounder2', 'terbyte', 'pbus2', 'jb7002', 'paragon2', 'champion', 'buffalo4',
        'hydra', 'lazer', 'besra', 'strikeforce', 'starling', 'pyro', 'rogue', 'molotok', 'nokota', 'tula', 'bombushka', 'mogul', 'seabreeze',
        'volatol', 'avenger', 'avenger2', 'avenger3', 'avenger4', 'raiju', 'streamer216', 'alkonost',
        'buzzard', 'savage', 'hunter', 'akula', 'annihilator', 'annihilator2', 'valkyrie', 'valkyrie2', 'havok', 'seasparrow', 'seasparrow2', 'seasparrow3', 'conada2',
        'patrolboat', 'dinghy5', 'kosatka', 'predator',
    },
}

A blocked vehicle stays in the catalogue but is sold nowhere. This setting blocks nothing by itself. It decides which vehicles two tools on the Vehicles tab of the admin panel pick:

OptionUsed by
CategoriesBlock armed and military vehicles in the Import vehicles window. Vehicles in these categories are blocked as they are added.
ModelsThe same import option, by spawn name, and the Armed vehicles group under Blocked groups.
TrailersThe Trailers group under Blocked groups, together with every model that has trailer in its name.

The import option only blocks vehicles that are not in the catalogue yet. See Vehicle Catalogue.


Placement

LUA
Config.Placement = { Range = 150.0, Speed = 10.0 }

The free camera used to place things in the world: points, spawn points and areas in the dealership creator, and display vehicles on the showroom floor.

OptionDescription
RangeHow far the camera may fly from where you stand, in metres (at least 20).
SpeedHow fast the camera moves, in metres per second (at least 1). Hold Shift to move faster and Alt to move slower.