Inventory

# vRP Inventory – Descriere Tehnică 

Video: https://imgur.com/KzeulMD.mp4

## Prezentare
Acest script implementează un sistem de inventar modern (NUI) pentru FiveM, compatibil cu framework-ul vRP. Inventarul se deschide prin tasta **I** sau comanda **/inventar** și oferă o interfață dark, optimizată și intuitivă pentru gestionarea itemelor jucătorului.

Scriptul folosește comunicare NUI (HTML/CSS/JS) ↔ client.lua ↔ server.lua și toate acțiunile asupra inventarului sunt procesate server-side pentru siguranță.

---

## Arhitectură

### Client (client.lua)
- Deschide și închide inventarul
- Trimite datele către NUI
- Primește acțiuni din UI (folosește, aruncă, oferă)
- Detectează jucătorul cel mai apropiat pentru funcția „Oferă”
- Apelează evenimentele server-side vRP

### Server (server.lua)
- Interfață cu framework-ul vRP
- Citește inventarul real al jucătorului
- Aplică acțiunile:
 - folosire item
 - aruncare item
 - transfer item către alt jucător
- Validează user_id, cantitatea și distanța (anti-exploit)

### NUI (HTML / CSS / JS)
- Afișează inventarul sub formă de grid
- Carduri compacte pentru iteme
- Emoji pentru fiecare item
- Filtrare, căutare și categorii
- Scrollbar custom dark
- Dropdown custom (fără elemente HTML native)

---

## Categorii de iteme
Itemele sunt clasificate automat pe baza numelui lor:

- ALL – toate itemele
- ILEGALE – droguri și substanțe
- ARME – arme de foc
- MÂNCARE – alimente
- BĂUTURI – băuturi alcoolice și non-alcoolice
- MEDICAL – iteme medicale
- UNELTE – unelte și kit-uri
- LICENȚE – permise și legitimații
- MATERIALE – resurse și obiecte brute
- ALTELE – fallback automat

Filtrarea este instant și nu reîncarcă UI-ul.

---

## Funcționalități

- Căutare iteme în timp real după nume
- Afișare cantitate și greutate
- Afișare greutate curentă / maximă
- Acțiuni disponibile:
 - Folosește item
 - Aruncă item
 - Oferă item jucătorului apropiat
- Selectare cantitate
- Design dark modern

---

## Securitate
- Toate modificările de inventar sunt procesate server-side
- Validare user_id
- Limitare cantitate
- Verificare distanță la transfer
- Prevenție exploit-uri

---

## Performanță
- UI se încarcă doar la deschidere
- Fără loop-uri constante
- Consum minim de resurse
- Optimizat pentru inventare mari

---

## Compatibilitate
- Framework: vRP
- FiveM CEF
- Nu este compatibil cu ESX

---

## Extensibilitate
Scriptul poate fi extins cu:
- stash / depozit
- portbagaj
- crafting
- hotbar
- trading UI

---

## Concluzie
vRP Inventory oferă un sistem stabil, sigur și modern pentru gestionarea itemelor, îmbunătățind semnificativ experiența jucătorilor pe serverele vRP.