Cuxial Servicios Comunitarios crea su propia tabla en la base de datos y no necesita ítems de inventario. La única convar es la del webhook de Discord, y es opcional.

Comprueba las dependencias

Deben estar instaladas y funcionando antes de añadir el script:

• ox_lib
• oxmysql
• cuxial_bridge, sobre QBox, QBCore o ESX
• OneSync activado en el servidor

Una integración es opcional y se detecta sola:

• cuxial_chat: las sanciones puestas y cumplidas se anuncian en su canal de sanciones. Sin él no hay aviso en el chat; las notificaciones al staff y al jugador funcionan igual.

Copia el recurso

Coloca la carpeta cuxial_cmservices dentro de tu directorio resources.

Mantén el nombre de carpeta cuxial_cmservices. Otros recursos llaman a sus exports por ese nombre.

Si actualizas desde una versión anterior, borra la carpeta vieja y copia la nueva entera. Guarda una copia de tu config antiguo para trasladar tus valores.

Base de datos

No hay nada que importar. Al arrancar, el recurso crea la tabla cuxial_cmservices y añade las columnas que falten.

Arranca el recurso. La tabla se crea sola. install/cuxial_cmservices.sql se incluye solo como referencia de su estructura.

Si tus registros antiguos están en una tabla con otro nombre, renómbrala a cuxial_cmservices antes del primer arranque para que la migración la recoja.

Da el permiso a tu staff

Los comandos están restringidos al grupo ACE indicado en commands (group.mod por defecto), y el servidor comprueba además el permiso del bridge indicado en admin.permission (mod por defecto).

server.cfg

# Los moderadores tienen el permiso "mod"
add_ace group.mod mod allow

# Los admins heredan todo lo que pueden hacer los moderadores
add_principal group.admin group.mod

# Una línea por miembro del staff
add_principal identifier.license:xxxxxxxxxxxxxxxx group.mod

Consulta Comandos y permisos.

Configura el webhook de Discord (opcional)

Las sanciones puestas, retiradas y cumplidas se registran en Discord. La URL va en una convar del servidor, nunca en el config:

server.cfg

set cuxial_cmservices_webhook "https://tu-url-de-webhook"

Usa set, no setr. Con setr la URL se envía también a todos los clientes.

La convar se lee al arrancar el recurso. Si la añades o la cambias después, reinicia cuxial_cmservices. Sin la convar no se registra nada y todo lo demás funciona igual.

Ajusta las zonas

Abre data/tasks.lua y data/jail.lua para revisar la zona de comunitarias, las tareas y las celdas, y shared/config.lua para los puntos de salida. Los valores que se entregan son una ubicación de ejemplo.

Cada opción se explica en Configuración.

Arranca el recurso

Arráncalo después de sus dependencias y de tu framework:

server.cfg

ensure ox_lib
ensure oxmysql
# tu framework aquí
ensure cuxial_bridge
# opcional
ensure cuxial_chat
ensure cuxial_cmservices

Comprueba que funciona

1. Entra con una cuenta de staff y usa /sanciones. Se abre el panel.
2. Usa /comserv con tu propio id, 2 tareas y un motivo. Te lleva a la zona y la primera tarea aparece en el mapa.
3. Acércate al objeto de la tarea hasta que salga el aviso E y púlsalo. Corre la barra de progreso y baja el contador.
4. Termina la segunda tarea. Te lleva al punto de salida.
5. Usa /jaila con tu propio id, 1 minuto y un motivo. Te lleva a una celda y quedas libre un minuto después.

Siguiente: mueve las zonas y escribe tus propias tareas en Configuración.