Configuration

Everything is in config.lua. The car files in cars/ are made by the setup tool (see Adding cars).

Shops

Each shop in Config.Shops takes these fields:

FieldWhat it does
labelName shown on the map and in the menu
radiusHow close the car must be to pos
posWhere they drive in
stageOptional: where the car sits while it is customized
exitOptional: where the car is put when they leave
blipOptional: where the map blip goes
freeOptional: true = nothing costs money
jobsOptional: only these jobs, e.g. { mechanic = 0 } (job = lowest grade)
{
    label = 'Los Santos Customs', radius = 8.0,
    pos   = vec4(-356.17, -134.75, 38.57, 249.62),
    stage = vec4(-335.9, -137.5, 38.67, 278.86),
    exit  = vec4(-361.9, -132.76, 38.35, 72.78),
    jobs  = { mechanic = 0 },
},
OptionDefaultWhat it does
Config.Blip{ sprite = 72, colour = 27, scale = 0.6 }Map blip for every shop
Config.AutoEntertruetrue: drive in and it opens. false: press the key
Config.Key51Open key: E on keyboard, D-pad right on a controller
Config.InstancetrueEach customer gets their own private world
Config.BucketBase400000Private worlds use this + player id; keep clear of other scripts' buckets

Money

OptionDefaultWhat it does
Config.PayFrom{ 'cash', 'bank' }The first account that covers the whole price pays it

Prices

OptionDefaultWhat it does
body1500Any body or interior part
wheels2000Wheels
tyres500Custom tires on or off
horn750Horn
paint1000One color
neonSide400Each neon side
neonColour300Neon color
xenon1500Xenon headlights
tint400Window tint
smoke500Tire smoke
plate300Plate style
stance2500Applying stance changes
engineSound2000Engine sound
turbo10000Turbo
extra500Each extra part switched on
repairPerPercent50Repair cost per 1% of body damage, and per 1% of engine damage

performance has one price per level, level 1 first:

ModUpgradeDefault prices
[11]Engine{ 2500, 5000, 8000, 12000, 18000 }
[12]Brakes{ 1500, 3000, 5000, 7500 }
[13]Transmission{ 2000, 4000, 6500, 9000 }
[15]Suspension{ 1000, 2000, 3500, 5000, 6500 }
[16]Armor{ 2500, 5000, 8000, 12000, 16000 }

Stance

Config.Stance sets how far each slider goes either side of stock. Wheel size and width are multipliers.

SliderMinMaxStep
Height-0.120.120.005
Camber - Front-0.300.300.01
Camber - Rear-0.300.300.01
Track Width - Front-0.150.150.005
Track Width - Rear-0.150.150.005
Wheel Size0.801.200.01
Wheel Width0.701.300.01
OptionDefaultWhat it does
Config.CamberDirection1Set to -1 if camber tilts the wheels the wrong way in game

Colors and lists

Each list can be edited, reordered or trimmed.

OptionFormatWhat it is
Config.Paints{ game colour number, name }Paints, grouped into Metallic, Matte, Metal, Chrome and Chameleon
Config.EngineSounds{ name, car spawn name }Engine sounds, named after the car they sound like
Config.Neons{ name, r, g, b }Neon colors; { 'Rainbow', rainbow = true } is the rainbow option
Config.RainbowSpeed0.25Seconds for one full rainbow cycle (lower = faster)
Config.Xenon{ id, name }Xenon headlight colors
Config.Tints{ id, name }Window tints
Config.Smoke{ name, r, g, b }Tire smoke colors
Config.Plates{ id, name }Plate styles
Config.EngineSounds = {
    { 'Adder', 'adder' }, { 'Zentorno', 'zentorno' }, { 'T20', 't20' },
}

Nitrous

Bought and refilled at a shop (players pay for what is missing). Hold the button: standing still = purge, driving = boost.

OptionDefaultWhat it does
fillPrice2500A full bottle from empty
colourPrice500Any purge, flame or custom color
seconds8.0How long a full bottle lasts while boosting
purgeUse0.25Purging uses the bottle at this fraction of the boost rate (0 = free)
power2.0How strong the boost is (1.0 = none)
keyboard21Left Shift (control numbers)
controller73A
purgeColours9 colorsPurge colors: { name, r, g, b }
rgbEffect'fc_nitrous_white'The flame the Custom Colour picker tints (false hides Custom Colour)
flameColours4 colorsReady-made flames: { name, effect, r, g, b } (the color fills the NOS bottle)

Livery

OptionDefaultWhat it does
Config.LiveryAcefalseSticker Designer: false = everyone, or an ace such as 'livery.use'
Config.LiveryOwnedOnlytrueOnly the vehicle's owner can change its livery
Config.LiveryDragSpeed2.0Drag speed in the Sticker Designer
Config.ShareResolution4096Livery sharpness in customs, the Sticker Designer and on the closest cars (2048 uses a quarter of the memory)
Config.ShareFarResolution1024Every other car (4096 keeps them all full sharpness)
Config.ShareNearDistance15.0Meters: cars this close get full sharpness
Config.ShareMaxNear2Most cars at full sharpness at once (your own car counts first)
Config.ShareMaxLoaded12Most custom liveries loaded sharp at once (closest in view first)
Config.ShareLoadDistance150.0Meters: custom liveries further than this are not loaded
Config.ShareBlurResolution256Cars past ShareMaxLoaded show a small blurry copy (0 = plain paint)
Config.ShareMaxBlurred30Most blurry copies at once
Config.ShareImageUrlfalsefalse uses the server address; set your own URL if you run behind a proxy
Config.LiveryUploadRate500000Bytes per second a saved design is sent at
Config.LiveryCamSpeed1.0Sticker Designer camera speed: 0.7 slower, 1.5 faster

To limit the Sticker Designer to an ace:

Config.LiveryAce = 'livery.use'
add_ace group.admin livery.use allow

Sounds

Config.Sounds uses GTA's own frontend sounds for move, upDown, select, back, buy and error. Set one to false to silence it.

Brands for add-on cars

For add-on cars with no brand of their own: spawn name = brand name (shows its logo).

Config.ModelBrands = {
    gallardo = 'Lamborghini',
}