93 lines
3.1 KiB
Markdown
93 lines
3.1 KiB
Markdown
|
# 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 |
|
||
|
|
|