## 🇪🇸 Cuxial Garages + Keys System + Carwipe — Garajes + Llaves + Car Wipe

Sistema de garajes todo-en-uno multi-framework (**QBox · ESX · QBCore**) con **NUI en Svelte 5**: públicos, de trabajo, depósito (impound) y de casa. Incluye un **sistema de llaves interno** que provee `qbx_vehiclekeys` (al spawnear, qbx da la llave automáticamente), **car wipe server-authoritative** con zonas protegidas, **incautación** con RP de remolque, **financiamiento** (jg-dealerships), **kilometraje real**, **cámara cinematográfica** al sacar, transferencias entre jugadores y garajes, y un **panel de administración in-game**. Color de acento configurable que re-tematiza toda la interfaz. **Escrow-safe.**

### ✨ Características principales

• **4 tipos de garaje** — público, de trabajo (job), depósito/impound y de casa (housing).

• **2 modos de UI** — compacto (panel lateral) y normal (cuadrícula central).

• **Marcadores custom** (`.ytd` streameado) con billboard, rebote senoidal y textura por tipo de garaje.

• **Stats por vehículo** — combustible, motor, carrocería y **kilometraje real** (jg-vehiclemileage).

• **Cámara cinematográfica** al previsualizar/sacar (modo compacto).

• **Apodos y favoritos** por vehículo, con categorías (coche/moto/aire/mar) y filtrado.

• **Transferencias** — a otro jugador, a otro garaje o traer aquí; + recuperación de vehículos fuera.

• **Financiamiento** — ver y pagar cuotas desde el garaje (jg-dealerships).

• **Garajes de trabajo** — flota por rango + menú de extras/liveries; se devuelven (no se guardan).

• **Sistema de incautación** — depósitos, retiro pagando, incautar (oficial), liberar (autoridad).

### 🔑 Sistema de llaves interno (provee qbx_vehiclekeys)

• **Item de ox_inventory** con metadata { plate, ssn }; **provee `qbx_vehiclekeys`** (al spawnear, qbx da la llave automáticamente).

• **Cerrar/abrir (L), motor (G), carjack, hotwire (H), lockpick**, llaves compartidas por trabajo y dispatch.

• **Entregar llave por ox_target** — apunta a un jugador junto a tu coche para darle copia.

### 🧹 Car wipe + housing + admin

• **Car wipe server-authoritative** — propios vuelven a su garaje, zonas protegidas y NUI de cuenta regresiva.

• **Car wipe automático programado** con ox_lib cron (expresión configurable).

• **Garajes de casa por export** (efímeros) para integrar con cualquier sistema de housing.

• **Bajada de ocupantes con animación** antes de guardar/devolver.

• **Panel de administración in-game** — crear/editar garajes, capturar coords, buscar/dar/mover/incautar vehículos.

• **Escrow-safe** — config/data/locales en texto plano (editables), lógica en bytecode.

### ⌨️ Comandos

| Comando | Función |

|---|---|

| `/garageadmin` | Abre el panel de administración (admin) |

| `/impound` | Incauta el vehículo cercano (jobs de impound, oficial) |

| `/carwipe [seg]` | Inicia la limpieza de vehículos abandonados (admin) |

| `/cancelwipe` | Cancela la limpieza en curso (admin) |

| `/givekey [id]` | Da tu llave a un jugador cercano o por ID |

| `/adminkey [placa]` | Crea una llave de cualquier vehículo (admin) |

### 🔧 Compatibilidad y dependencias

• **Multi-framework:** QBox · ESX · QBCore (vía nuestro `cuxial_bridge` gratuito — mismo script en los 3 sin tocar código).

• **Dependencias:** `cuxial_bridge`, `ox_lib`, `oxmysql`, `ox_inventory`, `ps-dispatch` (opcional), `jg-dealerships` (opcional), `jg-vehiclemileage` (opcional), `ox_target` (opcional).

• **Provee `qbx_vehiclekeys`** — desactiva otros vehiclekeys / car wipe para evitar conflictos.

### ⚡ Rendimiento

• **0.00ms** en idle (cliente y servidor).

• Estado replicado por **GlobalState**; car wipe **server-authoritative** con game pool client-side.

### 🛡️ Extras

• Protegido por **Cfx.re Escrow**.

- `shared/config.lua` + `data/*.lua` + `locales/` abiertos y editables.

• **Keybinds:** **L** cerrar · **G** motor · **H** hotwire.

• **Soporte por tickets** en la web.

• **Actualizaciones incluidas.**