Preguntas generales que valen para todos los scripts. Para un script concreto, abre su página de Problemas frecuentes.

Licencia

¿Cómo funciona la licencia de los scripts?

Los scripts de Cuxial se entregan a través del sistema de escrow de Cfx.re. La compra queda vinculada a la cuenta de Cfx.re que la hizo, y el script solo funciona en un servidor cuya clave de licencia pertenezca a esa misma cuenta.

No se introduce ninguna clave en el script. La comprobación la hace FiveM al arrancar el recurso.

¿Qué archivos puedo editar?

Los archivos que el escrow deja abiertos:

Archivo	Qué contiene
shared/config.lua	Las opciones del script.
data/*.lua	Datos editables, en los scripts que tienen esta carpeta.
locales/*.json	Textos de la interfaz y de las notificaciones.
install/	SQL y definiciones de items, en los scripts que tienen esta carpeta.

El resto del código está protegido y no se puede leer ni modificar.

Cuxial Bridge es la excepción: es gratuito y de código abierto, y se descarga desde GitHub.

La consola dice «You lack the required entitlement»

Causa. La clave de licencia del servidor no pertenece a la cuenta de Cfx.re dueña del script, o la compra todavía no ha llegado a esa cuenta.

Solución. Comprueba que el sv_licenseKey de la configuración del servidor se generó con la cuenta que compró el script y reinicia el servidor. Si la compra es de hace unos minutos, espera un poco y vuelve a reiniciar.

¿Puedo mover el script a otro servidor?

Sí, siempre que el otro servidor use una clave de licencia de la misma cuenta de Cfx.re.

Instalación

El servidor dice «Could not find dependency»

Causa. El recurso que nombra el mensaje no está instalado, tiene otro nombre de carpeta o no arranca antes que el script.

Solución. Instálalo, conserva su nombre de carpeta original y pon su línea ensure por encima del script. La lista completa está en Requisitos.

Si la dependencia que nombra es /onesync, lo que falta es OneSync: actívalo en txAdmin o con set onesync on.

¿En qué orden arranco todo?

oxmysql y ox_lib, después tu framework, inventario y target, después cuxial_bridge y por último los scripts de Cuxial.

server.cfg

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure ox_target

ensure cuxial_bridge

ensure cuxial_chat

Sustituye las líneas de framework, inventario y target por las que use tu servidor. El orden importa: Cuxial Bridge los detecta cuando carga cada script y no ve lo que arranca después.

¿Puedo renombrar la carpeta de un script?

No renombres cuxial_bridge: todos los scripts lo cargan con ese nombre exacto. Conserva también el nombre original de la carpeta de los scripts, porque otros recursos se refieren a ellos por su nombre.

¿Funciona con mi framework?

Cuxial Bridge es compatible con QBox, QBCore y ESX, con ox_inventory o qb-inventory, y con sleepless_interact, ox_target o qb-target.

Algunos scripts requieren un framework concreto. La tabla script por script está en Requisitos.

Cómo funciona la detección está en Cuxial Bridge.

Interfaz

La interfaz no aparece

Revisa esto por orden:

1. El script no está en marcha. Busca errores de su arranque en la consola del servidor. Una dependencia que falta o un orden de arranque incorrecto lo detienen antes de que cargue la interfaz.
2. Faltan los archivos de la interfaz. La interfaz viene ya compilada dentro de la carpeta web del script. Si esa carpeta se borró o la subida quedó incompleta, vuelve a copiar el script desde la descarga original.
3. Hay un error en la consola F8. Ábrela justo después de cuando debería haber aparecido la interfaz y lee las últimas líneas.
4. Solo le pasa a un jugador, y el cursor aparece pero la interfaz no. Lo más probable es que tenga mal la hora de Windows. Consulta Errores comunes.

¿Cómo cambio el idioma?

Los scripts usan el idioma configurado para ox_lib:

server.cfg

setr ox:locale "es"

Debe existir un archivo con ese nombre en la carpeta locales del script. Los scripts incluyen en.json y es.json.

¿Cómo cambio un texto?

Edita el texto en locales/<idioma>.json y reinicia el script. Cambia solo el texto de la derecha de cada línea, nunca la clave de la izquierda.

El archivo debe seguir siendo JSON válido. Una coma o una comilla de menos deja el script sin textos.

Actualizaciones

¿Pierdo mi configuración al actualizar?

No si sigues Actualizar un script. Tus opciones, datos y textos viven en archivos que son tuyos; la guía explica cómo llevarlos a la versión nueva.