Configuration

Everything is in config/garages.lua.

OptionDefaultWhat it does
BucketBase300000Private showcase worlds use this + player id; keep clear of other scripts' buckets

Camera

OptionDefaultWhat it does
enabledtrueTurns the showcase camera on
browseDuration6500Length of one browsing angle (ms)
retrieveDuration6000Length of the hand-off shot when you confirm a vehicle (ms)
order'random''random' picks an angle each time, 'sequential' walks the list
sceneFov45.0Field of view of the showcase camera: 60 is a wide room shot, 45 tighter, 35 close
pullback1.0Slides the camera along its view: positive pulls back, negative pushes in
skippabletrueCancel skips the hand-off shot

Camera angles

CameraAnimations lists the browsing angles (at least two). distance scales the offset; a bigger number pulls further out.

Positions: front-left, front-middle, front-right, back-left, back-middle, back-right, left, right, top-left, top-middle, top-right, center, front-left-diagonal, front-right-diagonal, back-left-diagonal, back-right-diagonal.

CameraAnimations = {
    { distance = 4.0, fovFrom = 20.0, fovTo = 35.0, from = 'front-middle', to = 'front-left' },
    { distance = 5.0, fovFrom = 30.0, fovTo = 40.0, from = 'front-left',   to = 'left' },
},

Hand-off shot

RetrieveAnimation is the shot used when you confirm a car.

OptionDefaultWhat it does
mode'hero''hero': a short edit with shallow focus on the car. 'slide' and the CameraAnimations format also work
shots{ { shot = 'hero', time = 4000 } }Shots in order: 'headlight', 'wheel', 'hero'. Reorder, drop or retime them
doffalseBlurred background
dofStrength1.0Blur strength
shake0.15Handheld feel (0 = none)
fadeOut800Ms of fade at the end
cardtrueBrand logo and name on black afterwards
cardTime1800How long the card shows (ms)

Music

OptionDefaultWhat it does
enabledtruePlays music on the showcase stage
file'showcase.ogg'File name in web/audio (.ogg, .mp3 or .wav)
volume0.350.0 to 1.0
looptrueLoop the track
fade800Fade in/out in ms

Showcase stage

Collecting a car moves the player to a private scene with the car on a mark and a fixed camera. There is one scene per garage type (car, boat, plane) in Showcase.presets, each with vehicleCoords and a camera (coords, rotation, ped).

OptionDefaultWhat it does
showPlayerfalseShow the player on the stage
backRow{ enabled = false, distance = 7.0, spacing = 3.4, max = 6 }Other vehicles lined up behind the featured car
swapDelay110Settle time (ms) before swapping the featured car while scrolling
preloadNeighbourstrueLoad the cars either side of the highlighted one
modelCache6How many vehicle models to keep loaded while browsing

Recovery

OptionDefaultWhat it does
disconnectGarage'pillboxgarage'Owner disconnected at the wheel: the car goes back to this garage (an id from Garages)
impoundDestroyedtrueDestroyed vehicles go to the impound lot
abandonedMinutes20Vehicles left with nobody in them are impounded after this many minutes (0 disables)
impoundOnStarttrueOn server start, anything still out in the world goes to the lot
returnOnShutdowntrueVehicles being driven at a clean shutdown are returned instead
impoundFeenilRelease fee for vehicles impounded this way (nil uses Impound.fee)
sweepInterval5How often to look for abandoned vehicles, in minutes
debugfalsePrint what is being moved and why

Garages

Each garage in Garages:

FieldWhat it does
labelName shown
type'car', 'plane' or 'boat' (picks the showcase scene)
coordsThe walk-up point
parkThe drive-in mark
spawnsSpawn points; the first free one is used
classesVehicle classes this garage takes
blip{ sprite, colour, scale }
['motelgarage'] = {
    label = 'Motel Parking',
    type = 'car',
    coords = vec3(273.71, -344.24, 44.92),
    park = vec3(285.43, -347.89, 43.95),
    spawns = {
        vec4(285.43, -347.89, 43.95, 161.57),
    },
    classes = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 13, 18, 22 },
    blip = { sprite = 357, colour = 3, scale = 0.7 }
},

Impound

The impound holds vehicles that cannot be collected from a normal garage. The owner walks up to the officer, pays the fee, and the cover over their car is replaced by the car.

OptionDefaultWhat it does
enabledtrueTurns the impound lot on
label'Impound Lot'Name shown
ped.enabledtrueThe officer at the desk
ped.model's_m_y_cop_01'Officer model
ped.coordsvec4(409.9, -1623.29, 29.29, 230.0)Where the officer stands and faces
ped.zOffset0.98Raise if the officer sinks into the ground, lower if they float
ped.scenario'WORLD_HUMAN_CLIPBOARD'Idle animation (false = stands still)
ped.distance50.0How far out the officer is created
interactDistance2.0How close the player must be for the prompt
warpIntoVehiclefalsePut the player straight into the released car
coords / spawnsLot positionFallback hand-back spot when a vehicle had no cover in the lot
fee500Release fee when the police script has not set a price in depotprice (0 = free)
blip{ sprite = 357, colour = 1, scale = 0.7 }Map blip

Covers

OptionDefaultWhat it does
covers.enabledtrueA covered car in a bay for each vehicle the player has impounded (only they see theirs)
covers.modelsprop_entityxf_covered, prop_car_covered_01, prop_car_covered_02Cover props, tried in order; the first that exists is used
covers.distance90.0How far out the covers appear
covers.originvec3(409.9, -1623.29, 29.29)Where that distance is measured from
covers.slotsHand-placed baysBay positions; wins over row
covers.roworigin, spacing = 3.2, count = 8, facing = 0.0Generated line of bays, used only when slots is empty
covers.labelsenabled, distance = 12.0Owner name and plate over each cover (height, scale, background, outline)
covers.clearance2.6A bay with a vehicle this close is left empty
covers.placeOnGroundtrueDrops each cover onto the ground
covers.collisionfalseSolid covers
covers.refreshInterval30000How often the lot re-checks (ms)

Menu layout

OptionDefaultWhat it does
Layout.details{ x = 0.8, y = 22.4, scale = 0.75 }Details panel: x and y are % of the screen from the top left
Layout.list{ x = 78.0, y = 22.4, scale = 0.75 }Vehicle list panel
LayoutEditorfalsetrue: open a garage, drag a panel with left click, resize with the mouse wheel. The layout prints to F8 when you close it. Set back to false when done

Rules

OptionDefaultWhat it does
strictLocationfalsetrue ties a vehicle to the garage it was parked at
retrievalFee0Charged when collecting (0 disables)
blockedClasses{ 13, 14, 15, 16, 21 }Classes that cannot be parked in a public garage

Target

Open garages and talk to the impound officer with a target script instead of pressing E. Parking a car still uses its marker.

OptionDefaultWhat it does
Target.enabledfalseUse a target script
Target.resource'auto''auto' (fusing-target, qb-target or ox_target) or a resource name
Target.distance2.5Target distance

Markers

markers.foot is where you walk up to collect a car, markers.park where you drive in to store one.

FieldWhat it does
typeMarker type: 1 glowing circle, 23 fat flat circle, 25 thin flat circle, 27 split-arrow circle
r, g, b, aColor and opacity
scaleWidth in meters
heightHow far the glow rises
zLifts or drops the marker
markers = {
    foot = { type = 1, r = 255, g = 255, b = 255, a = 100, scale = 1.2, height = 0.5, z = -0.97 },
    park = { type = 1, r = 255, g = 255, b = 255, a = 100, scale = 3.0, height = 0.6, z = -0.02 }
}