QBCore Frameworkqbcore.netCommunity docs
On this page

3 min read

qb-garages

qb-garages stores and retrieves owned vehicles through public, house, gang, job and depot garage flows. The official resource also coordinates vehicle state, damage/fuel restoration and impound behavior.

It does not ship a separate player-purchasable “garage ownership” economy. Do not add garage_ownership tables or purchase APIs unless your chosen fork explicitly implements them.

Current global config

The current upstream config.lua includes:

Config.AutoRespawn = true
Config.VisuallyDamageCars = true
Config.SharedGarages = false
Config.ClassSystem = false
Config.FuelResource = 'LegacyFuel'
Config.Warp = true

These flags control behavior such as restart recovery, visual damage, shared job/gang access, class restrictions, fuel integration and spawn behavior.

Pin your local config to the resource revision you deploy because defaults can change.

Vehicle classes

Current config groups GTA vehicle classes into categories such as:

  • car
  • air
  • sea
  • rig
  • all

Garage entries reference the allowed category/classes. Use the current upstream mapping rather than inventing custom vehicleCategories keys from a different garage fork.

Garage entries

The current config shape includes fields such as:

Config.Garages = {
    motelgarage = {
        label = 'Motel Parking',
        takeVehicle = vector3(...),
        spawnPoint = {
            vector4(...)
        },
        showBlip = true,
        blipName = 'Public Parking',
        blipNumber = 357,
        blipColor = 3,
        type = 'public',
        category = Config.VehicleClass['car']
    }
}

Use the exact current config file for real coordinates and available fields.

Garage types

The official project documents these concepts:

Public garages

Store and retrieve vehicles owned by the player under the public-garage rules.

House garages

qb-houses can add a garage to a house. Current housing code broadcasts house-garage config to qb-garages. Real-estate workflows can use /addgarage according to the upstream implementation.

Job and gang garages

The resource supports job/gang garage access. Config.SharedGarages affects whether these garages are shared or personal under the official implementation.

Depot / impound

Depot garages retrieve vehicles sent to impound. Police workflows can set depot behavior through qb-policejob.

Database

The upstream repository ships player_vehicles.sql and uses the QBCore vehicle ownership/state schema.

Do not copy unrelated tables such as garage_ownership into production because an old guide used them. Apply only schema files/migrations shipped by the revision you deploy.

Back up player_vehicles before schema or garage-resource migrations.

Fuel integration

Current upstream config defaults:

Config.FuelResource = 'LegacyFuel'

The comment expects a fuel resource with compatible GetFuel() and SetFuel() exports. If you use another fuel resource, verify its API rather than only changing the string.

House integration

Current qb-houses server code builds house garage information and sends it through qb-garages client events. Keep both resources at compatible revisions if you rely on house garages.

See qb-houses.

Troubleshooting

SymptomCheck
Vehicle is not listedOwnership record, citizen ID, garage/state columns and current garage rules.
Vehicle goes to depot after restartConfig.AutoRespawn and the stored vehicle state.
Job/gang vehicle inaccessibleGarage type plus job/gang and Config.SharedGarages behavior.
Vehicle spawns with wrong fuelConfig.FuelResource and compatible exports.
House garage missingqb-houses ↔ qb-garages revision compatibility and house garage data.
Config example does not workMake sure it came from the official repository, not a different qb-garages fork.

If you replace qb-garages instead of configuring it, compare garage scripts on RPScripts by declared QBCore version, vehicle table schema and fuel/house integration. RPScripts and qbcore.net are operated by the same owner.

Sources

Verified against current upstream source on 2026-09-27.

Found an issue in this guide?

Send the page URL, the affected example, and a source or reproduction to the site maintainer. For a server or resource problem, use the support guide.

On this page

Leonida RP server website built with RPWebsite
RPWebsite

Advertisement · RPWebsite

Want a website for your server?

Launch a site with live player status, rules, and a join button in minutes.

Build your website