Errores que no dependen de un script concreto. Cada entrada da el síntoma, por qué ocurre y cómo se arregla.
En el lado del jugador
El cursor aparece pero la interfaz no
Síntoma. Un jugador abre un menú y le sale el cursor del ratón, pero no se dibuja nada en pantalla. El resto de jugadores del mismo servidor lo ven bien.
Causa. La fecha o la hora del Windows de ese jugador está muy lejos de la real. Con el reloj muy desajustado, las interfaces pueden no mostrarse aunque el script las haya abierto.
Solución. Sincronizar la hora de Windows y reiniciar FiveM.
Abre los ajustes de fecha y hora
Configuración de Windows → Hora e idioma → Fecha y hora.
Activa la hora automática
Activa Establecer la hora automáticamente y Establecer la zona horaria automáticamente.
Sincroniza
Pulsa Sincronizar ahora, cierra FiveM del todo y vuelve a entrar.
Una forma rápida de distinguirlo de un problema del servidor: si le pasa a un solo jugador, es su ordenador. Si les pasa a todos, mira la consola del servidor.
Al arrancar el servidor
Could not find dependency ... for resource ...
Causa. Falta un recurso obligatorio, se ha renombrado o arranca después del script.
Solución. Instala el recurso que nombra el mensaje y pon su ensure por encima del script. Consulta Requisitos.
Could not find dependency /onesync
Causa. OneSync está desactivado. Todos los scripts de Cuxial lo necesitan.
Solución. Activa OneSync en txAdmin, o añade set onesync on a la configuración del servidor, y reinicia el servidor.
You lack the required entitlement to use ...
Causa. La clave de licencia del servidor no pertenece a la cuenta de Cfx.re dueña del script.
Solución. Usa una clave de licencia generada con la cuenta que lo compró y reinicia el servidor. Más en las Preguntas frecuentes.
El script no carga después de subirlo por FTP
Causa. La subida quedó incompleta o los archivos se alteraron por el camino. Los scripts protegidos necesitan todos sus archivos intactos, incluido el archivo .fxap de la carpeta del script.
Solución. Borra la carpeta en el servidor y vuelve a subirla desde la descarga original. Comprueba que se incluyen los archivos ocultos y los que no tienen una extensión conocida.
[cuxial_bridge] aviso: no se detectó framework, usando fallback "qbox"
Causa. No había ningún framework compatible en marcha cuando cargó el script, así que Cuxial Bridge asumió QBox.
Solución. Arranca tu framework antes que cuxial_bridge y que los scripts de Cuxial. Si la carpeta de tu framework tiene un nombre no estándar, fuérzalo como se explica en Cuxial Bridge.
Un error menciona @cuxial_bridge/init.lua o @ox_lib/init.lua
Causa. cuxial_bridge u ox_lib falta, se ha renombrado o arranca después del script.
Solución. Conserva los nombres de carpeta originales y arranca los dos antes que cualquier script de Cuxial.
Un error de base de datos dice que una tabla no existe
Causa. No se ejecutó el SQL del script, o se ejecutó en una base de datos distinta de la que usa oxmysql.
Solución. Ejecuta los archivos SQL de la carpeta install del script en la base de datos de tu servidor. La página de instalación del script los enumera.
Después de editar archivos
El script deja de arrancar después de editar la configuración
Causa. Un error de sintaxis en shared/config.lua o en un archivo data/*.lua: falta una coma, una comilla o una llave de cierre.
Solución. La consola del servidor indica el archivo y la línea. Corrígelo, o restaura el archivo desde tu copia de seguridad, y reinicia el script.
Faltan textos o aparecen como códigos
Causa. El archivo de idioma dejó de ser JSON válido tras editarlo, o el idioma configurado en ox:locale no tiene archivo en la carpeta locales del script.
Solución. Valida el archivo JSON y comprueba que existe el archivo del idioma. Consulta «¿Cómo cambio el idioma?» en las Preguntas frecuentes.
Mis cambios no se aplican
Causa. No se reinició el script, o la carpeta editada no es la que carga el servidor.
Solución. Reinicia el script o el servidor entero. Si guardas una copia antigua del script dentro de resources, quítala: puede que el servidor esté cargando esa.