Configuration

Shop Locations

Where shops appear, their blips and which catalog they sell.

Config.ShopLocations is the list of every physical shop. Each entry places a marker + blip and links to a catalog. The resource ships with 20 locations already configured and selling.

config.lua

Config.ShopLocations = {
    { id = 'ltd_1', label = 'LTD Gasoline', coords = vector4(1698.8218, 4924.1602, 42.0637, 144.1559), catalog = 'convenience', blip = { sprite = 52, color = 5, label = 'LTD Gasoline' } },
    -- ...
}

Location fields

Field	Type	Required	Description
`id`	`string`	Yes	Unique identifier for the shop. No duplicates.
`label`	`string`	Yes	Shop name shown in the UI header.
`coords`	`vector4`	Yes	`vector4(x, y, z, heading)` of the shop.
`catalog`	`string`	Yes	Which `Config.ShopCatalogs` entry it sells.
`blip`	`table`	No	Map blip settings (see below).

Blip fields

Field	Type	Description
`enabled`	`boolean`	Show the blip. Defaults to `true` if omitted.
`sprite`	`number`	Blip icon id.
`color`	`number`	Blip color id.
`scale`	`number`	Blip size. Defaults to `0.7`.
`label`	`string`	Blip name on the map. Defaults to the location `label`.

Blip sprites & colors: docs.fivem.net — Blips.

The 20 included shops

Chain	Count	Catalog	Blip sprite / color
LTD Gasoline	5	`convenience`	`52` / `5`
Rob's Liquor	6	`liquor`	`93` / `27`
24/7 Market	9	`convenience`	`52` / `2`

Adding a shop

Append an entry. Pick a unique id, set the coords, and choose a catalog:

config.lua

{ id = '247_10', label = '24/7 Market', coords = vector4(-1820.5, 792.3, 138.1, 130.0), catalog = 'convenience', blip = { sprite = 52, color = 2, label = '24/7 Market' } },

Removing a shop

Delete its line (or comment it out with --). Restart the resource.

Getting coordinates

Stand where you want the shop in-game and use a coords tool, then paste the x, y, z plus a heading into vector4(...).

Optional per-location overrides

Any location can override defaults by adding these optional fields:

config.lua

{
    id = 'ltd_1',
    label = 'LTD Gasoline',
    coords = vector4(1698.8218, 4924.1602, 42.0637, 144.1559),
    catalog = 'convenience',
    blip = { sprite = 52, color = 5, label = 'LTD Gasoline' },

    -- optional overrides:
    paymentMethods = { 'card' },               -- only card here
    jobs = { 'police' },                        -- restrict to police
    minJobGrade = 2,                            -- minimum grade
    marker = { color = { r = 50, g = 120, b = 255, a = 180 } }, -- blue marker
},

Override	See
`paymentMethods`	Payments
`jobs` / `minJobGrade`	Job Restrictions
`marker`	Markers

Overrides are optional. Leave them out and the location inherits the global defaults.

Report an issue

Catalogs & Items

Define reusable item lists shared across shops.

Color Scheme

Recolor the whole UI from variables.css.