Store

📄 Fields:

Field	Type	Required	Description
`id`	`string`	✅	Unique identifier for the store.
`type`	`'buy'` or `'sell'`	✅	Determines whether the store is for buying or selling.
`name`	`string`	✅	Store display name (e.g. `"24/7 Store"`).
`description`	`string`	✅	Short UI description shown at the top of the store interface.
`icon`	`string (FontAwesomeIcon)`	✅	Icon shown in the UI (FontAwesome class name).
`modelType`	`'ped'` \| `'vehicle'` \| `'object'`	❌	Type of entity used to spawn the store.
`models`	`string[]`	✅	Array of model names (e.g. `"s_m_m_storeclerk_01"`).
`locations`	`vector4[]`	✅	Array of spawn locations with heading.
`paymentMethods`	`string[]`	✅	IDs referencing valid payment methods.
`categories`	`category[]`	❌	List of item categories shown in the UI.
`stock`	`stockItem[]`	✅	Inventory for the store.
`openingHours`	`[number, number]`	❌	Time range when store is available (e.g. `{6, 22}` for 6AM–10PM).
`groups`	`string` \| `string[]` \| `Record<string, number>`	❌	Job, gang, or grade restrictions.
`licenses`	`string` \| `string[]`	❌	Player must have these licenses to access the store.
`discordRoles`	`string` \| `string[]`	❌	Discord roles required to open the store.
`canOpen`	`function(src: number)`	❌	Server-side function to determine if the player can open the store.
`theme`	`themeObject`	❌	Optional override for this store’s visual theme.
`onExchange`	`function(src, items, totalPrice)`	❌	Called on attempted transaction. Return `false` to cancel. Return a second param as reason.

💡 Example

lua
BaseStores = BaseStores or {}
BaseStore.gunshop = {
    id          = "gunshop",
    type        = "buy",
    name        = "Ammu-Nation",
    description = "Everything you need to stay protected.",
    icon        = "fa-solid fa-gun",
    modelType   = "ped",
    models      = { "s_m_m_ammucountry" },
    locations   = {
        vec4(17.8, -1108.6, 29.8, 160.0)
    },
    paymentMethods = { "cash", "bank" },
    categories  = { 
        {
            
        }
    },
    stock       = {
        { item = "pistol", price = 2500 },
        { item = "pistol_ammo", price = 100 }
    },
    openingHours = { 9, 21 },
    groups       = { police = 0, sheriff = 0 },
    licenses     = { "weapon_license" },
    canOpen      = function(src)
        return true
    end,
    onExchange   = function(src, items, price)
        if price > 10000 then
            return false, "Transaction limit exceeded"
        end
        return true
    end
}

Types

Store

📄 Fields:

Field	Type	Required	Description
`id`	`string`	✅	Unique identifier for the store.
`type`	`'buy'` or `'sell'`	✅	Determines whether the store is for buying or selling.
`name`	`string`	✅	Store display name (e.g. `"24/7 Store"`).
`description`	`string`	✅	Short UI description shown at the top of the store interface.
`icon`	`string (FontAwesomeIcon)`	✅	Icon shown in the UI (FontAwesome class name).
`modelType`	`'ped'` \| `'vehicle'` \| `'object'`	❌	Type of entity used to spawn the store.
`models`	`string[]`	✅	Array of model names (e.g. `"s_m_m_storeclerk_01"`).
`locations`	`vector4[]`	✅	Array of spawn locations with heading.
`paymentMethods`	`string[]`	✅	IDs referencing valid payment methods.
`categories`	`category[]`	❌	List of item categories shown in the UI.
`stock`	`stockItem[]`	✅	Inventory for the store.
`openingHours`	`[number, number]`	❌	Time range when store is available (e.g. `{6, 22}` for 6AM–10PM).
`groups`	`string` \| `string[]` \| `Record<string, number>`	❌	Job, gang, or grade restrictions.
`licenses`	`string` \| `string[]`	❌	Player must have these licenses to access the store.
`discordRoles`	`string` \| `string[]`	❌	Discord roles required to open the store.
`canOpen`	`function(src: number)`	❌	Server-side function to determine if the player can open the store.
`theme`	`themeObject`	❌	Optional override for this store’s visual theme.
`onExchange`	`function(src, items, totalPrice)`	❌	Called on attempted transaction. Return `false` to cancel. Return a second param as reason.

💡 Example

lua
BaseStores = BaseStores or {}
BaseStore.gunshop = {
    id          = "gunshop",
    type        = "buy",
    name        = "Ammu-Nation",
    description = "Everything you need to stay protected.",
    icon        = "fa-solid fa-gun",
    modelType   = "ped",
    models      = { "s_m_m_ammucountry" },
    locations   = {
        vec4(17.8, -1108.6, 29.8, 160.0)
    },
    paymentMethods = { "cash", "bank" },
    categories  = { 
        {
            
        }
    },
    stock       = {
        { item = "pistol", price = 2500 },
        { item = "pistol_ammo", price = 100 }
    },
    openingHours = { 9, 21 },
    groups       = { police = 0, sheriff = 0 },
    licenses     = { "weapon_license" },
    canOpen      = function(src)
        return true
    end,
    onExchange   = function(src, items, price)
        if price > 10000 then
            return false, "Transaction limit exceeded"
        end
        return true
    end
}

Types

Store

📄 Fields:

Field	Type	Required	Description
`id`	`string`	✅	Unique identifier for the store.
`type`	`'buy'` or `'sell'`	✅	Determines whether the store is for buying or selling.
`name`	`string`	✅	Store display name (e.g. `"24/7 Store"`).
`description`	`string`	✅	Short UI description shown at the top of the store interface.
`icon`	`string (FontAwesomeIcon)`	✅	Icon shown in the UI (FontAwesome class name).
`modelType`	`'ped'` \| `'vehicle'` \| `'object'`	❌	Type of entity used to spawn the store.
`models`	`string[]`	✅	Array of model names (e.g. `"s_m_m_storeclerk_01"`).
`locations`	`vector4[]`	✅	Array of spawn locations with heading.
`paymentMethods`	`string[]`	✅	IDs referencing valid payment methods.
`categories`	`category[]`	❌	List of item categories shown in the UI.
`stock`	`stockItem[]`	✅	Inventory for the store.
`openingHours`	`[number, number]`	❌	Time range when store is available (e.g. `{6, 22}` for 6AM–10PM).
`groups`	`string` \| `string[]` \| `Record<string, number>`	❌	Job, gang, or grade restrictions.
`licenses`	`string` \| `string[]`	❌	Player must have these licenses to access the store.
`discordRoles`	`string` \| `string[]`	❌	Discord roles required to open the store.
`canOpen`	`function(src: number)`	❌	Server-side function to determine if the player can open the store.
`theme`	`themeObject`	❌	Optional override for this store’s visual theme.
`onExchange`	`function(src, items, totalPrice)`	❌	Called on attempted transaction. Return `false` to cancel. Return a second param as reason.

💡 Example

lua
BaseStores = BaseStores or {}
BaseStore.gunshop = {
    id          = "gunshop",
    type        = "buy",
    name        = "Ammu-Nation",
    description = "Everything you need to stay protected.",
    icon        = "fa-solid fa-gun",
    modelType   = "ped",
    models      = { "s_m_m_ammucountry" },
    locations   = {
        vec4(17.8, -1108.6, 29.8, 160.0)
    },
    paymentMethods = { "cash", "bank" },
    categories  = { 
        {
            
        }
    },
    stock       = {
        { item = "pistol", price = 2500 },
        { item = "pistol_ammo", price = 100 }
    },
    openingHours = { 9, 21 },
    groups       = { police = 0, sheriff = 0 },
    licenses     = { "weapon_license" },
    canOpen      = function(src)
        return true
    end,
    onExchange   = function(src, items, price)
        if price > 10000 then
            return false, "Transaction limit exceeded"
        end
        return true
    end
}

Types

Store

#📄 Fields:

#💡 Example

Store

#📄 Fields:

#💡 Example

Store

#📄 Fields:

#💡 Example

📄 Fields:

💡 Example

📄 Fields:

💡 Example

📄 Fields:

💡 Example