Shops

Shops are defined in `src/shops/` directory.

Shop Definition

-- src/shops/example_shop.lua
return {
    id = 'shop_247_downtown',
    label = '24/7 Supermarket',
    coords = vector3(25.74, -1347.3, 29.5),
    blip = {
        enabled = true,
        sprite = 52,
        color = 2,
        scale = 0.8
    },
    items = {
        { name = 'water', price = 10 },
        { name = 'sandwich', price = 15 },
        { name = 'bandage', price = 100 }
    },
    access = nil  -- nil = everyone can access
}

Properties

Property	Type	Description
id	string	Unique shop identifier
label	string	Display name
coords	vector3	Shop location
blip	table	Map blip settings
items	table[]	Items for sale
access	table/nil	Access restrictions

Shop Items

items = {
    { name = 'water', price = 10 },
    { name = 'sandwich', price = 15, stock = 50 },  -- Limited stock
    { name = 'armor', price = 5000 }
}

Access Control

-- Everyone
access = nil

-- Specific jobs
access = {
    jobs = { 'police', 'ambulance' }
}

-- Specific job grades
access = {
    jobs = { 'police' },
    grades = { 3, 4 }  -- Only grade 3 and 4
}

Opening Shop Programmatically

-- Server-side
exports['skeexs-inventory']:OpenShop(source, 'shop_247_downtown')

-- Client-side (triggers server)
TriggerServerEvent('inventory:server:openShop', 'shop_247_downtown')

Registering Shop at Runtime

exports['skeexs-inventory']:RegisterShop({
    id = 'temp_shop',
    label = 'Temporary Shop',
    coords = vector3(0, 0, 0),
    items = {
        { name = 'water', price = 5 }
    }
})