NextGenFiveM Docs

Configuring a New Store Type

To add a new store type, follow these steps:

Open the config.lua file in the resource folder.
Find the Config.Stores table.
Add a new store entry with this structure:

Config.Stores = {
    ...
    {
        name = 'store_name',
        title = 'Store Title',
        logo = 'https://example.com/images/store_logo.png',
        colors = {
            bg = 'rgba(100, 100, 100, .3)',
            bgGradient = 'rgba(4, 180, 71, 0.2)',
            primary = 'rgb(4, 180, 7)',
            text = '#fff',
            colorCode = '~g~'
        },
        categories = {
            {
                title = 'category_title',
                products = {
                    {
                        label = 'Product Label',
                        name = 'item_name',
                        price = 10.0,
                        image = 'https://example.com/images/product_image.png'
                    },
                }
            },
        },
        blip = {
            sprite = 59,
            scale = 0.8,
            color = 2
        },
        ped = {
            model = `mp_m_shopkeep_01`,
            animation = {
                dict = 'anim@mp_corona_idles@male_d@idle_a',
                anim = 'idle_a'
            }
        },
        locations = {
            vector4(x, y, z, heading)
        }
    },
}

Customization Guide

name – Unique identifier for the store.
title – The displayed store name.
logo – URL of the store’s logo.
colors – Customize the UI colors.
categories – Add store categories and products.
blip – Set the map blip properties.
ped – Define the store NPC and animation.
locations – Specify where the store appears.

After making changes, save the file and restart the resource.

Adding Store Locations

To add a new location to an existing store type:

Open config.lua.
Locate the relevant store in Config.Stores.
Add a new entry to the locations array:

locations = {
    ...
    vector4(x, y, z, heading)
}

Replace x, y, z, heading with the store’s coordinates.
Save the file and restart the resource.

Translating the Store System

To change the store system language:

Open config.lua.
Locate Config.lang.
Replace the existing text with your desired translations.
Save the file and restart the resource.

Store Configuration Reference

Store Table Properties

Prop	Type	Default
`name`	`string`	-
`title`	`string`	-
`logo`	`string`	-
`colors`	`Color Table`	-
`categories`	`Category Table`	-
`blip`	`Blip Table`	-
`ped`	`Ped Table`	-
`locations`	`vector4[]`	-

Color Table Properties

Prop	Type	Default
`bg`	`string`	-
`bgGradient`	`string`	-
`primary`	`string`	-
`text`	`string`	-
`colorCode`	`string`	-

Category Table Properties

Prop	Type	Default
`title`	`string`	-
`products`	`Product Table[]`	-

Product Table Properties

Prop	Type	Default
`label`	`string`	-
`name`	`string`	-
`price`	`number`	-
`image`	`string`	-

Blip Table Properties

Prop	Type	Default
`sprite`	`number`	-
`scale`	`number`	-
`color`	`number`	-

Configuration

On this page