WantedList
========================================
vRP_WANTEDLIST – DOCUMENTAȚIE
========================================
Video: https://imgur.com/KX97WPW.mp4
1. PREZENTARE
------------------------------------------------
vRP_WantedList este un script FiveM destinat
facțiunilor de ordine publică (Poliție / S.I.A.S),
care permite afișarea, sortarea și localizarea
jucătorilor cu wanted activ printr-un meniu UI modern.
Scriptul funcționează exclusiv server-side verificat,
folosind vRP + ghmattimysql și NUI (HTML/CSS/JS).
------------------------------------------------
2. CERINȚE
------------------------------------------------
- FXServer: cerulean
- Framework: vRP
- MySQL: ghmattimysql
- OneSync: recomandat (Infinity / Legacy)
------------------------------------------------
3. STRUCTURA SCRIPTULUI
------------------------------------------------
vrp_wantedlist/
│
├─ fxmanifest.lua
├─ client.lua
├─ server.lua
└─ html/
├─ index.html
├─ style.css
└─ app.js
------------------------------------------------
4. BAZA DE DATE
------------------------------------------------
Tabel utilizat: vrp_users
Câmpuri necesare:
- id (INT) – ID unic jucător
- username (VARCHAR)– Nume jucător
- faction (VARCHAR) – Facțiunea
- wanted (INT) – Nivel wanted (0–6)
- m_wanted (TEXT) – Motiv wanted
- wanted_by (VARCHAR) – Ofițerul care a acordat wanted
------------------------------------------------
5. ACCES & PERMISIUNI
------------------------------------------------
Comanda:
/wanteds
Acces permis doar pentru:
- Politie
- S.I.A.S
Verificarea se face server-side,
citind facțiunea din vrp_users.faction.
------------------------------------------------
6. FUNCȚIONARE GENERALĂ
------------------------------------------------
1. Jucătorul folosește comanda /wanteds
2. Serverul verifică:
- user_id
- facțiunea
3. Dacă este permis:
- se deschide meniul UI
- se încarcă lista cu jucători wanted
------------------------------------------------
7. LISTA WANTED
------------------------------------------------
Sunt afișați doar jucătorii cu:
wanted > 0
Pentru fiecare jucător:
- Username
- Facțiune
- Nivel wanted (stele dinamice)
- Motiv wanted
- Ofițer care a acordat wanted
- Status (Online / Offline)
- Distanța față de jucător (dacă este online)
------------------------------------------------
8. SORTARE
------------------------------------------------
- DESC – Wanted 6 → 1
- CRESC – Wanted 1 → 6
- Nume – A → Z / Z → A
- Distanță – Mic → Mare
------------------------------------------------
9. FILTRARE
------------------------------------------------
- ALL – Toți jucătorii
- Online – Doar jucători online
- Offline – Doar jucători offline
- Reset – Elimină filtrele
------------------------------------------------
10. PROFIL JUCĂTOR
------------------------------------------------
La selectarea unui jucător se afișează:
- Poză caracter (headshot ped)
- Username + ID
- Facțiune
- Nivel wanted
- Motiv wanted
- Ofițer emitent
- Status online/offline
------------------------------------------------
11. LOCALIZARE
------------------------------------------------
Buton: „Localizează”
Funcționează doar pentru jucători online:
- Creează blip pe hartă
- Setează ruta GPS către țintă
------------------------------------------------
12. OPTIMIZARE
------------------------------------------------
- Headshot-urile sunt încărcate asincron
- UI compact la deschidere
- UI se extinde doar la selecție
- Fără loop-uri active inutile
- Interogări DB doar la cerere
------------------------------------------------
13. COMPATIBILITATE
------------------------------------------------
✔ vRP Classic / Extended
✔ ghmattimysql
✔ OneSync
✔ UI modern (NUI)
------------------------------------------------
14. POSIBILE EXTENSII
------------------------------------------------
- Istoric wanted
- Integrare jail
- Alertă automată WL6
- Log Discord
- MDT complet poliție
------------------------------------------------
15. CONCLUZIE
------------------------------------------------
vRP_WantedList este un sistem complet
pentru gestionarea și localizarea jucătorilor
cu wanted, destinat serverelor roleplay
care pun accent pe realism și performanță.
========================================