esx_garage

esx_garage is the ESX Legacy garage and impound system. Players park owned vehicles at garages, take them out again through a React UI, favorite, rename or transfer them, and pay a fee to recover vehicles from an impound lot. Version 2.0 replaced the old marker-based config completely, so configs from older versions do not work.

OverviewCopy Anchor Link

Features in-game:

• Garages with an entry point (opens the menu), an optional store point and an optional NPC.
• Impound lots with a per-lot fee. The fee is taken from cash first, then from the bank.
• Paginated vehicle list with search and filters (stored, impounded, favorite).
• Rename and favorite vehicles, transfer a stored vehicle to a player within 10 m.
• Optional "give keys" hook for a key script.

Vehicle stateCopy Anchor Link

A vehicle that is out (stored = 0) but whose entity no longer exists can only be recovered at an impound, never at a garage. Before respawning it the server deletes every live entity with that plate, so it cannot be duplicated.

InstallationCopy Anchor Link

ensure oxmysql
ensure esx_lib
ensure es_extended
ensure esx_garage

ConfigurationCopy Anchor Link

Config.SettingsCopy Anchor Link

Config.Locale defaults to GetConvar('esx:locale', 'en').

Config.GaragesCopy Anchor Link

A list of garages. Defaults: vespucci_boulevard and san_andreas_avenue.

Config.Garages[#Config.Garages + 1] = {
    id = 'mrpd',
    label = 'Mission Row PD',
    type = 'job',
    entryPoint = vec3(454.6, -1017.4, 28.4),
    storePoint = vec3(447.6, -1021.5, 28.5),
    spawns = { vec4(438.4, -1018.3, 27.7, 90.0) },
    blip = { sprite = 357, scale = 0.8, color = 38 },
    access = { jobs = { police = 0 } },
    pound = 'los_santos',
}

Config.ImpoundsCopy Anchor Link

Defaults: los_santos, paleto_bay, sandy_shores, each with cost = 3000. The first entry is the default lot for automatic impounds.

Server exportsCopy Anchor Link

registerGarageCopy Anchor Link

exports.esx_garage:registerGarage(garage)

Adds or replaces a garage at runtime and refreshes all clients. Throws (via assert) if id, entryPoint or spawns are missing or invalid. Use it for property or gang garages created by other resources.

exports.esx_garage:registerGarage({
    id = 'apartment_12',
    label = 'Apartment 12',
    type = 'public',
    entryPoint = vec3(-796.1, 304.4, 85.7),
    spawns = { vec4(-791.6, 300.3, 85.4, 180.0) },
    access = {
        authorize = function(source)
            return exports.my_housing:isTenant(source, 12)
        end,
    },
})

registerGaragesCopy Anchor Link

exports.esx_garage:registerGarages(list)

Calls registerGarage for every entry in list.

unregisterGarageCopy Anchor Link

exports.esx_garage:unregisterGarage(id)

Removes a garage by id and refreshes clients. Vehicles parked there remain available at any garage.

getGarages / getImpoundsCopy Anchor Link

local garages = exports.esx_garage:getGarages()
local impounds = exports.esx_garage:getImpounds()

Return arrays of all registered garages and impound lots (including runtime registrations).

impoundVehicleCopy Anchor Link

local ok = exports.esx_garage:impoundVehicle(plate, lotId)

Deletes the live vehicle if it exists and marks it impounded. Returns true when the database row is in the impound afterwards. Typical use: a police or tow job command.

ESX.RegisterCommand('impound', 'admin', function(xPlayer, args)
    local ok = exports.esx_garage:impoundVehicle(args.plate, 'los_santos')
    xPlayer.showNotification(ok and 'Vehicle impounded' or 'Impound failed')
end, false, {
    help = 'Impound a vehicle by plate',
    arguments = { { name = 'plate', help = 'Plate', type = 'string' } },
})

Server events (hooks)Copy Anchor Link

Local server events you can listen to with AddEventHandler. They cannot be triggered by clients.

AddEventHandler('esx_garage:giveKeys', function(source, plate)
    exports.my_keys:giveKey(source, plate)
end)

CallbacksCopy Anchor Link

The UI talks to the server through these callbacks. Each is rate limited (1 to 1.5 s) and checks ownership, distance and garage access on the server, so they are safe against spoofed clients. They return { success = boolean, error = string? }.

The client event esx_garage:refresh rebuilds blips and points; it is also triggered on esx:playerLoaded and esx:setJob.

Integration tipsCopy Anchor Link

• Vehicles bought in esx_vehicleshop land in owned_vehicles and show up automatically.
• The garage list does not filter by the vehicle type column, so boats and aircraft appear in every garage. Use separate garages with access if that matters.
• Despawning an owned vehicle with another script sends it to the default impound. Store it through esx_garage or call impoundVehicle with the right lot.
• The maxVehicles field from the type annotations is not enforced by the current code.

Common issuesCopy Anchor Link

• Old config does not load: v2 uses Config.Settings, Config.Garages as a list with id/entryPoint/spawns, and Config.Impounds with getOutPoint. Config.DrawDistance, Config.Markers and the old EntryPoint/SpawnPoint keys are gone.
• no_money at the impound: the player has neither enough cash nor enough bank money for the fee.
• wrong_garage: restrictToGarage is on and the vehicle is parked elsewhere.
• model_mismatch or plate_mismatch when storing: the vehicle entity does not match the owned record (for example after a plate change by another script).
• Every vehicle impounded after restart: expected, see the FAQ below.

RelatedCopy Anchor Link

• esx_vehicleshop
• esx_property
• Database schema
• oxmysql

Frequently asked questions