🛒Stores

• You can easily add custom stores to purchase outfits from by defining the shop name and relevant information required in Config.Stores

• You can define custom images for the store (host images using fivemerr or similar)

• Choose between a spawned ped or a target circle zone for interaction

• Define restrictions if required

---

Outfit Store

• The key is the shop name and must be unique

['My Custom Outfit Store'] = { -- the key is the store name
    --
},

---

Info

• To disable a store set enabled to false

• Define an image URL for the shop logo (host using fivemerr or similar)

• Icon is the target icon

• Label is the target label

• Distance is the target distance (do not set this higher than Config.Security.MaxDistance as it will result in false security warnings and checks)

• Define restrictions based on job or gang requirements by defining their respective names if enabled

• Names for jobs and gangs must be in your jobs.lua and gangs.lua respectively

['My Custom Outfit Store'] = { -- the key is the store name
    info = { -- info settings
        enabled = true, -- enable this shop
        imageURL = 'https://files.fivemerr.com/images/d4e20c2d-9020-4c26-83f1-afe3de6c92b0.png',
        icon = 'fa-solid fa-hand-point-up', -- target icon
        label = 'Open Outfit Store', -- target label
        distance = 3.0, -- target distance
        access = { -- define store access
            job = { -- job access
                enabled = false, -- enable a job to access this store
                name = { 'my_job_name', }, -- job name
            },
            gang = { -- gang access
                enabled = false, -- eanble a gang to access this store
                name = { 'my_gang_name', },  -- gang name
            },
        },
    },
    --other options
},

---

Blips

• Define blips for each store if enabled. Blips can be found here: https://docs.fivem.net/docs/game-references/blips/

• ID is the blip id

• Colour is the blip colour

• Scale is the blip scale

• Title is the blip name

['My Custom Outfit Store'] = { -- the key is the store name
    --
    blips = { -- blip settings for shop
        enabled = true, -- blip enabled
        id = 52, -- blip id
        colour = 2, -- blip colour
        scale = 0.6, -- bliip scale
        title = 'My Custom Outfit Store', -- blip title
    },
    --
},

---

Interaction Peds / Zones

• If set to enabled then a ped will spawn at the shop

• If set to false a circle zone will spawn at the shop

• If using the ped define the model to spawn

• Define coordinates for the shop locations - these must be vector4

['My Custom Outfit Store'] = { -- the key is the store name
    --
    ped = {
        enabled = true, -- set to true to enable a ped otherwise spawns a circleZone to target
        model = 'mp_m_securoguard_01', -- ped model
        coords = { -- coords must be vector4
            vector4(458.11, -992.34, 30.69, 51.59),
            vector4(-447.18, 6008.2, 31.72, 358.72),
            --add more locations as required
        },
    },
    --
},

---

Inventory

• Define items available to purchase at this store and its respective price

• Name is the item name and must be in your items.lua and also defined in Config.Outfits

• Price is the price to purchase that item. Prices can also be set to 0 for free items

['My Custom Outfit Store'] = { -- the key is the store name
    --
    inventory = { -- define items and their price
        {name = 'my_custom_outfit1', price = 10,},
        {name = 'my_custom_outfit2', price = 50,},
    },
},

---

Finished Config

• Below is what a finished config should look like for a custom outfit store with no job or gang restrictions

['My Custom Outfit Store'] = { -- the key is the store name
    info = { -- info settings
        enabled = true, -- enable this shop
        imageURL = 'https://files.fivemerr.com/images/d4e20c2d-9020-4c26-83f1-afe3de6c92b0.png',
        icon = 'fa-solid fa-hand-point-up', -- target icon
        label = 'Open Outfit Store', -- target label
        distance = 3.0, -- target distance
        access = { -- define store access
            job = { -- job access
                enabled = false, -- enable a job to access this store
                name = { 'my_job_name', }, -- job name
            },
            gang = { -- gang access
                enabled = false, -- eanble a gang to access this store
                name = { 'my_gang_name', },  -- gang name
            },
        },
    },
    blips = { -- blip settings for shop
        enabled = true, -- blip enabled
        id = 52, -- blip id
        colour = 2, -- blip colour
        scale = 0.6, -- bliip scale
        title = 'My Custom Outfit Store', -- blip title
    },
    ped = {
        enabled = true, -- set to true to enable a ped otherwise spawns a circleZone to target
        model = 'mp_m_securoguard_01', -- ped model
        coords = { -- coords must be vector4
            vector4(458.11, -992.34, 30.69, 51.59),
            vector4(-447.18, 6008.2, 31.72, 358.72),
            --add more locations as required
        },
    },
    inventory = { -- define items and their price
        {name = 'my_custom_outfit1', price = 10,},
        {name = 'my_custom_outfit2', price = 50,},
    },
},