# Swichas Inventory
**A premium spatial-grid inventory for FiveM — multiframework, escrow-protected, and complete. One resource for your inventory, hotbar, weapons, clothing, stashes, crafting and player robbery.**
---
## ✨ Why Swichas Inventory?
A modern **drag-and-drop grid inventory** built on a fast **React** interface, with a live 3D character preview and smooth, jank-free animations. It runs on **any framework** — ESX, QBCore, QBox, standalone — and lets you pick your database and callback library. Everything is configured in clean, heavily-commented Lua files that stay **fully open** after escrow.
**177 items · 108 weapons · 19 ammo types · attachments · crafting · player search — out of the box.**
---
## 🎒 Features
**Core inventory**
-
**Spatial grid** — items occupy real width × height cells; rotate with **R**.
-
**Hotbar / quick slots** — bind up to 5 items; per-instance binding, so two copies of the same item keep their own metadata.
-
**Ground drops** — drag items out of the UI to drop them in the world as real props.
-
**Weight system** with a live capacity bar.
**Weapons**
-
The **full GTA weapon roster** (108 weapons) with ammo types and magazines.
-
**Weapon inspect view** — a real 3D weapon you can rotate and zoom.
-
**Attachments** — suppressors, scopes, extended clips, flashlights.
**Clothing & appearance**
- **Paper-doll equip panel** around a live 3D ped, with connector lines to each body part.
- Wear tops, legs, masks, hats, glasses, gloves, bags, watches.
-
**Outfits** — fold a worn set into a single item and re-wear it later.
-
**Backpacks** with their own grid, and **plate-carrier body armor** you slot armor plates into.
**Storage**
-
**Stashes** — shared, **personal (owned)**, or **job-restricted** with a minimum grade.
-
**Vehicle trunks**, keyed per plate.
**Crafting**
-
Crafting **benches** with per-bench recipe lists and optional job gating.
-
Ingredient checks with live have/need counts and a **progress bar**.
**Player search & robbery**
-
A
/stealcommand (or **export-only** mode) to open a nearby player's live inventory. -
Take or plant items, and **steal, strip or dress their clothing** by drag-and-drop.
- Fully server-authoritative with live distance re-checks.
**Quality of life**
-
**Localization** — every string in one `locales.lua`; translate by copying one block.
-
**ox_inventory-compatible exports** — most third-party scripts work unchanged.
-
**Item function API** — give any item custom behaviour from your own resource.
---
## 🔌 Compatibility
| | Options |
|---|---|
| **Framework** | `auto` · ESX · QBCore · QBox · Standalone |
| **Database** | `auto` · oxmysql |
| **Callbacks** | `auto` · ox_lib |
| **Appearance** | `auto` · illenium-appearance · rcore_clothing · fivem-appearance · qb-clothing |
Everything defaults to **`auto`** — it detects what you already run.
---
## ⚙️ Requirements
-
FiveM artifacts **server build 7290+** with **OneSync** enabled.
-
**oxmysql** for persistence.
-
**ox_lib** for callbacks.
*(Framework and appearance scripts are optional and auto-detected.)*
---
## 🛠️ Configuration
All configuration lives in open, commented files — **untouched by escrow**:
| File | What it holds |
|---|---|
| `shared/config.lua` | framework / database / callback / appearance, grids, weight, keybind, equip slots |
| `shared/items.lua` | item registry |
| `shared/weapons.lua` | weapons, ammo, attachments |
| `shared/stash.lua` | stash locations |
| `shared/crafting.lua` | benches & recipes |
| `shared/locales.lua` | translations |
A bundled **`CREATING_ITEMS.md`** guide covers adding items, giving items their own functions, the ox-compatible exports, stashes, crafting, `/steal` and appearance integration.
---
## 🔒 Escrow
Protected with **FiveM Asset Escrow**. You get full, editable access to every config, item, weapon, stash, recipe and locale file — only the core logic is encrypted.
---
*One-time purchase · lifetime updates · support on [Discord](https://discord.gg/jPA9EyukAk).*