Configuration — foltone_garage

Configuration is split across two files: Config.lua (general options) and config_garage.lua (garages, pounds, service vehicles).

Config.lua — General options

Framework

Config.Framework = "esx" -- "esx", "qbcore" or "qbx"

Locale

Config.Locale = "en" -- "en" or "fr"

Translations are located in locales/en.lua and locales/fr.lua. You can add your own language by creating a new file.

Menu type

Config.MenuType = "nui" -- "nui" or "rageui"

The "rageui" mode does not support custom vehicle labels.

Interaction type

Config.InteractionType = "ox_target" -- 5 options available

Interaction distance

Config.InteractionDistance = 2.5

Distance in meters to trigger interaction (drawtext and marker modes only).

Draw text (drawtext mode)

Config.DrawText = {
    label = "interact_label", -- locale key
}

Marker (marker mode)

Config.Marker = {
    type = 1,
    scale = vector3(1.0, 1.0, 0.5),
    color = { r = 59, g = 130, b = 246, a = 120 },
}

PED

Config.Ped = {
    model = "a_m_y_business_03",
    scenario = "WORLD_HUMAN_STAND_IMPATIENT",
}

Blip

Config.Blip = {
    enabled = true,
    sprite = 357,
    color = 3,
    scale = 0.7,
}

Pound system

Config.Pound = {
    basePrice = 500,
    pricePerHour = 100,
    maxPrice = 5000,
    minPrice = 200,
}

The price is calculated dynamically based on the time elapsed since impoundment.

Custom label

Config.Label = {
    maxLength = 30,
}

config_garage.lua — Garages and pounds

Default garage names

ConfigGarage.defaultGarageCarName = "garage"
ConfigGarage.defaultGarageBoatName = "garage_bateau1"
ConfigGarage.defaultGaragePlaneName = "garage_plane1"
ConfigGarage.defaultGarageHeliName = "garage_heli1"

These names correspond to the garages where vehicles will be placed when stored from a garage with saveGarage = false.

Garage entry structure

{
    garageName = "garage",           -- unique identifier (lowercase, no spaces)
    garageLabel = "Downtown Garage", -- label shown in the menu
    saveGarage = true,               -- save vehicles to this garage in DB
    job = nil,                       -- required job (exclusive access for this job)
    job2 = nil,                      -- secondary job (gang / alternative job)
    annyJob = nil,                   -- restrict access to ANY grade of this job
    -- maxVehicles = 10,             -- vehicle limit (optional, comment out for unlimited)
    distanceStore = 25.0,            -- storage radius in meters
    positionMenu = vector3(x, y, z), -- PED / interaction position
    spawnVehPositions = {
        vector4(x, y, z, heading),   -- vehicle spawn positions
    },
    storeVeh = vector3(x, y, z),     -- vehicle storage zone
}

Service vehicles

For job garages, you can define service vehicles accessible from the Store tab (or the corresponding sub-menu in RageUI):

serviceVehicles = {
    { model = "police",  label = "Police Cruiser" },
    { model = "police2", label = "Police Buffalo" },
},

Service vehicles are only available to players with the required job. They are not saved to the database.

Custom blip color per garage

blipColor = 38,
color = {r = 20, g = 100, b = 80},

Vehicle types

Vehicles are organized into 4 categories:

Each type can be enabled or disabled:

["car"] = {
    enable = true,
    positionGarageList = { ... },
},

Adding a garage

Add an entry to the positionGarageList array of the desired type:

{
    garageName = "my_garage",
    garageLabel = "My New Garage",
    saveGarage = true,
    job = nil,
    job2 = nil,
    annyJob = nil,
    distanceStore = 25.0,
    positionMenu = vector3(x, y, z),
    spawnVehPositions = {
        vector4(x, y, z, 0.0),
    },
    storeVeh = vector3(x, y, z)
},

Pounds (poundList)

ConfigGarage.poundList = {
    ["car"] = {
        ["pound_car_1"] = {
            label = "Davis Pound",
            positionMenu = vector3(x, y, z),
            spawnVehPositions = { vector4(x, y, z, heading) },
        },
    },
    ["boat"] = { ... },
    ["plane"] = { ... },
    ["heli"] = { ... },
}

Adding a pound

Add an entry to the desired vehicle type array:

["pound_car_3"] = {
    label = "North Pound",
    positionMenu = vector3(x, y, z),
    spawnVehPositions = { vector4(x, y, z, 0.0) },
},

The key must be unique per vehicle type (e.g. "pound_car_3", "pound_boat_2").