red-valley/docs/server_knowledge.md

# Red Valley Roleplay — Server Knowledge Base

## 🔑 Quick Reference

| Key | Value |
|-----|-------|
| **Server Name** | Red Valley Roleplay |
| **Framework** | QBCore |
| **Database** | MySQL (`red-valley`) via `oxmysql` |
| **Character System** | 17mov_CharacterSystem v1.2.5 |
| **Admin Panel** | Luxu Admin |
| **Inventory** | qs-inventory (Quasar) |
| **Phone** | qs-smartphone-pro (Quasar) |
| **Garages** | qs-advancedgarages v5.0.20 (Quasar) |
| **Housing** | qs-housing (Quasar) |
| **Vehicle Keys** | qs-vehiclekeys (Quasar) |
| **Police Job** | wasabi_police v1.10.8 (Wasabi) |
| **Ambulance Job** | wasabi_ambulance v1.14.2 (Wasabi) |
| **Police MDT** | codem-mdt (CodeM) |
| **Mechanic Job** | t1ger_mechanic |
| **HUD** | 17mov_Hud |
| **Voice** | pma-voice |
| **Target System** | qb-target |
| **Server Port** | 30110 |
| **Max Clients** | 8 |
| **Game Build** | 3570 |
| **Locale** | ro-RO |
| **OneSync** | On (Infinity + Beyond) |
| **phpMyAdmin** | http://localhost/phpmyadmin/ |

---

## 📁 Resource Structure

```
resources/
├── [cfx-default]/           # CFX default resources
├── [framework]/
│   ├── [core]/
│   │   ├── qb-core/         # QBCore framework
│   │   ├── qb-target/       # Target system
│   │   ├── qs-inventory/    # Quasar inventory
│   │   └── no-npc/          # Remove ambient NPCs
│   ├── [base]/
│   │   ├── [auth]/
│   │   │   ├── 17mov_CharacterSystem/   # Character select + creation
│   │   │   ├── 17mov-plugin-char-creator/ # Spawn outfit in creator
│   │   │   └── connectqueue/             # Queue system
│   │   ├── [ui]/
│   │   │   └── 17mov_Hud/   # HUD system
│   │   └── [jobs]/
│   │       └── [legal]/
│   │           ├── [police]/
│   │           │   ├── wasabi_police/  # Police job (provides qb-policejob)
│   │           │   ├── codem-mdt/     # Police MDT
│   │           │   ├── codem-dispatch/ # Dispatch alerts
│   │           │   └── codem-mdtProp/ # MDT prop
│   │           ├── [ambulance]/
│   │           │   └── wasabi_ambulance/ # Ambulance job (provides qb-ambulancejob)
│   │           ├── [mechanic]/
│   │           │   └── t1ger_mechanic/ # Mechanic job
│   │           └── [tuner]/
│   │               └── t1ger_tuningsystem/ # Tuning system
│   ├── [depends]/
│   │   ├── bob74_ipl/        # IPL loader v2.6.0 (interiors, DLC maps)
│   │   ├── ox_lib/           # Overextended lib
│   │   ├── PolyZone/         # Zone management
│   │   ├── progressbar/      # Progress bars
│   │   ├── screenshot-basic/ # Screenshots
│   │   ├── VehicleDeformation/ # Vehicle damage
│   │   ├── wasabi_bridge/    # Wasabi framework bridge
│   │   └── xsound/          # Sound system
│   └── [addons]/
│       ├── 0r_idcard/        # ID card system
│       ├── bit-driverschool/ # Driving school
│       ├── qs-advancedgarages/ # Garages (Quasar)
│       ├── qs-housing/       # Housing (Quasar)
│       ├── qs-shops/         # Shops (Quasar)
│       └── qb-weathersync/   # Weather & time
├── [stream]/
│   ├── [admin-outfit]/AdminPack/  # Admin clothing streaming
│   ├── [mlos]/               # Map interiors
│   │   ├── soloty-southside-custom/ # Mechanic shop MLO (t1ger_mechanic blips/markere)
│   │   ├── rfc_los_santos_customs/  # Los Santos Customs MLO (RFC Mapping)
│   │   ├── cfx-fm-fleeca-banks-v2/  # Fleeca banks
│   │   ├── cfx-fm-mrpd/            # Mission Row PD
│   │   └── ...                      # + hospital, prison, gas stations, etc.
│   └── [vehs]/               # Custom vehicles
├── [voice]/
│   └── pma-voice/            # Voice system
└── luxu_admin/               # Admin panel (top-level)
```

### Load Order (`resources.cfg`)
```
[cfx-default] → ox_lib → [core] → [depends] → [voice] → [auth] → [ui] →
[jobs] → [addons] → kq_carheist → [mlos] → [vehs] → minimap → phone-props →
[casino] → [stream] → luxu_admin → [weapons]
```

---

## 🎭 Character & Outfit System

### Character Creation Flow
1. Player connects → `connectqueue` (priority queue)
2. `17mov_CharacterSystem` → character select / create
3. **New character** → `creator` preset (DNA + Details only, 2 tabs)
4. `17mov-plugin-char-creator` → per-frame outfit loop on ped in creator (citizenid tracking)
5. After save → `ApplySpawnOutfit()` → gender-specific default clothes
6. `SaveCurrentSkin` → persist to DB (`playerskins`)

### Skin Menu Presets
| Context | Preset | Tabs Available |
|---------|--------|----------------|
| Character Creator | `creator` | DNA + Details (2 tabs) |
| Clothing Shop / Ambulance / Boss | `shop` | Details + Clothing + Accessories (3 tabs) |
| Admin `/skin` command | `skinCommand` | All 4 tabs |

### Spawn Outfit Defaults
- **Male:** torso2=539/2, pants=200/2, arms=96/0, shoes=77/8, t-shirt=15/0
- **Female:** torso2=583/1, pants=214/1, arms=18/0, shoes=81/10, t-shirt=15/0
- No mask for either gender

### Job Outfit System (pattern from mechanic)
- **ON duty** → `SaveCurrentOutfit()` saves civilian clothes → `ApplyOutfit(jobOutfit)` applies uniform
- **OFF duty** → `ApplyOutfit(savedCivilOutfit)` restores civilian clothes
- Outfit data per job stored in `17mov_CharacterSystem/configs/Config.lua` → `Config.Outfits['JOBNAME']`
- Structure: `[grade][outfitIndex]{outfitLabel, outfitData}` for male and female
- Workflow defined in `.agents/workflows/job-outfit-setup.md`
- **IMPORTANT**: Outfits NU apar la clothing shop-uri publice — se afișează DOAR prin `Config.ClothingRooms`
- ClothingRooms verifică `job.name == v.requiredJob` (stores.lua:285)
- Wasabi cloakroom pe QBCore e HIDDEN automat ("WILL NOT SHOW IN QBCORE")

### GTA Component IDs
```
Component 1  = mask          Component 5  = bag
Component 3  = arms          Component 6  = shoes
Component 4  = pants         Component 7  = accessory (neck)
Component 8  = t-shirt       Component 9  = vest
Component 11 = torso2        Prop 0 = hat, Prop 1 = glasses
```

---

## 🗄️ Key Cross-Resource Dependencies

| Central File | Resources That Depend On It |
|--------------|-----------------------------|
| `qb-core/shared/jobs.lua` | wasabi_police, wasabi_ambulance, codem-mdt, codem-dispatch, luxu_admin, t1ger_mechanic, qs-inventory |
| `qb-core/shared/items.lua` | qs-inventory, qs-shops, wasabi_police (bobby_pin, tracking_bracelet, handcuffs) |
| `qb-core/server/events.lua` | All QBCore resources |
| `ox_lib/locales/ro.json` | All translated notifications |
| `17mov_CharacterSystem/configs/Bridge.lua` | Bridge selections: clothing, apartments, housing |
| `17mov_CharacterSystem/configs/Config.lua` | t1ger_mechanic (outfit system), wasabi_police (outfit system) |
| `wasabi_bridge/` | wasabi_police, wasabi_ambulance |
| `resources.cfg` | Ensure order — ensure [jobs] loads all legal jobs |

### Bridge Configuration (`17mov_CharacterSystem/configs/Bridge.lua`)
- `Config.Housing = "standalone"` (qs-housing not auto-detected)
- `Config.Apartments = "standalone"`
- Clothing bridge: `qb-clothing`

---

## 🔔 Notification System
- **Standard**: `17mov_Hud` native notifications
  ```lua
  exports['17mov_Hud']:ShowNotification(message, type)
  ```
- Previous systems migrated from: `qs-notify`, `codem-notification`, `jg-hud`

---

## 🛡️ Admin & Permissions

### Admin Identifiers
| FiveM ID | Name | Permissions |
|----------|------|-------------|
| `fivem:44269` | Kotzu | group.admin |
| `fivem:6428737` | cata | group.admin + qbcore.god |
| `steam:11000013f508340` | rausse | group.admin + qbcore.god |
| `fivem:16062886` | kotzu pc | group.admin + qbcore.god |

### Permission Hierarchy
```
qbcore.god → group.admin → qbcore.admin → qbcore.mod
```

### Luxu Admin
- API Key configured in server.cfg
- Web panel with outfit system (Clone Yourself feature)
- `set luxu_admin_api_key` in server.cfg

---

## 📦 Database Notes

- **DB Name**: `red-valley`
- **Connection**: `server=127.0.0.1;database=red-valley;userid=root;` (via oxmysql)
- **Character Delete** (`qb-core/server/player.lua`): Many default tables commented out (apartments, bank_accounts, crypto_transactions, phone_invoices, phone_messages, player_contacts, player_houses, player_mails) — only `players`, `playerskins`, `player_outfits`, `player_vehicles` active
- **⚠️ PENDING**: `crypto_history` table has ~2,343 rows causing oversized queries — needs periodic cleanup or LIMIT

---

## ⏳ Pending Tasks (from changelog)

- [x] **wasabi_police install**: Copiat din _preLoad, jail='rcore', items adăugate în qs-inventory
- [x] **wasabi_ambulance**: Deja pe server (v1.14.2)
- [x] **wasabi_police config review**: Eliminat 'reporter' din policeJobs, confirmat cloakroom QBCore=17mov (2026-03-29)
- [x] **wasabi_police outfit**: Config.Outfits['police'] EXISTA DEJA în 17mov (grade 0-4, male+female, 5 variante) (2026-03-29)
- [x] **Synapse Map update**: wasabi_police + wasabi_ambulance nodes + conexiuni (2026-03-29)
- [x] **t1ger_tuningsystem debug**: Eliminat 6× console.log din NUI JS `web/assets/index-DkGtvbUP.js` (2026-03-29)
- [ ] **Console Wrapper (start_console.ps1)**: start.bat rămâne foreground (raw output), adaugă în .bat o linie care lansează și start_console.ps1 într-un al doilea terminal (organizat). Abordare: 2 ferestre — raw debug + clean display. Demo: `console_demo.ps1`. Template: `docs/console_display_template.md`
- [ ] **Webhooks** `qs-smartphone-pro`: configure in `server/custom/webhooks/webhooks.lua`
- [ ] **Webhooks** `qs-advancedgarages`: configure in `server/custom/misc/*.lua`
- [ ] **oxmysql oversized query**: `crypto_history` cleanup (DELETE rows older than 7 days)
- [ ] **Version updates**: `qs-inventory` 3.7.16→3.7.17, `qs-vehiclekeys` 4.0.13→4.0.29, `t1ger_mechanic` 3.6.7→3.6.9
- [ ] **Admin outfit setup**: Configure Luxu panel Clone Yourself + test outfit stack
- [ ] **Admin jacket blacklist**: Add in `Skin.BlacklistedInputValues`
- [ ] **spawn_mask** item: Custom usable item (mask 134/2 male, 134/3 female)

---

## 📋 Quasar Resources Documentation Status

| Resource | Status |
|----------|--------|
| qs-inventory | ✅ Documented (`docs/qs_inventory_reference.md`) |
| qs-housing | ⚠️ Partial |
| qs-advancedgarages | ❌ Not documented |
| qs-shops | ❌ Not documented |
| qs-smartphone-pro | ❌ Not documented |
| qs-vehiclekeys | ❌ Not documented |

---

## 🔧 Useful Commands & Exports

### qs-inventory (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)
```

### Admin Commands
- `/getoutfit` — Print clothing component IDs (from `t1ger_mechanic/getoutfit.lua`)
- `/skin` — Open full skin menu (all 4 tabs, `skinCommand` preset)

### 🖥️ Server Start (din IDE terminal)
```powershell
# Pornire server simplu
cmd /c "e:\FiveMserver\server\start.bat"
```
- **CWD**: `e:\FiveMserver\server`
- **start.bat v2.0** = launcher compact (RED VALLEY header, `[OK]` checks, separator `=======`)
- **Console Wrapper Demo**: `console_demo.ps1` — ANSI Shadow banner, loading bar, categorized output
- **Console Template**: `docs/console_display_template.md` — full display spec + char mappings
- **Next**: `start_console.ps1` — real wrapper (pipes start.bat → filtered display)
- **Stop**: Ctrl+C → apoi tastezi `quit` în consolă
- **Artifact**: `E:\FiveMserver\server\artifacts\FXServer.exe`
- **IMPORTANT**: Nu porni serverul de mai multe ori — verifică cu `Get-Process FXServer` înainte

### 🔇 Console Cleanup History
| Resursă | Fix | Metodă |
|---------|-----|--------|
| t1ger_mechanic | DETECTED SYSTEMS/GARAGE/KEYS | Comentat print-uri (bridge/init.lua) |
| t1ger_tuningsystem | 6× console.log NUI | Eliminat din web/assets |
| t1ger_tuningsystem | has mechanic system | Comentat print (shared/config.lua:258) |
| rcore_casino | [Casino] Framework/drunk | Print filter override (const.lua) |
| pma-voice | Starting/finished init | Comentat print-uri (client/init/init.lua) |
| qs-inventory | jobs_creator warning | Comentat Warning() (jaksam.lua:5) |
| qs-vehiclekeys | Debug prints | `Config.Debug = false` (deja setat) |
| bit-driverschool | 5× outdated warning | Comentat version.lua din fxmanifest |
| 17mov_CharacterSystem | ASCII banner + changelog | Config: DisplayAsciiArt/Changelog/Files = false |
| cfx-gabz-mapdata | Parse error | ⚠️ Nerezolvabil (compiled bytecode) |

---

## 📂 Key File Locations

| Purpose | Path |
|---------|------|
| Server config | `server.cfg` |
| Resource load order | `resources.cfg` |
| QBCore jobs | `resources/[framework]/[core]/qb-core/shared/jobs.lua` |
| QBCore items | `resources/[framework]/[core]/qb-core/shared/items.lua` |
| Character system | `resources/[framework]/[base]/[auth]/17mov_CharacterSystem/` |
| Skin presets | `17mov_CharacterSystem/configs/Skin.lua` |
| Job outfits config | `17mov_CharacterSystem/configs/Config.lua` |
| Bridge config | `17mov_CharacterSystem/configs/Bridge.lua` |
| HUD config | `resources/[framework]/[base]/[ui]/17mov_Hud/Config.lua` |
| Mechanic job | `resources/[framework]/[base]/[jobs]/[legal]/[mechanic]/t1ger_mechanic/` |
| Police job | `resources/[framework]/[base]/[jobs]/[legal]/[police]/wasabi_police/` |
| Ambulance job | `resources/[framework]/[base]/[jobs]/[legal]/[ambulance]/wasabi_ambulance/` |
| Police MDT | `resources/[framework]/[base]/[jobs]/[legal]/[police]/codem-mdt/` |
| Dispatch | `resources/[framework]/[base]/[jobs]/[legal]/[police]/codem-dispatch/` |
| Changelog | `changelog.md` |
| Cross-resource tracking | `cross_resource_modifications.md` |
| DB SQL dump | `red-valley.sql` (430KB) |
| Server start script | `start.bat` |
| Pre-load assets | `_preLoad/` |
| Cfx.re catalog | `docs/cfx_assets_catalog.md` (142 assets total) |

---

## 🚗 Cfx.re Assets Overview (142 total)

Key vendors: Quasar Store, ak4y, Malizniakk (17mov), T1GER, Kuzkay, rcore, wasabirobby, ThaC (CodeM), Eichenholz (sky_), OnexScripts, Gabz, 0Resmondev

Notable assets on server:
- 17mov Character System, 17mov Hud, 17mov multiplayer jobs (12+)
- T1GER Mechanic System, Tuning System, Car Lift, Prop Pack
- Quasar: Inventory, Housing, Garages, Shops, Smartphone PRO, Vehicle Keys, Banking, Fuel, etc.
- Wasabi: Police, Ambulance, Bridge, Evidence, Crutch
- rcore: Casino, Prison, Doorlock, Tattoos, Clothes, Fuel, Stats, Shortcuts
- Luxu Admin
- Various MLO packs (Gabz PDM, MRPD, Vespucci LSPD, Fleeca Banks)

---

## 📜 Changelog Summary (reverse chronological)

| Date | Focus |
|------|-------|
| 2026-03-29 | wasabi_police install + config review, console cleanup (10 resurse), start.bat v2.0, bit-driverschool fix, 17mov banner off, bob74_ipl v2.6.0, Synapse Map |
| 2026-03-28 | Driving School integration, ID Card notifications, Weather sync |
| 2026-03-27 | Spawn Outfit System, Character Delete fix, Skin presets, Char Creator plugin |
| 2026-03-04 | Mechanic Job Outfit System (auto-equip on duty) |
| 2026-03-03 | Mechanic Garage & Keys, 6 Bug Fixes, 17mov update v1.2.4→v1.2.5 |
| 2026-03-02 | Server Architecture Research, Cfx.re Audit, Admin Outfit Research |
| 2026-03-01 | HUD Migration (jg-hud→17mov), Luxu Admin update, No-NPC, QBCore updates |
| 2026-02-27 | Luxu Admin install, rv-mdt creation, BMW M3 F80, QBCore server events refactor |
| 2026-02-19 | Remove mChat, resource updates |
| 2026-02-17 | QS-Inventory core update |
| 2026-02-02 | Remove codem-pausemenu, vehicle swaps, TLS |
| 2026-01-19 | Helnius Xero24 Gas Station MLO |
| 2026-01-18 | ConnectQueue, Wasabi Police, Bank MLO, Codem Radio, QS-Shops |
| 2026-01-07 | Cache cleanup |