> For the complete documentation index, see [llms.txt](https://royals-store.gitbook.io/royals-store-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://royals-store.gitbook.io/royals-store-docs/documentation/advanced-store/advanced-store.md).

# Overview

Standalone convenience-store system for FiveM — NPC shops, a custom NUI, six store types, four payment methods and a full armed-robbery flow.

**Advanced Store** replaces your framework's stock shops with NPC-run stores that have a proper interface: a browsable catalog with real item images, a basket, four payment methods, and an armed hold-up flow complete with a clerk, panicking bystanders, an alarm, a police alert and a crackable safe.

It works on **ESX**, **QBCore**, **Qbox** — or with **no framework at all**, where money is handled as an `ox_inventory` item. Everything is auto-detected.

**Current version:** `1.4.1`

## What you get

|                          |                                                                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Six store types**      | supermarket, liquor store, LTD, Ammu-Nation, pawn shop, black market — each with its own catalog, price multiplier, blip and accepted payments |
| **Custom NUI**           | 24/7-styled dark interface, item images pulled straight from your inventory resource, categories, search and a basket                          |
| **Four payment methods** | cash, bank, dirty money and an `Rs_Banking` card terminal                                                                                      |
| **Streamed vendor NPCs** | a clerk per shop, spawned only when a player is nearby                                                                                         |
| **Full robbery flow**    | free-aim a clerk → till bag → alarm + police alert → safe crack → carry the loot to a vehicle                                                  |
| **Company accounts**     | optionally credit every sale to an `Rs_Banking` business account per store type or per shop                                                    |
| **Anti-abuse limits**    | basket caps, purchase cooldown, server-side distance and carry checks                                                                          |
| **No database**          | the base resource needs none                                                                                                                   |

{% hint style="info" %}
Player-owned stores — buying a shop, boss menu, employees, stock, analytics — are the separate [**Advanced Player Store**](/royals-store-docs/documentation/advanced-player-store/advanced-player-store.md) DLC, which installs on top of this resource.
{% endhint %}

## How a purchase works

1. The player walks up to a shop point and presses the interact key (or uses the target).
2. The NUI opens with the catalog for that store type.
3. They fill a basket and pick a payment method the type accepts.
4. The **server** re-checks the price, the distance, the free inventory space and the cooldown, then debits and delivers the items.

Nothing about the price or the basket is trusted from the client.

## Where the money goes

By default, spent money **disappears** — the shops are a money sink. Give a store type or a single shop an `Rs_Banking` IBAN and every sale is credited to that company account instead, which also unlocks the card-terminal button.

{% content-ref url="/pages/3Pny1ZxdDcOUVAMOpA8g" %}
[Payment methods](/royals-store-docs/documentation/advanced-store/payments.md)
{% endcontent-ref %}

## Next

{% content-ref url="/pages/BNZu08Tte96HJ4oUVoRi" %}
[Installation](/royals-store-docs/documentation/advanced-store/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/zqTswd7GIHGz9ygBYJRH" %}
[Configuration](/royals-store-docs/documentation/advanced-store/configuration.md)
{% endcontent-ref %}

## Credits

Font Awesome Free is bundled in `web/assets/vendor/fontawesome` under its own licence — see `web/assets/vendor/fontawesome/LICENSE.txt`.