Configuration
Everything is in config/garages.lua.
| Option | Default | What it does |
|---|
BucketBase | 300000 | Private showcase worlds use this + player id; keep clear of other scripts' buckets |
Camera
| Option | Default | What it does |
|---|
enabled | true | Turns the showcase camera on |
browseDuration | 6500 | Length of one browsing angle (ms) |
retrieveDuration | 6000 | Length of the hand-off shot when you confirm a vehicle (ms) |
order | 'random' | 'random' picks an angle each time, 'sequential' walks the list |
sceneFov | 45.0 | Field of view of the showcase camera: 60 is a wide room shot, 45 tighter, 35 close |
pullback | 1.0 | Slides the camera along its view: positive pulls back, negative pushes in |
skippable | true | Cancel 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.
| Option | Default | What 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 |
dof | false | Blurred background |
dofStrength | 1.0 | Blur strength |
shake | 0.15 | Handheld feel (0 = none) |
fadeOut | 800 | Ms of fade at the end |
card | true | Brand logo and name on black afterwards |
cardTime | 1800 | How long the card shows (ms) |
Music
| Option | Default | What it does |
|---|
enabled | true | Plays music on the showcase stage |
file | 'showcase.ogg' | File name in web/audio (.ogg, .mp3 or .wav) |
volume | 0.35 | 0.0 to 1.0 |
loop | true | Loop the track |
fade | 800 | Fade 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).
| Option | Default | What it does |
|---|
showPlayer | false | Show the player on the stage |
backRow | { enabled = false, distance = 7.0, spacing = 3.4, max = 6 } | Other vehicles lined up behind the featured car |
swapDelay | 110 | Settle time (ms) before swapping the featured car while scrolling |
preloadNeighbours | true | Load the cars either side of the highlighted one |
modelCache | 6 | How many vehicle models to keep loaded while browsing |
Recovery
| Option | Default | What it does |
|---|
disconnectGarage | 'pillboxgarage' | Owner disconnected at the wheel: the car goes back to this garage (an id from Garages) |
impoundDestroyed | true | Destroyed vehicles go to the impound lot |
abandonedMinutes | 20 | Vehicles left with nobody in them are impounded after this many minutes (0 disables) |
impoundOnStart | true | On server start, anything still out in the world goes to the lot |
returnOnShutdown | true | Vehicles being driven at a clean shutdown are returned instead |
impoundFee | nil | Release fee for vehicles impounded this way (nil uses Impound.fee) |
sweepInterval | 5 | How often to look for abandoned vehicles, in minutes |
debug | false | Print what is being moved and why |
Garages
Each garage in Garages:
| Field | What it does |
|---|
label | Name shown |
type | 'car', 'plane' or 'boat' (picks the showcase scene) |
coords | The walk-up point |
park | The drive-in mark |
spawns | Spawn points; the first free one is used |
classes | Vehicle 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.
| Option | Default | What it does |
|---|
enabled | true | Turns the impound lot on |
label | 'Impound Lot' | Name shown |
ped.enabled | true | The officer at the desk |
ped.model | 's_m_y_cop_01' | Officer model |
ped.coords | vec4(409.9, -1623.29, 29.29, 230.0) | Where the officer stands and faces |
ped.zOffset | 0.98 | Raise if the officer sinks into the ground, lower if they float |
ped.scenario | 'WORLD_HUMAN_CLIPBOARD' | Idle animation (false = stands still) |
ped.distance | 50.0 | How far out the officer is created |
interactDistance | 2.0 | How close the player must be for the prompt |
warpIntoVehicle | false | Put the player straight into the released car |
coords / spawns | Lot position | Fallback hand-back spot when a vehicle had no cover in the lot |
fee | 500 | Release 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
| Option | Default | What it does |
|---|
covers.enabled | true | A covered car in a bay for each vehicle the player has impounded (only they see theirs) |
covers.models | prop_entityxf_covered, prop_car_covered_01, prop_car_covered_02 | Cover props, tried in order; the first that exists is used |
covers.distance | 90.0 | How far out the covers appear |
covers.origin | vec3(409.9, -1623.29, 29.29) | Where that distance is measured from |
covers.slots | Hand-placed bays | Bay positions; wins over row |
covers.row | origin, spacing = 3.2, count = 8, facing = 0.0 | Generated line of bays, used only when slots is empty |
covers.labels | enabled, distance = 12.0 | Owner name and plate over each cover (height, scale, background, outline) |
covers.clearance | 2.6 | A bay with a vehicle this close is left empty |
covers.placeOnGround | true | Drops each cover onto the ground |
covers.collision | false | Solid covers |
covers.refreshInterval | 30000 | How often the lot re-checks (ms) |
Menu layout
| Option | Default | What 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 |
LayoutEditor | false | true: 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
| Option | Default | What it does |
|---|
strictLocation | false | true ties a vehicle to the garage it was parked at |
retrievalFee | 0 | Charged 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.
| Option | Default | What it does |
|---|
Target.enabled | false | Use a target script |
Target.resource | 'auto' | 'auto' (fusing-target, qb-target or ox_target) or a resource name |
Target.distance | 2.5 | Target distance |
Markers
markers.foot is where you walk up to collect a car, markers.park where you drive in to store one.
| Field | What it does |
|---|
type | Marker type: 1 glowing circle, 23 fat flat circle, 25 thin flat circle, 27 split-arrow circle |
r, g, b, a | Color and opacity |
scale | Width in meters |
height | How far the glow rises |
z | Lifts 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 }
}