Locations & Zones

Default Locations

ORB Customs ships with 8 pre-configured locations across the GTA V map:

Adding a New Location

Add entries to the locations table in data/config.lua:

{
    pos = vector4(x, y, z, heading),
    blip = {
        sprite = 72,        -- Blip icon (72 = mod shop)
        scale = 0.5,         -- Blip size on map
        color = 27,          -- Blip color
        shortRange = true,   -- Only visible when nearby
        label = 'Customs',   -- Blip name
    },
    free = false,            -- Set true for free modifications
    mods = {'decals', 'paint'},  -- Restrict to specific categories (optional)
    -- group = { mechanic = 0 },  -- Restrict to job (optional)
    -- classes = { 0, 1, 2 },     -- Restrict to vehicle classes (optional)
},

Location Options

`free`

When true, all modifications at this location cost nothing. Useful for mechanic job garages.

`mods`

Optional table to restrict which modification categories are available. If omitted, all categories are available. Valid values: 'decals', 'paint', 'performance', 'wheels', 'horns', 'stance'.

`group`

Optional job restriction. Only players with the specified job and minimum grade can access the shop:

group = {
    mechanic = 0,   -- Job 'mechanic', grade 0+
    police = 2,     -- Job 'police', grade 2+
}

`classes`

Optional vehicle class restriction. Only vehicles of the specified classes can enter:

-- GTA V Vehicle Classes:
-- 0 = Compacts, 1 = Sedans, 2 = SUVs, 3 = Coupes,
-- 4 = Muscle, 5 = Sports Classics, 6 = Sports, 7 = Super,
-- 8 = Motorcycles, 9 = Off-road, 10 = Industrial,
-- 11 = Utility, 12 = Vans, 13 = Cycles, 18 = Emergency
classes = { 0, 1, 2, 3, 4, 5, 6, 7 }

Blip Configuration

If a location does not have a blip table, it inherits the default blip settings from the top-level blip config. Set blip = false to hide the blip entirely for a specific location.

Customization Interior

All players are teleported to the same interior coordinates (customizationLocation in config) but placed in separate routing buckets. This means they cannot see each other during customization. The interior is an underground tunnel that ships with GTA V — no additional MLO is required.