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

# Interactive Storage

Animated filing cabinets with a stash in every drawer, on GTA's own cabinets and on cabinets you place in game

Filing cabinets that open. A player walks up to a cabinet and picks a drawer from a list. The character then pulls that drawer out with an animation while the camera moves to it. Every drawer is a stash in your server's inventory, and closing the inventory shuts the drawer.

It works on two kinds of cabinets:

* **GTA's own cabinets.** 46 filing cabinet models that already stand in GTA interiors, and in MLOs that reuse them, open the same way. You do not place anything.
* **Placed cabinets.** `/storcreator` puts one of the 16 cabinet models anywhere in the world, in game. Placed cabinets are saved and show for everyone.

Other players nearby see the drawer and the character move. One player uses a cabinet at a time.

{% hint style="info" %}
**No required dependencies.** The framework, target, inventory and `ox_lib` are detected when they run. Without an inventory the drawers still open and close, they just hold nothing.
{% endhint %}

<figure><img src="https://2466319842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOrhcX4VMOZXgAwql2wKN%2Fuploads%2Fgit-blob-f27975ea3e5ae546260f238257aef58c1191a0b3%2Finteractive-storage-drawer-list.png?alt=media" alt="A player at a wooden filing cabinet with the drawer list beside him: Upper drawer, Middle drawer, Lower drawer"><figcaption><p>The drawer list stands beside the player.</p></figcaption></figure>

***

### Requirements

* FiveM server.

Optional, detected automatically:

* **Inventory**, for the drawer stashes: `ox_inventory`, `qb-inventory` (2.0 or newer), `tgiann-inventory` or `qs-inventory`. Any other inventory works through two functions you fill in (see [Custom inventory](/prompt-studio/scripts/interactive-storage/configuration.md#custom-inventory)).
* **Target**: [`ox_target`](https://github.com/overextended/ox_target) or `qb-target`. Without one, a placed cabinet shows an `[E] Open cabinet` prompt; for GTA's own cabinets the player holds **ALT**, looks at the cabinet and presses **E**.
* **Framework**: `qbx_core`, `qb-core` or `es_extended`, for job-based access. Without one, access uses an ACE.
* [**`ox_lib`**](https://github.com/overextended/ox_lib): notifications on servers without qb-core, qbox or ESX, and the text UI if you switch the prompts to it.

{% hint style="info" %}
**Tested in game** on qb-core with `ox_inventory`, `qb-inventory` 2.0, a custom inventory and no inventory, and with `ox_target`, `qb-target` and no target (the `[E]` prompt).

**Supported, not run in game by us:** `tgiann-inventory` and `qs-inventory` (written from their official documentation), and the ESX and qbox frameworks. If a drawer's stash does not open on yours, send us the [`stor_debugdump`](/prompt-studio/scripts/interactive-storage/troubleshooting.md#support-dump) output on Discord.
{% endhint %}

***

### Installation

{% stepper %}
{% step %}

#### Copy the resource

Drop `prompt_interactive_storage` into your `resources` folder. Keep the folder name: the exports use it.
{% endstep %}

{% step %}

#### Add to server.cfg

Start it **after** your framework, target, inventory and `ox_lib`:

```
ensure prompt_interactive_storage
```

The target system is picked when the server starts. A target resource that starts later is only used after you restart `prompt_interactive_storage`.
{% endstep %}

{% step %}

#### Let staff place cabinets (optional)

```
add_ace group.admin stor.creator allow
```

{% endstep %}

{% step %}

#### Start the server

On the first start the resource creates `hooks/hooks_client.lua`, `hooks/hooks_server.lua` and `hooks/hooks_shared.lua` from the `.example.lua` templates. Updates never overwrite them. Players who were online during the first install should reconnect.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Every cabinet is open to every player out of the box. To restrict them, see [Access](/prompt-studio/scripts/interactive-storage/configuration.md#access).
{% endhint %}

***

### First-boot checklist

When the bridges are resolved, the server console prints a report that starts with `========== prompt_interactive_storage ==========`.

| Line        | What to look for                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------------ |
| `Framework` | `qbox`, `qbcore`, `esx` or `standalone`. `NONE FOUND` means no framework was found: access then uses the ACE |
| `Target`    | `ox_target`, `qb-target` or `none` (`none` = `[E]` prompts)                                                  |
| `Inventory` | The inventory the drawers use. `none` = the drawers hold nothing                                             |
| `Access`    | The `Config.access` rule. It only applies when `Config.Storage.access = true`                                |
| `Modules`   | `creator, storage`                                                                                           |
| `Language`  | The language in use (`auto` follows `ox:locale`)                                                             |

In game, type `/stor`: your side prints to F8, the server side to the server console.

***

### How it plays

```
[E] or target "Open cabinet" → the character walks to the drawer spot → drawer list
  → pick a drawer → it opens (animation + camera) → the stash opens
  → close the inventory → the drawer shuts → the camera glides back
```

* **The list:** Arrow Up / Down or the mouse wheel to choose, **E** or **Enter** to open, **Backspace** or **Esc** (or the Cancel row) to leave. Walking away from the cabinet closes it.
* **The walk:** the character walks to the drawer and turns to face it; there is no teleport. **X** during the walk cancels.
* **Shared stashes:** each drawer of each cabinet is its own stash. Everyone who opens that drawer sees the same items.
* **Closing:** the drawer shuts when the inventory closes. Without an inventory, or when the inventory does not come up within 3 seconds, an `[X] Close drawer` prompt shows instead.
* **Everyone sees it:** other players within 60 m see the drawer and the character animate. While someone uses a cabinet, nobody else gets its option.
* **Interruptions:** if the character dies, or another script downs or cuffs them, the scene lets go at once.
* **Sounds:** steel and wooden drawers have their own opening and closing sounds, played from the cabinet.

<figure><img src="https://2466319842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOrhcX4VMOZXgAwql2wKN%2Fuploads%2Fgit-blob-b89a17c4d67d5d8ad94105b5e3a344a50e6af399%2Finteractive-storage-drawer-open.png?alt=media" alt="The character pulls out the middle drawer of a wooden filing cabinet"><figcaption><p>The drawer opens with the character's hand on the handle.</p></figcaption></figure>

<figure><img src="https://2466319842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOrhcX4VMOZXgAwql2wKN%2Fuploads%2Fgit-blob-6a4359b745ebd1e8c3ee89689b2f45cf24144cbd%2Finteractive-storage-drawer-stash.png?alt=media" alt="ox_inventory with the player&#x27;s inventory on the left and the Upper drawer stash on the right"><figcaption><p>The drawer's stash, here in ox_inventory. The stash is named after the drawer.</p></figcaption></figure>

The `[E]` and `[X]` prompts are drawn by the script itself. To use your server's text UI instead, set `Config.prompt = 'textui'` (see [Configuration](/prompt-studio/scripts/interactive-storage/configuration.md#main-settings)).

{% columns %}
{% column %}

<figure><img src="https://2466319842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOrhcX4VMOZXgAwql2wKN%2Fuploads%2Fgit-blob-1f9f699054cf32a03fd04d687ab0b7d242fce88a%2Finteractive-storage-prompt-open.png?alt=media" alt="The Open cabinet prompt plate with the E key"><figcaption><p>No target resource: the <code>[E] Open cabinet</code> prompt.</p></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://2466319842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOrhcX4VMOZXgAwql2wKN%2Fuploads%2Fgit-blob-e8625ffd2b05a3c2cc5b9af242c234f21b02fa5c%2Finteractive-storage-prompt-close.png?alt=media" alt="The Close drawer prompt plate with the X key while a drawer is open"><figcaption><p>No inventory on screen: <code>[X] Close drawer</code> while the drawer is open.</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

### What's inside

<table data-view="cards"><thead><tr><th>Section</th><th></th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td><strong>Placing Cabinets</strong></td><td>/storcreator, the placer screen, move and remove</td><td><a href="/prompt-studio/scripts/interactive-storage/placing-cabinets.md">Placing Cabinets</a></td></tr><tr><td><strong>Configuration</strong></td><td>Access, inventories, distances, stash sizes, languages</td><td><a href="/prompt-studio/scripts/interactive-storage/configuration.md">Configuration</a></td></tr><tr><td><strong>For Developers</strong></td><td>Hooks, exports, commands, stash names, custom bridges</td><td><a href="/prompt-studio/scripts/interactive-storage/developers.md">For Developers</a></td></tr><tr><td><strong>Troubleshooting</strong></td><td>No option, no stash, no access, support dump</td><td><a href="/prompt-studio/scripts/interactive-storage/troubleshooting.md">Troubleshooting</a></td></tr></tbody></table>