Configuration

All configuration lives in config.lua.

Integrations

Key	Type	Default	Description
Config.FuelSystem	string	'rcore_fuel'	Fuel resource integration for saving/restoring fuel level.
Config.VehicleKeys	string	'qbx_vehiclekeys'	Vehicle keys resource; only the literal value 'none' suppresses giving keys.
Config.UseTarget	boolean	false	If false, uses a DrawText/ox_lib TextUI prompt; if true, uses a target system.
Config.Target	string	'ox_target'	Target resource name used when Config.UseTarget is true.

Interaction

Key	Type	Default	Description
Config.InteractDistance	number	3.5	Distance (m) to trigger the on-foot garage prompt.
Config.InteractDistanceVehicle	number	7.0	Wider distance (m) for vehicle spawn bays.
Config.OpenKey	number	38 (E)	Key code bound to open the prompt when not using a target system.
Config.KeyLabel	string	'E'	Label shown for Config.OpenKey.

Finance

Key	Type	Default	Description
Config.Finance	table	{ enabled = true, allowPayInFull = true }	Vehicle finance integration with jg-dealerships. Requires that resource running and its makeFinancePayment export to exist.

Costs & fees

Key	Type	Default	Description
Config.GarageTransferCost	number	2500	Cost to move a vehicle between garages.
Config.VehicleReturnCost	number	2500	"Towing tax" to return a vehicle left outside.
Config.ReturnCostSociety	string|boolean	false	Job/society paid return fees, or false for none.
Config.ImpoundFeeSociety	string	'police'	Society/job paid impound fees.
Config.PaymentAccounts	table	{ 'cash', 'bank' }	Ordered accounts tried when charging a player.

Behaviour

Key	Type	Default	Description
Config.AllowInfiniteSpawns	boolean	false	If false, a vehicle already out cannot be spawned again.
Config.SaveVehicleDamage	boolean	true	Persist body/engine damage on store.
Config.SaveVehicleProps	boolean	true	Persist mods/props on store.
Config.CheckVehicleModel	boolean	true	Refuse to spawn if stored model doesn't match DB.
Config.PlayerTransferBlacklist	table	{}	Vehicle spawn names that can never be transferred to another player.
Config.VehicleLabels	table	{}	Model → display label overrides for addon vehicles GetLabelText can't resolve.

Commands

Key	Type	Default	Description
Config.ImpoundCommand	string	'iv'	Opens the impound form.
Config.ChangePlateCommand	string	'vplate'	Admin: change a vehicle's plate.
Config.DeleteVehicleCmd	string	'dvdb'	Admin: delete a vehicle from the DB.
Config.ReturnVehicleCmd	string	'vreturn'	Admin: force-return a vehicle to a garage.
Config.ImpoundTimeOptions	table	{ 0, 1, 4, 12, 24, 72, 168 }	Hour options on the impound form (0 = until fee paid).

Blips

Key	Type	Default	Description
Config.ShowGarageBlips	boolean	true	Show garage blips.
Config.ShowImpoundBlips	boolean	true	Show impound blips.
Config.BlipCar	table	{ id = 357, color = 0, scale = 0.7 }	Car garage blip style.
Config.BlipAir	table	{ id = 359, color = 0, scale = 0.7 }	Air garage blip style.
Config.BlipSea	table	{ id = 356, color = 0, scale = 0.7 }	Sea garage blip style.
Config.BlipImpound	table	{ id = 68, color = 0, scale = 0.7 }	Impound blip style.

Locations

Key	Type	Default	Description
Config.Garages	table	—	Personal garage definitions keyed by id: { coords, spawn, distance, type }. Keys are stored verbatim as garage_id in the DB — renaming a key requires a manual DB update.
Config.JobGarages	table	—	Job garages keyed by name: { coords, spawn, distance, type, jobs, vehiclesType }. vehiclesType = 'owned' pulls society vehicles from the DB; 'spawner' spawns a fixed fleet via the showroom UI, and supports label, jobLabel, previewCoords, trunkLoadout/gloveboxLoadout, and vehicles ({ model, plate, minGrade, nickname, livery, trunk, glovebox }).
Config.GangGarages	table	—	Gang garages keyed by name: { coords, spawn, distance, type, gangs, vehiclesType } (only 'personal' is used).
Config.Impounds	table	{}	Impound lot definitions.
Config.Showroom	table	—	Global showroom camera config used when no per-garage previewCoords is set: previewCoords, camDistance/camMinDist/camMaxDist, camHeight/lookHeight, zoomStep, dragSpeed, autoRotate, autoRotateSpeed, autoRotateDelay.
Config.ImpoundJobs	table	{ 'police', 'bcso' }	Jobs permitted to use the impound command.
Config.ImpoundReleaseExternal	string	'legacy-sadot'	External resource name handling impound releases instead of Config.Impounds. Set to false to use the built-in flow.
Config.ImpoundReleaseExternalMessage	string	'Impounded vehicles are released by SADOT, at their yard.'	Message shown when release is external.
Config.ClassTypes	table	{ [8]='car', [13]='car', [14]='sea', [15]='air', [16]='air', [21]='car' }	Maps GTA vehicle class IDs to garage type. Unlisted classes have no defined mapping.

Notes

• Renaming a Config.Garages key requires a manual UPDATE on existing player_vehicles.garage_id rows, or those vehicles will point at a garage that no longer exists.
• trunkLoadout/gloveboxLoadout item ids must already exist in ox_inventory; unknown ids surface as a startup error, not a silent no-op.
• Mixing up vehiclesType values on a job garage changes its whole interaction flow ('spawner' → showroom UI, 'owned' → standard list UI).