Koja Scripts

Overview

What Koja Inventory V2 is, what it does and how the grid, equipment and controls work.

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.

What you get

Grid with real sizes

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.

Equipment and clothing

Backpack, vest, primary and sidearm slots, plus one slot per clothing piece. Drag a jacket off the character to undress.

World storage

Trunks by vehicle class, gloveboxes, physics drops that merge into piles, stashes, dumpsters and player search.

Admin panel

/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.

Controls

ActionHow
OpenTAB (Config.Keys.open)
MoveDrag and drop. Green means it fits, blue stacks, red is blocked.
RotateR while dragging, or the context menu
Quick transferShift + click moves the item to the other open container
SplitCtrl + click, or the context menu
UseDouble click
Context menuRight click: use, hold, modify, repair, split, rotate, give, drop, salvage, pin to hotbar
Hotbar1 to 5, Z shows the hotbar (Config.Keys.hotbar)
InteractE at shops, benches, stashes, dumpsters and items on the ground (Config.Keys.interact)
Throw weaponHold the middle mouse button, release to throw, right mouse button cancels
ReloadR with a firearm drawn

All keys are FiveM key mappings, so players can rebind them in the game settings. See Commands and keybinds.

Requirements

ox_target and illenium-appearance are optional and detected automatically.

Next steps

  1. Install it

    Follow Installation.

  2. Tune the config

    Read Configuration and Items.

  3. Connect your scripts

    See the Developer API.