Cuxial CM Services
Sanciones — cárcel administrativa + servicio comunitario con tareas interactivas.
Resumen
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.
Requisitos
Requiere cuxial_bridge. Descárgalo e inícialo antes que este script (ver la doc del bridge). El bridge es lo que le da compatibilidad con QBox, ESX y QBCore.
Compatible con QBox, ESX y QBCore. No necesitas listar tu framework como dependencia: el bridge lo detecta y lo conecta por ti.
Asegúrate de tener estos recursos instalados e iniciados antes que el script:
Instalación
- Instala cuxial_bridge si aún no lo tienes (ver su doc).
- Sube la carpeta cuxial_cmservices a resources/[cuxial]/.
- Instala las dependencias listadas arriba.
- Importa el archivo .sql incluido a tu base de datos (si el script lo trae).
- Añade los ensure a tu server.cfg respetando el orden.
- Reinicia el servidor por completo.
# Tu framework (QBox / ESX / QBCore) ya debe estar iniciado
ensure ox_lib
ensure oxmysql
# Núcleo de Cuxial — siempre antes que los scripts
ensure cuxial_bridge
ensure bl_sprites
# El script
ensure cuxial_cmservicesSi el script incluye un .sql, impórtalo una sola vez. Algunos scripts hacen migraciones automáticas — revisa el README incluido.
Configuración
Toda la configuración editable está en texto plano (la lógica va protegida por Cfx.re Escrow). Edita estos ficheros para ajustar el script a tu servidor:
- config/
Protegido por Cfx.re Escrow — Compatible con QBox · ESX · QBCore (vía cuxial_bridge) — config/ abierto y editable — Requiere reemplazar el webhook de Discord y adaptar bl_sprites/chat — Soporte por tickets en la web — Actualizaciones incluidas
Comandos
/sancionesAbre 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)/taskcoordsDev tool para mapear coords/objetos de tareas (restringir en producción)Características
- 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)
Rendimiento
Lógica y NUI solo activas durante una sanción; prepared statements y queries por tipo