Problemas que puedes resolver desde tu servidor, con su causa y la solución.

El recurso no arranca

Causa. Falta una dependencia, arranca después del script u OneSync está desactivado.

Solución. Activa OneSync y arranca primero las dependencias:

server.cfg

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

Los comandos no existen o responden que no tengo permiso

Causa. El jugador no está en el grupo ACE de restricted o no tiene el permiso del bridge de admin.permission.

Solución. Añade al miembro del staff al grupo y da el permiso al grupo, como se muestra en Comandos y permisos. En ESX, pon en admin.permission el grupo del staff (por ejemplo admin).

El aviso [E] no sale junto a la tarea

Causa. El aviso aparece a comserv.interactDistance del borde del objeto y dentro de comserv.taskHeight de altura. Si object.coords en data/tasks.lua no coincide con el objeto del mundo, el aviso se mide desde un punto vacío.

Solución. Apunta al objeto con /taskcoords, pulsa G y sustituye coords y object de esa tarea por los valores copiados. Para que el aviso salga desde más lejos, sube interactDistance.

Al pulsar E responde «Estás demasiado lejos de la tarea»

Causa. El servidor mide desde coords de la tarea, con comserv.taskRadius + 1,5 m. O bien coords y object.coords apuntan a sitios distintos, o interactDistance / interactMaxReach dejan salir el aviso más lejos de lo que acepta el servidor.

Solución. Usa la misma posición en coords y en object.coords. Si subiste la distancia de interacción, sube también taskRadius.

El panel muestra «Esperando tarea…» y no aparece ninguna tarea

Causa. Todas las categorías de zones en data/tasks.lua están vacías, o el archivo tiene un error de sintaxis.

Solución. Añade al menos una tarea a una categoría. Revisa la consola del servidor al arrancar el recurso por si hay errores.

El jugador vuelve a la entrada de la zona mientras trabaja

Causa. La tarea, o el camino hasta ella, queda fuera del polígono de zone.points. El cliente y la comprobación del servidor devuelven a quien esté fuera.

Solución. Pon comserv.zoneDebug = true, reinicia y recorre las paredes. Mueve las esquinas hasta que todas las tareas y zone.entry queden dentro, y vuelve a ponerlo en false.

Un jugador en la cárcel vuelve a la celda una y otra vez

Causa. El jugador está a más de jail.distance de su celda, por ejemplo porque las celdas de data/jail.lua están lejos de la zona por la que puede moverse.

Solución. Revisa las posiciones de las celdas y sube jail.distance si la zona de la cárcel es grande.

El webhook de Discord no envía nada

Causa. Falta la convar o está mal escrita, se añadió después de arrancar el recurso, o logs.enabled es false.

Solución. Añade la convar a server.cfg con set y el nombre de logs.convar, y reinicia cuxial_cmservices:

server.cfg

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

Ha aparecido una tabla cuxial_cmservices_legacy_… en la base de datos

Causa. El recurso encontró una tabla de la versión 1.x y la migró. La tabla antigua se conserva como copia con ese nombre.

Solución. No hay nada que arreglar. Revisa tus sanciones en /sanciones y borra la tabla legacy si ya no la necesitas.

Mis sanciones antiguas han desaparecido al actualizar

Causa. Los registros antiguos estaban en una tabla con otro nombre, así que la migración no los encontró.

Solución. Para el recurso, renombra tu tabla antigua a cuxial_cmservices (apartando antes con otro nombre la nueva vacía) y arranca el recurso de nuevo. Se migra al arrancar.

Las sanciones no se anuncian en el chat

Causa. Cuxial Chat no está en marcha, chat.enabled es false o chat.resource no coincide con el nombre de la carpeta del chat.

Solución. Arranca cuxial_chat antes que cuxial_cmservices y revisa el bloque chat del config. Las notificaciones al staff y al jugador no dependen del chat.

Una tarea muestra su clave, como zone_new, en lugar de un nombre

Causa. Las claves name o progress.label de esa tarea no están en los archivos de idioma.

Solución. Añádelas a locales/en.json y locales/es.json y reinicia el recurso.

/sanciones no hace nada, o los paneles en pantalla no aparecen

Causa. Faltan archivos de la interfaz o están incompletos.

Solución. Vuelve a copiar la carpeta cuxial_cmservices entera desde el paquete y reinicia el recurso.