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

# Introduction

A full inventory for QBCore that drops in for qb-inventory. Weapons, clothing, crafting and more built in.

**Striga Inventory** is a full inventory for your server, built on **striga-core**. It takes the place of `qb-inventory`, so your QBCore scripts keep working with no edits. Weapons, clothing items, crafting, trash bins and vending machines are built in.

Version: **1.0.0** · needs **striga-core 0.1.0** or newer.

## Features

| Feature                             | What it means                                                                                                         |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Drop-in for qb-inventory**        | Scripts that call `exports['qb-inventory']` keep working, nothing to edit                                             |
| **3D character**                    | A copy of your character stands next to the inventory, the clothing slots sit on its body                             |
| **Clothing as items**               | Hat, mask, top, pants, shoes and more are items. Take them off, give them away, put them back on                      |
| **Outfits**                         | One button packs everything you wear into one outfit item. Use it to change in one go                                 |
| **Weapon pack**                     | Draw / holster animations, ammo and wear kept on the server, attachments, tints, a gunsmith with a camera preview     |
| **Crafting**                        | Workbenches with recipes, job or gang locks and a progress bar                                                        |
| **Item life cycle**                 | Food that goes bad, items with a number of uses, bags that open like a stash, backpacks that add slots, rarity colors |
| **Throw and pick up**               | Throw an item where you look, hold `E` to pick items up from the ground                                               |
| **Stashes, trunks, gloveboxes**     | Trunk and glovebox size by vehicle type, class or model, with a trunk animation                                       |
| **Shops and gun shops**             | Shops with peds, blips, stock, job locks and licence locks                                                            |
| **Trash bins and vending machines** | Work at the map props, no setup                                                                                       |
| **Cash as an item**                 | The `cash` item stays in sync with the framework cash account                                                         |
| **Converter**                       | Moves your stashes and trunks over from qb-inventory, ox\_inventory, qs, codem and more                               |
| **Follows your HUD color**          | With Striga Tokyo HUD, the inventory uses the theme color, live                                                       |
| **11 languages**                    | Follows the striga-core server language                                                                               |
| **Hooks**                           | Other scripts can check or cancel moves, uses, buys, crafts and more                                                  |
| **Server side checks**              | The server checks every move, price, stock, distance, shot and craft                                                  |

## Supported frameworks

| Framework | Status                                                                                                                           |
| --------- | -------------------------------------------------------------------------------------------------------------------------------- |
| QBCore    | Supported (replaces `qb-inventory`)                                                                                              |
| Qbox      | Coming. The inventory side is ready, it waits for a striga-core update. See [Qbox & ESX](/docs/striga-inventory/qbox-and-esx.md) |
| ESX       | Coming. Same as Qbox                                                                                                             |

## Requirements

* **striga-core** 0.1.0 or newer (started before Striga Inventory)
* **ox\_lib**
* **oxmysql**
* **QBCore**

{% hint style="info" %}
**Striga Tokyo HUD is optional.** Without it, the inventory uses its own color. With it, the color follows the HUD theme and the `/hud` menu gets an **Inventory** section.
{% endhint %}

## Player keys

| Key           | What it does                                                        |
| ------------- | ------------------------------------------------------------------- |
| `TAB` or `F2` | Open / close the inventory                                          |
| `Z`           | Show the hotbar                                                     |
| `1` - `5`     | Use the item in hotbar slot 1 to 5                                  |
| `E` (hold)    | Pick up an item from the ground                                     |
| `G`           | Throw the item in your hand (right click an item > **Throw** first) |
| `R`           | Reload an empty weapon from your ammo                               |
| `ESC`         | Close the inventory                                                 |

Players can change the keys in **GTA Settings > Key Bindings > FiveM**.

Settings are saved on each player's own PC, so every player keeps their own look.

## Pages

| Page                                                                                             | What is in it                                                       |
| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |
| [Installation & Configuration](/docs/striga-inventory/installation-and-configuration.md)         | Install steps and every config option                               |
| [Items, Shops & Stashes](/docs/striga-inventory/items-shops-and-stashes.md)                      | Items, item life cycle, cash, shops, stashes, world, admin commands |
| [Weapons](/docs/striga-inventory/weapons.md)                                                     | The weapon pack and the gunsmith                                    |
| [Clothing & Character](/docs/striga-inventory/clothing-and-character.md)                         | 3D character, clothing items, outfits, armor                        |
| [Crafting](/docs/striga-inventory/crafting.md)                                                   | Workbenches and recipes                                             |
| [Converting from another inventory](/docs/striga-inventory/converting-from-another-inventory.md) | Move your old stashes and trunks over                               |
| [QB Compatibility](/docs/striga-inventory/qb-compatibility.md)                                   | What keeps working from qb-inventory                                |
| [Qbox & ESX](/docs/striga-inventory/qbox-and-esx.md)                                             | The ox\_inventory mode                                              |
| [Exports & Events](/docs/striga-inventory/exports-and-events.md)                                 | Use the inventory from your own scripts                             |
| [Troubleshooting & FAQ](/docs/striga-inventory/troubleshooting-and-faq.md)                       | Common problems and fixes                                           |

{% content-ref url="/pages/1p1NYxSYGWhMKzhXd07i" %}
[Installation & Configuration](/docs/striga-inventory/installation-and-configuration.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://striga.gitbook.io/docs/striga-inventory/introduction.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
