# Inventory (ox_inventory)

> Your personal stash, your hotbar, your weight limit. Everything you carry, sees, gives, takes.

![Screenshot: the ox_inventory main window with grid slots populated](../screenshots/10-interface/inventory-main.png)
*Screenshot needed: ox_inventory open showing player's grid with 5-10 items.*

---

## What is the inventory?

`ox_inventory` is the system that tracks what you carry. The server has **218 items** loaded — guns, drugs, food, materials, special tools.

Your inventory has:

- A grid of slots (typically 40+ slots)
- A **weight limit** (typically 50 kg)
- A **hotbar** (slots 1–5 for quick access)
- Item metadata (durability, drug purity, gang affiliation)
- Drag-and-drop interface

---

## Opening the inventory

Press **F2**.

Alternative methods:

- Chat: `/inv` or `/inventory` or `/i`
- ox_target on yourself
- Pause menu (some configs)

The inventory window opens — your slots on the left, any nearby container/player on the right (if applicable).

---

## Item interaction

### Drag and drop

- Drag an item between slots
- Drag to the hotbar to assign quick-use
- Drag onto another player's grid to give them an item
- Drag onto a stash window to deposit

### Right-click menu

Right-clicking an item shows:

- **Use** — consume / apply the item
- **Drop** — place on the ground
- **Give** — to nearby player
- **Inspect** — see description + metadata
- **Quick-equip** (weapons)

### Hotbar slots 1–5

- Drag items to slots 1, 2, 3, 4, 5
- Press the number key to use that slot instantly
- Visible at the bottom of the screen
- Useful for: weapons, lockpicks, bandages, phone

---

## The weight system

Each item has a weight (in grams):

| Item | Weight |
|---|---|
| Gang tablet | 1,000 g (1 kg) |
| Pistol | 1,500 g |
| Bandsofnotes / stacksofcash | 1 g each (very light) |
| Bandages | 100 g |
| Lockpick | 500 g |
| Drug bag | 100 g |

**Total carry limit:** typically 50,000 g (50 kg). Configurable per server.

If you're over weight:
- You can't pick up more items
- Movement may slow (some configs)
- You'll see "Inventory full" or "Too heavy" notifications

---

## Stashes (shared storage)

Stashes are containers you can access via ox_target prompts:

### Personal stashes

- Your house / apartment
- Your gang's stash (if upgrade purchased — see [../02-gangs/upgrades.md](../02-gangs/upgrades.md))
- Vehicle trunk (some configs)

### Shared stashes

- Gang stash — all gang members access (rank-permitting)
- Business society stash — employees access
- Police evidence locker — police only

### Trunk inventory

- Open vehicle trunk → access trunk's inventory window
- Trunk has its own weight + slot limits
- Useful for carrying loot you can't fit personally

---

## Trading with other players

### Direct give

1. Open inventory (F2)
2. Other player's inventory shows on right (if standing next to them)
3. Drag item from your side to theirs
4. They get a "received" notification

### Trade money

- ox_lib's "pay" command, or
- Chat: `/pay <player_id> <amount>`
- Server processes the transaction with audit log

---

## Item metadata

Some items carry data:

- **Weapons** — serial number, durability, attachments
- **Drug bags** — purity %, source
- **Money orders** — value, creation time, expiry
- **Phone** — phone number, contacts
- **Vehicle keys** — vehicle ID

You see metadata when hovering / inspecting the item.

---

## Item images

Each item has an icon (PNG) in the inventory grid. If an item shows a placeholder (question mark):

- The image file is missing — admin should add it
- Won't affect functionality, just visuals

---

## Picking up items in the world

When an item is on the ground:

- A "Bag" prop is visible
- ox_target prompt: "Pickup"
- Confirm — item enters your inventory (if weight allows)
- The world bag despawns

---

## Dropping items

- Right-click item → "Drop"
- Or drag the item out of the inventory grid window
- Confirm if quantity > 1
- Item appears as a world bag at your feet

> ⚠️ **Anyone can pick up dropped items.** Don't drop important things in public.

---

## Tips

- **Always keep a lockpick + scissors** — universally useful
- **Stack identical items.** They auto-stack to a limit (e.g., 100× bandsofnotes)
- **Use the hotbar for combat items.** Gun in slot 1, bandage in slot 2, lockpick in slot 3
- **Empty your inventory before storage runs.** You'll want max weight free for loot
- **Don't carry the wash money order through PvP.** Drop it before fights if you can
- **Vehicle trunks are great for transport.** Heavy items go in trunk, light stuff personal

---

## Common questions

**My inventory is locked / won't open. Help?**
- Try `/inv` chat command
- Check you don't have another menu open (NUI conflict)
- Restart client if needed

**Why can't I pick up this item?**
- Weight limit reached (drop something or store in trunk)
- Slot count limit reached (rarer)
- Item is rare/special and you don't meet the conditions

**Can I have a "second" inventory?**
- Not on your character. Use stashes (gang, house, vehicle) for overflow.

**What if I die — do I lose inventory?**
- Some servers: full inventory loss (death drop)
- Most servers: partial loss (cash + some items)
- Check rules / staff for server-specific behavior

**Why is my screen showing a different inventory style?**
- Different inventory plugin — ox_inventory vs qb-inventory have different looks
- gangwars uses ox_inventory

---

## Related

- [../06-systems/items.md](../06-systems/items.md) — what items exist
- [../11-survival/death-and-respawn.md](../11-survival/death-and-respawn.md) — inventory on death
- [radial-menu.md](radial-menu.md) — alternative item access