![](https://pub-57d6558d0e204696b4cdeee5d172e561.r2.dev/docs/new-inventory/d70548a4-banner.png)

# Koja Inventory

Koja Inventory is a full redesign of [ox_inventory](https://github.com/overextended/ox_inventory) (based on version 2.48.0).
It replaces the whole UI with a new React interface and adds clothing as items, backpacks, trading, item rarity and discovery, a shop with a basket, a crafting queue, 3D weapon attachments and an admin panel — while the ox_inventory core underneath stays the same.

It is a drop-in replacement: the resource is still called `ox_inventory`, and every upstream export, event, hook, data file and database table keeps working, so scripts written for ox_inventory do not need any change.

This section covers version **1.0.0** of the resource.

## What you get

| Area | What is in it |
| --- | --- |
| Inventory UI | Tabs **Inventory**, **Clothing**, **Admin panel** (staff only), **Settings** and **Useful controls**. Your inventory, your clothes around a live ped preview and the other inventory side by side |
| Slots | 5 pockets (hotbar), 20 base slots and 10 slots unlocked by a backpack (35 in total by default) |
| Clothing as items | Worn clothes are real items. Drag them onto the ped to dress, drag them off to undress. Hangers store a whole outfit |
| Backpacks | A bag worn in the bag slot unlocks extra slots and carry weight |
| Mini stashes | Items with `isStash` open as small containers; pull items out straight from the tooltip |
| Armour plates | Up to 3 plates in a worn plate carrier; damage eats them from the last one inserted |
| Weight | Overloaded players walk slower, lose stamina, sweat and cannot sprint near the limit |
| Throwing | Throw any item or the weapon in your hand; it lands as a normal ground drop |
| Give & trade | Rest an item on the **Give** or **Trade** tile and pick a player in the world; two-sided trade with a 3D accept / decline prompt |
| Rarity & discovery | Six rarities with colours. Items in other inventories stay hidden for a per-rarity search time |
| Weapon attachments | A 3D view of the weapon with a marker per component. Weapon tints are items |
| Shops | Grid or list view, a basket, cash / card per shop and a built-in 3D prompt |
| Crafting | A crafting panel with ingredients, amount, an in-UI progress bar and a queue |
| World containers | Dumpster and trunk loot, a search animation and ox_target options |
| Player settings | 5 themes, colours, rows, scale, font, clothing panel position, ped camera, item popups, streamer mode and sounds |
| Admin panel | `/invadmin`: addons, world containers, items, rarity, crafting benches, players, history, security, clothing, shops, stashes, permissions and locales. Changes apply live |

## Quick facts

- **Resource name:** keep the folder name `ox_inventory`. Other scripts call `exports.ox_inventory`.
- **Frameworks:** ESX, Qbox (`qbx`), ox_core (`ox`) and ND (`nd`) — the same bridges as ox_inventory 2.48.0.
- **Requires:** `ox_lib`, `oxmysql`, OneSync and server build 6116 or newer.
- **Optional:** `ox_target`, and `illenium-appearance` / [Koja Appearance](/new/appearance) for real clothing images.
- **Database:** the `koja_inv_*` tables are created on start. The upstream `ox_inventory` table is unchanged.
- **UI:** shipped prebuilt in `web/build` inside the release zip.

## Start here

:::steps

### Install it

[Installation](/new/inventory/installation) — requirements, `server.cfg`, convars, admin access and upgrading from ox_inventory.

### Configure it

[Configuration](/new/inventory/configuration) — every option in `data/koja/*.lua`, and [Items](/new/inventory/items) for the new item fields.

### Learn what it does

[Features](/new/inventory/features) — clothing, backpacks, trading, discovery, shops, crafting and more.

### Run it from the admin panel

[Admin panel](/new/inventory/admin-panel) — every page of `/invadmin`, roles and staff.

### Use it from your own code

[Exports & Commands](/new/inventory/exports-and-commands) — the new exports, upstream API, commands and keybinds.

:::

## In this section

::::cards{cols="2"}
:::card{title="Installation" href="/new/inventory/installation" icon="download"}
Requirements, start order, convars and admin access.
:::
:::card{title="Configuration" href="/new/inventory/configuration" icon="settings"}
Every option in data/koja, explained.
:::
:::card{title="Items" href="/new/inventory/items" icon="package"}
New item fields and the bundled items.
:::
:::card{title="Features" href="/new/inventory/features" icon="sparkles"}
Clothing, backpacks, trade, discovery, shops and crafting.
:::
:::card{title="Player settings" href="/new/inventory/player-settings" icon="palette"}
Themes, layout, popups and controls players can change.
:::
:::card{title="Admin panel" href="/new/inventory/admin-panel" icon="shield"}
Every page of /invadmin, roles and staff.
:::
:::card{title="Exports & Commands" href="/new/inventory/exports-and-commands" icon="terminal"}
Exports, commands and keybinds.
:::
:::card{title="Translations" href="/new/inventory/translations" icon="languages"}
Locale files and live overrides.
:::
:::card{title="Database" href="/new/inventory/database" icon="database"}
The koja_inv tables.
:::
:::card{title="Troubleshooting" href="/new/inventory/troubleshooting" icon="bug"}
Fixes for the problems people actually hit.
:::
::::

## Credits

Based on [ox_inventory](https://github.com/overextended/ox_inventory) by Overextended (Linden, Luke, Dunak and contributors).
Released under GPL-3.0 like the original; the licence and credits are kept in `LICENSE` and `NOTICE.md`.