# Overview

Koja Inventory V2 (`koja-inventory-v2`) is a grid inventory for FiveM in the Tarkov / MajesticRP style. Every item has a real size: a rifle takes 4x2 cells, a pistol 2x2, a can of soda 1x2. Items rotate, stack, split and travel inside backpacks that have their own grid.

It replaces `ox_inventory`. Your ox items, shops, stashes and crafting benches are imported at start, players are migrated on first join, and scripts that call `exports.ox_inventory` keep working without changes. See [Migrating from ox_inventory](/new/inventory-v2/migrating-from-ox).

## What you get

::::cards{cols="2"}
:::card{title="Grid with real sizes" icon="package"}
Placement, collisions, rotation, stacking and sorting are checked on the server. The UI moves items right away and rolls back if the server says no.
:::
:::card{title="Equipment and clothing" icon="shirt"}
Backpack, vest, primary and sidearm slots, plus one slot per clothing piece. Drag a jacket off the character to undress.
:::
:::card{title="World storage" icon="archive"}
Trunks by vehicle class, gloveboxes, physics drops that merge into piles, stashes, dumpsters and player search.
:::
:::card{title="Admin panel" icon="settings"}
`/invadmin`: give items, inspect players, create stashes, shops and benches in game, live settings without a restart.
:::
::::

Also included: shops with a basket and card or cash payment, crafting at benches and from the hand, salvage, durability and repair, items held in the hand, weapon throwing, a 3D weapon workshop, a give flow where you pick the receiver with the camera, frisking, outfit bags, multi-use food and cash as an item. Every feature is described in [Features](/new/inventory-v2/features).

## Controls

| Action | How |
|---|---|
| Open | `TAB` (`Config.Keys.open`) |
| Move | Drag and drop. Green means it fits, blue stacks, red is blocked. |
| Rotate | `R` while dragging, or the context menu |
| Quick transfer | `Shift` + click moves the item to the other open container |
| Split | `Ctrl` + click, or the context menu |
| Use | Double click |
| Context menu | Right click: use, hold, modify, repair, split, rotate, give, drop, salvage, pin to hotbar |
| Hotbar | `1` to `5`, `Z` shows the hotbar (`Config.Keys.hotbar`) |
| Interact | `E` at shops, benches, stashes, dumpsters and items on the ground (`Config.Keys.interact`) |
| Throw weapon | Hold the middle mouse button, release to throw, right mouse button cancels |
| Reload | `R` with a firearm drawn |

All keys are FiveM key mappings, so players can rebind them in the game settings. See [Commands and keybinds](/new/inventory-v2/commands-and-keybinds).

## Requirements

- `oxmysql`
- [`koja-lib`](/koja-lib/getting-started)
- ESX or QBCore

`ox_target` and `illenium-appearance` are optional and detected automatically.

## Next steps

:::steps
### Install it
Follow [Installation](/new/inventory-v2/installation).

### Tune the config
Read [Configuration](/new/inventory-v2/configuration) and [Items](/new/inventory-v2/items).

### Connect your scripts
See the [Developer API](/new/inventory-v2/api).
:::