## 🇪🇸 Cuxial CM Services — Sistema de sanciones: cárcel administrativa + servicio comunitario con tareas interactivas (QBox · ESX · QBCore)
Sistema administrativo de cárcel y comunitarias con **panel NUI**, **tareas físicas interactivas en el mundo**, **persistencia total** y **logs de Discord**. Los administradores sancionan a cárcel (por minutos) o a comunitarias (por tareas), con teletransporte automático, confinamiento por zona, GPS hacia el objetivo y un panel para gestionar a todos los sancionados.
### ✨ Características principales
-
**Dos tipos de sanción** — Cárcel administrativa (por minutos) y Comunitarias (por tareas).
-
**Teletransporte automático** a la zona al ser sancionado.
-
**Imposibilidad de escapar** — PolyZone en comunitarias y radio de distancia en cárcel.
-
**Tareas comunitarias interactivas** — 5 categorías (construcción, jardinería, limpieza, mantenimiento, reparaciones).
-
**Tareas aleatorias y rotativas** — cada tarea completada genera una nueva en otra ubicación.
-
**Sistema GPS en NUI** — dirección y distancia hacia la tarea actual.
-
**Objetos resaltados (outline)** + sprites interactivos con tecla **[E]** y **progressbar animada**.
-
**Cárcel con temporizador**, invencibilidad, desarme automático y bloqueo de ataque.
-
**Panel de administración NUI (Svelte)** — pestañas Comunitarias / Cárcel.
-
**Remover sanciones** a cualquier jugador (online u offline) desde el panel.
-
**Persistencia total** — las sanciones sobreviven a desconexiones y reinicios.
-
**Logs de Discord completos** (aplicada / removida / completada) con identificadores.
-
**Herramienta dev `/taskcoords`** para mapear coords y objetos de nuevas tareas.
-
**Protección anti-rename** y rendimiento (prepared statements, cache de nombres 5 min).
### ⌨️ Comandos
| Comando | Función |
|---|---|
| `/sanciones` | Abre el panel de administración de sanciones (`group.mod`) |
| `/comserv [id] [cant] [motivo]` | Da comunitarias a un jugador (`group.mod`) |
| `/endcomserv [id]` | Quita las comunitarias y libera al jugador (`group.mod`) |
| `/jaila [id] [min] [motivo]` | Encarcela a un jugador X minutos (`group.mod`) |
| `/endjail [id]` | Quita el tiempo de cárcel y libera (`group.mod`) |
| `/taskcoords` | Dev tool para mapear coords/objetos de tareas (restringir en producción) |
### 🔧 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`, `bl_sprites` (sprites de tareas).
-
Compatible con **QBox · ESX · QBCore** vía `cuxial_bridge`.
### ⚡ Rendimiento
- **0.00ms** en idle (cliente y servidor).
- Lógica y NUI solo activas durante una sanción; prepared statements y queries por tipo.
### 🛡️ Extras
- Protegido por **Cfx.re Escrow**.
- Carpeta `config/` abierta y editable.
-
Requiere **reemplazar el webhook de Discord** y adaptar `bl_sprites`/chat.
-
**Soporte por tickets** en la web.
-
**Actualizaciones incluidas.**
