> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thecruxstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced Shop Script: Immersive FiveM Store System

> Create an immersive server economy with a powerful store script for QBCore, QBox, and ESX — supports 24/7 shops, gun stores, tech hubs, and more.

Create a truly immersive economy with this powerful Store Script, designed to work out of the box with QBCore, QBox, and ESX frameworks. Whether you're running a 24/7 convenience store, a gun shop, a tech hub like Digital Den, or any other retail business, this script gives you the tools to build an engaging, professional storefront experience for your players.

## Features

* **Multi-store support** — Configure any number of shops with unique inventory, pricing, and locations. Use it for 24/7s, gun shops, tech stores, pharmacies, and more.
* **Multi-framework** — Works natively with QBCore, QBox, and ESX. No framework-specific hacks required.
* **Immersive interaction** — Uses eye-target integration for natural, context-sensitive interactions with shop props and NPCs.
* **Customizable menus** — Define exactly what each store sells, at what price, and to whom — including job or grade restrictions.
* **Notification support** — Integrates with all major notify scripts for clean, on-brand purchase feedback.
* **Inventory compatibility** — Works with ox\_inventory, qb-inventory, and all major community inventory scripts.

## Installation

<Steps>
  <Step title="Install Dependencies">
    Download and install the following dependencies before adding the script to your server:

    * [oxmysql v2.12.0](https://github.com/overextended/oxmysql/releases/tag/v2.12.0)
    * [ox\_lib v3.30.6](https://github.com/overextended/ox_lib/releases/tag/v3.30.6)
    * `crux_lib` — included in your script download.
  </Step>

  <Step title="Configure the Script">
    Open `config/config.lua` and configure your stores. Set up shop locations, stock items, pricing, restricted items, and NPC/prop settings for each store you want to add.
  </Step>

  <Step title="Add Items to Your Inventory">
    Open the `install` folder and add all required items and images to your inventory system.

    * **qb-inventory** — Copy items into `qb-core/shared/items.lua` and images into `qb-inventory/html/images`.
    * **ox\_inventory** — Copy items into `ox_inventory/data/items.lua` and images into `ox_inventory/web/images`.
    * **qs-inventory** — Copy items into `qs-inventory/` and images into `qs-inventory/html/images`.
    * **tgiann-inventory** — Copy items into `qb-core/shared/items.lua` and images into `qb-inventory/html/images`.

    See the `README` inside the script for the full item list formatted for each inventory system.
  </Step>

  <Step title="Ensure Resources">
    Add the following lines to your `server.cfg`:

    ```
    ensure ox_lib
    ensure crux_lib
    ensure crux-uwucafetv
    ensure crux-uwucafekiosk
    ensure crux-uwucafebag
    ensure crux-uwucafejobv2
    ```
  </Step>
</Steps>

## Integrations

Advanced Shop Script supports the same wide integration ecosystem as all Crux Studio Advanced Series scripts.

| Category   | Officially Supported        |
| ---------- | --------------------------- |
| Eye Target | ox\_target, qb-target       |
| Notify     | crux\_notify, qb, ox, esx   |
| Inventory  | ox\_inventory, qb-inventory |

For the complete compatibility table covering all supported eye target, notify, and inventory scripts, see the [UWU Cat Café V2 Integrations](/restaurant-v2/uwu-cat-cafe-v2-integrations) page — Advanced Shop Script shares the same integration coverage.