🛒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,},
    },
},

Last updated 20 days ago