Player settings
Every player can personalise the inventory in the Settings tab. Settings are saved per player on their own PC (client KVP koja_inv_settings), so they survive reconnects and server restarts.
The starting values come from defaults in data/koja/core.lua (see Configuration). Reset brings them back, Save applies and stores the current choice.
Appearance
| Setting | What it does |
|---|---|
| Main color | Accent colour of the whole UI (buttons, highlights, target rings) |
| Secondary color | Panel background colour |
Both have a colour picker with presets.
Layout
| Setting | Range | What it does |
|---|---|---|
| Rows | 4–8 | Visible rows of the inventory grid |
| Inventory scale | 70–130 % | Size of the whole UI |
| Clothing panel | Left, Center, Right | Where Your clothes and the ped preview sit. Center = between the inventories |
Inventory style
| Theme | Look |
|---|---|
| Theme V2 | The classic layout with a soft vignette |
| Theme V3 Ferrofluid | The V3 layout with an animated fluid glow |
| Theme V3 Minimalistic | The V3 layout with a flat, quiet background |
| Theme V3 Dotted | The V3 layout with an interactive dotted background |
| Theme V3 Antigravity | The V3 layout with an interactive particle field |
Item popups
How items you get or lose are shown while the inventory is closed:
- Compact — a card with the item image and the amount.
- Minimalistic — a small pill with icon, amount and name.
With the inventory open the popups are always the small version.
Typography
Font: Poppins, Inter, Montserrat, Rajdhani or Barlow.
General
| Switch | What it does |
|---|---|
| Clothing inventory | Shows Your clothes and the ped preview next to the inventory |
| Camera on character | Off = the gameplay camera stays put when the inventory opens; the ped is drawn inside the UI instead |
| Sharp borders | Square corners everywhere |
| Streamer mode | Hides player names in give / trade target mode (server id or "Player" instead), masks serial numbers and hides the label of the other inventory |
| Enable sound | UI sounds |
Useful controls
The Useful controls tab is a cheat sheet:
| Control | What it does |
|---|---|
| Hover an item | Item details, quick use, split and container contents |
| SHIFT + click | Select several items, then drag them together |
| Drag an item onto the Give / Trade tile | Pick a player in the world to give it or send a trade request |
| ESC | Close the inventory |
The keybinds are listed in Exports & Commands. Players can rebind them in Settings → Key Bindings → FiveM.