# Faq

### General

#### Do I need ox\_lib?

No. ox\_lib is completely optional. If installed, the script uses lib.callback for stock sync. Without it, stock works from config values.

#### Do I need a database?

No. Everything runs in memory and config files. No SQL setup required.

#### Does it work with both QB-Core and ESX?

Yes. The script auto-detects your framework. You can also set it manually in config.

***

### Items and Stores

#### Can I have different items per store?

Yes. Each store in Config.Stores has its own items table with different products and prices.

#### Can I add custom categories?

Yes. Add new category in Config.Categories, add locale strings in shared/locales.lua, and optionally add CSS colors.

#### How do I find item names?

Use the same item names as your inventory system. For example, if burger exists in ox\_inventory, use name = 'burger'.

***

### Images

#### Images are not showing

1. Check Config.UseImages = true
2. Check Config.ImagePath points to correct folder
3. Image filename must match item name (e.g. burger.png for item burger)
4. Make sure images are .png format

#### Can I use both images and icons?

Yes. Items with available images show images. If image fails to load, it automatically falls back to Font Awesome icon.

***

### Stock

#### Does stock persist after restart?

No. Stock resets to config values on server restart. Auto-restock timer also resets.

#### Can I disable stock for specific items?

Yes. Set stock = -1 for unlimited items.

***

### Troubleshooting

#### UI not opening

1. Check server console for errors
2. Ensure framework loads before elenashop
3. Check Config.UseInteraction = true or Config.UseTarget = true
4. Verify store location coordinates

#### NPC not spawning

1. Check ped.enabled = true in store config
2. Verify ped model name is correct
3. Check location coordinates (z coordinate especially)

#### Framework not detected

Set manually in config:

Config.Framework = 'qb' Config.Framework = 'esx'


---

# 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/faq.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.
