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:
| Field | What it does |
|---|
label | Name shown on the map and in the menu |
radius | How close the car must be to pos |
pos | Where they drive in |
stage | Optional: where the car sits while it is customized |
exit | Optional: where the car is put when they leave |
blip | Optional: where the map blip goes |
free | Optional: true = nothing costs money |
jobs | Optional: 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 },
},
| Option | Default | What it does |
|---|
Config.Blip | { sprite = 72, colour = 27, scale = 0.6 } | Map blip for every shop |
Config.AutoEnter | true | true: drive in and it opens. false: press the key |
Config.Key | 51 | Open key: E on keyboard, D-pad right on a controller |
Config.Instance | true | Each customer gets their own private world |
Config.BucketBase | 400000 | Private worlds use this + player id; keep clear of other scripts' buckets |
Money
| Option | Default | What it does |
|---|
Config.PayFrom | { 'cash', 'bank' } | The first account that covers the whole price pays it |
Prices
| Option | Default | What it does |
|---|
body | 1500 | Any body or interior part |
wheels | 2000 | Wheels |
tyres | 500 | Custom tires on or off |
horn | 750 | Horn |
paint | 1000 | One color |
neonSide | 400 | Each neon side |
neonColour | 300 | Neon color |
xenon | 1500 | Xenon headlights |
tint | 400 | Window tint |
smoke | 500 | Tire smoke |
plate | 300 | Plate style |
stance | 2500 | Applying stance changes |
engineSound | 2000 | Engine sound |
turbo | 10000 | Turbo |
extra | 500 | Each extra part switched on |
repairPerPercent | 50 | Repair cost per 1% of body damage, and per 1% of engine damage |
performance has one price per level, level 1 first:
| Mod | Upgrade | Default 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.
| Slider | Min | Max | Step |
|---|
| Height | -0.12 | 0.12 | 0.005 |
| Camber - Front | -0.30 | 0.30 | 0.01 |
| Camber - Rear | -0.30 | 0.30 | 0.01 |
| Track Width - Front | -0.15 | 0.15 | 0.005 |
| Track Width - Rear | -0.15 | 0.15 | 0.005 |
| Wheel Size | 0.80 | 1.20 | 0.01 |
| Wheel Width | 0.70 | 1.30 | 0.01 |
| Option | Default | What it does |
|---|
Config.CamberDirection | 1 | Set to -1 if camber tilts the wheels the wrong way in game |
Colors and lists
Each list can be edited, reordered or trimmed.
| Option | Format | What 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.RainbowSpeed | 0.25 | Seconds 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.
| Option | Default | What it does |
|---|
fillPrice | 2500 | A full bottle from empty |
colourPrice | 500 | Any purge, flame or custom color |
seconds | 8.0 | How long a full bottle lasts while boosting |
purgeUse | 0.25 | Purging uses the bottle at this fraction of the boost rate (0 = free) |
power | 2.0 | How strong the boost is (1.0 = none) |
keyboard | 21 | Left Shift (control numbers) |
controller | 73 | A |
purgeColours | 9 colors | Purge colors: { name, r, g, b } |
rgbEffect | 'fc_nitrous_white' | The flame the Custom Colour picker tints (false hides Custom Colour) |
flameColours | 4 colors | Ready-made flames: { name, effect, r, g, b } (the color fills the NOS bottle) |
Livery
| Option | Default | What it does |
|---|
Config.LiveryAce | false | Sticker Designer: false = everyone, or an ace such as 'livery.use' |
Config.LiveryOwnedOnly | true | Only the vehicle's owner can change its livery |
Config.LiveryDragSpeed | 2.0 | Drag speed in the Sticker Designer |
Config.ShareResolution | 4096 | Livery sharpness in customs, the Sticker Designer and on the closest cars (2048 uses a quarter of the memory) |
Config.ShareFarResolution | 1024 | Every other car (4096 keeps them all full sharpness) |
Config.ShareNearDistance | 15.0 | Meters: cars this close get full sharpness |
Config.ShareMaxNear | 2 | Most cars at full sharpness at once (your own car counts first) |
Config.ShareMaxLoaded | 12 | Most custom liveries loaded sharp at once (closest in view first) |
Config.ShareLoadDistance | 150.0 | Meters: custom liveries further than this are not loaded |
Config.ShareBlurResolution | 256 | Cars past ShareMaxLoaded show a small blurry copy (0 = plain paint) |
Config.ShareMaxBlurred | 30 | Most blurry copies at once |
Config.ShareImageUrl | false | false uses the server address; set your own URL if you run behind a proxy |
Config.LiveryUploadRate | 500000 | Bytes per second a saved design is sent at |
Config.LiveryCamSpeed | 1.0 | Sticker 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',
}