# lvs-shops

## LVS Shops – Dynamic Shop System

### Overview

Enhance your server’s economy with **LVS Shops**, a flexible and modern shop system designed to deliver a clean user experience and realistic item distribution.

Built with a focus on simplicity and immersion, LVS Shops allows you to create fully customized stores with dynamic inventories, job restrictions, and advanced item handling — all powered by an intuitive and visually appealing interface.

From convenience stores to black market dealers, this system gives you full control over how items are bought, sold, and managed across your server.

***

### Key Features

#### 🛒 Fully Customizable Shops

* Create unlimited shops with unique configurations.
* Define:
  * Shop name and description
  * Inventory items
  * Prices per item
* Each shop operates independently.

***

#### 📦 Stock System (Realistic Economy)

* Each item can have **limited stock**.
* Items can **run out** and become unavailable.
* Stock resets on server restart (or configurable logic).
* Adds realism and encourages:
  * Player planning
  * Market dynamics
  * Resource scarcity

👉 This creates a more immersive economy where items are not infinitely available.

***

#### 👥 Job & Group Restricted Shops

* Restrict shops to specific:
  * Jobs (e.g., police, ambulance)
  * Groups or roles
* Perfect for:
  * Armouries
  * Job-exclusive stores
  * Faction-based economies

***

#### 🧬 Advanced Item Metadata

* Support for **static metadata** (predefined values).
* Support for **dynamic metadata** (generated on purchase).
* Ideal for:
  * Registered weapons
  * Unique items
  * Custom attributes per item

***

#### 🕶 Black Market Support

* Create **illegal shops** (black markets).
* Transactions use **dirty money / black money**.
* Perfect for:
  * Criminal gameplay
  * Hidden economies
  * Risk-based trading systems

***

#### 🎨 Modern & Clean UI

* Custom-built interface (not default inventory UI).
* Designed for:
  * Clarity
  * Speed
  * Smooth navigation
* Supports item filters and structured layouts.


---

# 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://fivem.lvsoft.com.ar/qb-esx/lvs-shops.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.