Koja Scripts

Inventory

Koja Inventory: a drop-in redesign of ox_inventory with a new UI, clothing as items, backpacks, trading, item discovery, a basket shop, crafting queue, 3D weapon attachments and an in-game admin panel.

Koja Inventory

Koja Inventory is a full redesign of 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

AreaWhat is in it
Inventory UITabs 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
Slots5 pockets (hotbar), 20 base slots and 10 slots unlocked by a backpack (35 in total by default)
Clothing as itemsWorn clothes are real items. Drag them onto the ped to dress, drag them off to undress. Hangers store a whole outfit
BackpacksA bag worn in the bag slot unlocks extra slots and carry weight
Mini stashesItems with isStash open as small containers; pull items out straight from the tooltip
Armour platesUp to 3 plates in a worn plate carrier; damage eats them from the last one inserted
WeightOverloaded players walk slower, lose stamina, sweat and cannot sprint near the limit
ThrowingThrow any item or the weapon in your hand; it lands as a normal ground drop
Give & tradeRest 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 & discoverySix rarities with colours. Items in other inventories stay hidden for a per-rarity search time
Weapon attachmentsA 3D view of the weapon with a marker per component. Weapon tints are items
ShopsGrid or list view, a basket, cash / card per shop and a built-in 3D prompt
CraftingA crafting panel with ingredients, amount, an in-UI progress bar and a queue
World containersDumpster and trunk loot, a search animation and ox_target options
Player settings5 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 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

  1. Install it

    Installation — requirements, server.cfg, convars, admin access and upgrading from ox_inventory.

  2. Configure it

    Configuration — every option in data/koja/*.lua, and Items for the new item fields.

  3. Learn what it does

    Features — clothing, backpacks, trading, discovery, shops, crafting and more.

  4. Run it from the admin panel

    Admin panel — every page of /invadmin, roles and staff.

  5. Use it from your own code

    Exports & Commands — the new exports, upstream API, commands and keybinds.

In this section

Installation

Requirements, start order, convars and admin access.

Configuration

Every option in data/koja, explained.

Items

New item fields and the bundled items.

Features

Clothing, backpacks, trade, discovery, shops and crafting.

Player settings

Themes, layout, popups and controls players can change.

Admin panel

Every page of /invadmin, roles and staff.

Exports & Commands

Exports, commands and keybinds.

languages Translations

Locale files and live overrides.

Database

The koja_inv tables.

Troubleshooting

Fixes for the problems people actually hit.

Credits

Based on 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.