Los problemas más habituales tras instalar Cuxial License, con la causa y la solución de cada uno.

El recurso no arranca

Causa. Falta una dependencia o arranca después. Cuxial License necesita ox_lib, oxmysql, cuxial_bridge y screencapture. La última es la habitual: no forma parte de un servidor por defecto.

Solución. Instala screencapture como se explica en Instalación y arranca todo en orden:

server.cfg

ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure screencapture
ensure cuxial_license

La captura no termina nunca, o la consola muestra un error de screencapture

Causa. screencapture está corriendo desde el código fuente en vez de una release empaquetada, su carpeta tiene otro nombre, o el artefacto del servidor es demasiado antiguo para él.

Solución. Vuelve a descargar la release empaquetada, comprueba que la carpeta se llama screencapture y contiene game/dist, y actualiza el artefacto del servidor. Si las capturas siguen fallando con tu proveedor de hosting, abre el fxmanifest.lua de screencapture y lee la nota que acompaña a su línea protocol.

Las tarjetas se emiten sin foto

Causa. Una de estas:

• La convar cuxial:fivemanageToken está vacía, mal escrita o definida después de que arranque el recurso. Se lee una vez, al arrancar.
• El token no vale para imágenes, así que la subida se rechaza.

Solución. Añade la convar por encima de ensure cuxial_license y reinicia el servidor:

server.cfg

set cuxial:fivemanageToken "TU_TOKEN_DE_FIVEMANAGE"

Las tarjetas emitidas mientras faltaba el token siguen sin foto. Emítelas otra vez.

La foto sale con el escenario detrás del personaje

Causa. El jugador no estaba delante de un fondo verde. O photo.greenScreenPos apunta a otro sitio, o la carpeta stream del recurso está incompleta y la sala no se cargó.

Solución. Recupera el greenScreenPos por defecto, o vuelve a copiar el recurso desde el paquete original, y reinicia el servidor.

Usar la tarjeta no hace nada

Causa. Una de estas:

• El objeto no está definido con client.export = 'cuxial_license.useLicenseCard'.
• El diseño de tarjeta usa otro nombre de objeto y ese objeto no tiene definición.
• Se cambió el nombre de la carpeta del recurso, así que el export ya no existe.
• El objeto se dio a mano. Solo las tarjetas emitidas por el script llevan los datos necesarios para mostrarse.
• Se borró el diseño de la tarjeta.

Solución. Revisa los objetos en Instalación, mantén el nombre de carpeta cuxial_license, y emite la tarjeta desde la oficina, /jobissue o el export IssueLicense.

«Este documento ha expirado. Necesitas sacar uno nuevo.»

Causa. El objeto no lleva los datos de su titular. Pasa con objetos que añadió otro recurso sin el nombre del titular.

Solución. Emite la tarjeta otra vez y tira el objeto antiguo.

/license está denegado

Causa. Al jugador le falta el permiso del framework indicado en admin.permission.

Solución. Dale ese permiso en tu framework, o cambia admin.permission por uno que tenga.

«Tu trabajo no está autorizado para esta acción.»

Causa. El trabajo del jugador no está en authorizedJobs, o su grado está por debajo del mínimo. Los valores de ejemplo del archivo piden grado 4.

Solución. Añade el trabajo con el grado que quieras en shared/config.lua. La clave es el nombre del trabajo, no su etiqueta.

El NPC de la oficina no aparece o no se puede interactuar con él

Causa. Las coordenadas de zones no están donde esperas, el modelo de ped no existe, o no hay ningún recurso de target en marcha.

Solución. Revisa coords y model, y arranca un recurso de target compatible con cuxial_bridge antes que el bridge. Reinicia el recurso después de cambiar el config.

La tienda dice que no hay licencias disponibles

Causa. La tienda solo lista las tarjetas con Cobrar dinero activado y sin Restringir Tarjeta a Trabajo.

Solución. Edita la tarjeta con /license y activa Cobrar dinero en el último paso. El importe puede ser 0.

Al jugador nunca le llega la solicitud de foto

Causa. El jugador ya tenía abierto uno de los paneles del script, o pasaron 60 segundos. El agente ve «La sesión de foto expiró».

Solución. Pide al jugador que cierre lo que tenga abierto y emite la tarjeta otra vez.

Los jugadores cercanos no ven la tarjeta que enseño

Causa. Están más lejos que showRadius, o ya están mirando otra tarjeta.

Solución. Acércate o sube showRadius.

El selector de hora del día del estudio de fotos no hace nada

Causa. El selector funciona a través de av_weather, y no está en marcha.

Solución. Arranca av_weather. La foto en sí no depende de él.

Las marcas de búsqueda y de peligroso nunca aparecen

Causa. Vienen de cuxial_police, y no está en marcha.

Solución. Arranca cuxial_police. Sin él las tarjetas se muestran sin marcas.

Han desaparecido licencias tras borrar un diseño de tarjeta

Causa. Borrar un diseño elimina todas las licencias emitidas con él.

Solución. No se puede deshacer desde el juego. Crea el diseño de nuevo y vuelve a emitir las tarjetas, o restaura una copia de la base de datos.

Errores de base de datos al arrancar el recurso

Causa. El usuario de la base de datos no puede crear tablas.

Solución. Ejecuta sql/install.sql a mano y reinicia el recurso.

Los paneles no se abren

Causa. La interfaz no carga. La carpeta web/build falta o está incompleta, normalmente tras una subida a medias.

Solución. Comprueba que dentro del recurso existen web/build/index.html y web/build/assets. Si no están, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

Los textos salen en otro idioma

Causa. El script sigue la convar ox:locale.

Solución. Defínela en server.cfg y reinicia. Vienen en y es:

server.cfg

setr ox:locale "es"