# Stores

## 🏪 Stores

You can add unlimited store locations, each with their own items, NPC, and blip.

***

### Adding a New Store

Open shared/config.lua and add a new entry to Config.Stores:

Config.Stores = {

```
['my_custom_store'] = {
    label = 'My Custom Store',

    blip = {
        enabled = true,
        sprite = 52,
        color = 2,
        scale = 0.7,
        display = 4,
    },

    ped = {
        enabled = true,
        model = 'mp_m_shopkeep_01',
        scenario = 'WORLD_HUMAN_STAND_IMPATIENT',
    },

    location = vector4(25.7, -1347.3, 29.5, 271.66),

    items = {
        { name = 'burger',  label = 'Burger',  price = 15, category = 'food',  stock = -1, description = 'Delicious burger.' },
        { name = 'water',   label = 'Water',   price = 3,  category = 'drink', stock = 50, description = 'Fresh water.' },
        { name = 'bandage', label = 'Bandage', price = 50, category = 'medical', stock = 20, description = 'Heals wounds.' },
    },
},
```

}

***

### Item Properties

| Property    | Type   | Required | Description                                     |
| ----------- | ------ | -------- | ----------------------------------------------- |
| name        | string | Yes      | Item spawn name (must match inventory)          |
| label       | string | Yes      | Display name in UI                              |
| price       | number | Yes      | Item price                                      |
| category    | string | Yes      | Category ID (food, drink, tools, etc.)          |
| stock       | number | Optional | Stock amount (-1 = unlimited, 0 = out of stock) |
| description | string | Optional | Item description shown in modal                 |

***

### Blip Settings

| Property | Description                   |
| -------- | ----------------------------- |
| enabled  | Show blip on map (true/false) |
| sprite   | Blip icon number              |
| color    | Blip color number             |
| scale    | Blip size (0.1 - 2.0)         |
| display  | Display mode (4 = default)    |

***

### NPC Settings

| Property | Description            |
| -------- | ---------------------- |
| enabled  | Spawn NPC (true/false) |
| model    | Ped model name         |
| scenario | NPC idle animation     |

#### Popular NPC Models

'mp\_m\_shopkeep\_01' -- Default shopkeeper 'a\_m\_y\_indian\_01' -- Indian male 'a\_m\_m\_farmer\_01' -- Farmer 's\_f\_y\_shop\_low' -- Female shop worker 's\_m\_y\_dealer\_01' -- Male dealer

***

### Disable Blip or NPC

blip = { enabled = false, -- No blip on map },

ped = { enabled = false, -- No NPC spawned },

***

### Multiple Stores Example

Config.Stores = {

```
['store_1'] = {
    label = '24/7 Market - Vinewood',
    location = vector4(25.7, -1347.3, 29.5, 271.66),
    -- blip, ped, items...
},

['store_2'] = {
    label = '24/7 Market - Sandy Shores',
    location = vector4(1960.2, 3740.5, 32.3, 297.4),
    -- blip, ped, items...
},

['hardware'] = {
    label = 'Hardware Store',
    location = vector4(45.68, -1749.04, 29.64, 52.0),
    -- blip, ped, items (tools only)...
},
```

}

Each store can have completely different items and categories.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://elena-scripts.gitbook.io/elenascripts/economy/shop/stores.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.