# qs-inventory — Referință Rapidă

## Instalare
- **Dependință**: `MugShotBase64`
- **Framework**: ESX / QBCore / Qbox (pre-edited cores pe GitHub)
- **Înlocuiește**: `qb-inventory`, `esx_inventoryhud`
- **Load Order**: imediat după framework core în `server.cfg`
- **Database**: import SQL pentru stashes, trunks, gloveboxes, metadata users

## Configurare

### config.lua (principal)
- Auto-detectează framework
- `Config.DisableShopGenerationOnClient` — dacă `true`, shop-urile se înregistrează via server exports
- `Config.UseTarget` — suport `qb-target` și `ox_target`
- `Config.TransparentBackground` — UI transparency

### Alte config-uri
`crafting.lua`, `customWeapons.lua`, `garbage.lua`, `selling.lua`, `storage.lua`, `vehicles.lua`

## Item Configuration
- **Vizual**: `prop`, `props`, `rarity` (common→legendary), `visibleObject`
- **Comportament**: `decay` (zile), `remove` (la use), `progress` (ms), `animation` (dict/name), `disableThrow`
- **Cerințe**: `requiredJob`, `requiredSkill` (level system)
- **Avansat**: `createdObject` + `export` (trigger la spawn), `dropRotation`

## Misiuni
- Definite în `config.lua` cu ID, label, goal, rewards
- Activare: `exports['qs-inventory']:AssignQuests(taskId, source)` (Server)
- Rewards automate la îndeplinirea goal-ului

## Comenzi
| Comandă | Scop |
|---------|------|
| `/inventory` | Deschide inventar |
| `/closeinv` | Închide inventar |
| `/hotbar` | Toggle hotbar |
| `/giveitem` | Dă item unui jucător |
| `/rob` | Rob player |
| `/clearinv` | Șterge inventar (Admin) |

## Exports Core (Server)
```lua
exports['qs-inventory']:AddItem(source, item, amount, slot, info)
exports['qs-inventory']:RemoveItem(source, item, amount, slot)
exports['qs-inventory']:GetInventory(source)
exports['qs-inventory']:RegisterStash(id, slots, weight)
```

## Export (Client)
```lua
exports['qs-inventory']:getUserInventory()
```

---

## Items adăugate pentru resurse externe

### wasabi_police (adăugate 2026-03-29)
```lua
['bobby_pin']           -- Bobby Pin (lockpick cătușe)
['tracking_bracelet']   -- Tracking Bracelet (monitorizare suspect)
['handcuffs']           -- Handcuffs (exista deja)
```
Imagini copiate: `bobby_pin.png`, `tracking_bracelet.png`, `handcuffs.png` → `html/images/`

### wasabi_ambulance (items necesare — de verificat)
```lua
['defib']       -- Defibrilator (revive)
['medikit']     -- Medical Kit (heal)
['sedative']    -- Sedative
['medbag']      -- Medical Bag
['tweezers']    -- Tweezers (treat shot)
['suturekit']   -- Suture Kit (treat stabbed)
['icepack']     -- Ice Pack (treat beat)
['burncream']   -- Burn Cream (treat burned)
['bandage']     -- Bandage
```

## Cine folosește qs-inventory exports
| Resursă | Ce folosește |
|---|---|
| `qb-core` | AddItem/RemoveItem bridge |
| `wasabi_police` | setInventoryDisabled(bool) la cuff, searchPlayer, stash |
| `wasabi_ambulance` | removeItemsOnDeath, medical supplies |
| `t1ger_lib` | stash mechanic/tuning |
| `luxu_admin` | admin item management |
| `qs-advancedgarages` | trunk/glovebox stash |
| `qs-shops` | shop items |
| `rcore_casino` | casino chips/items |
| `codem-mdt` | inventory check |