Los problemas más habituales tras instalar Cuxial Admin, con la causa y la solución de cada uno. Los mensajes de consola se citan tal como los imprime el recurso.

El recurso no arranca

Causa. Falta una dependencia o arranca después del panel. Cuxial Admin necesita un framework (QBox, QBCore o ESX), ox_lib, oxmysql, un inventario y cuxial_bridge 2.14.0 o posterior.

Solución. Arranca primero las dependencias:

server.cfg

ensure oxmysql
ensure ox_lib
# tu framework y tu inventario
ensure cuxial_bridge
ensure cuxial_admin

Las líneas exactas de cada framework están en Instalación.

Revivir, curar, la guantera o el maletero dan un error en la consola del servidor

Causa. Cuxial Bridge es anterior a 2.14.0. El panel usa funciones añadidas en esa versión.

Solución. Actualiza Cuxial Bridge a 2.14.0 o posterior y reinicia el servidor.

En ESX la lista de vehículos para dar sale vacía

Causa. En ESX el catálogo se lee de la tabla vehicles de esx_vehicleshop, y esa tabla no existe.

Solución. Instala esx_vehicleshop con su SQL y reinicia el servidor.

En ESX el hambre y la sed siempre marcan 0 en la ficha

Causa. esx_status no está en marcha.

Solución. Arranca esx_status antes que Cuxial Bridge.

En ESX dar una banda falla

Causa. La banda o el grado no están en esx.gangs de cuxial_bridge/shared/config.lua. ESX no trae bandas propias.

Solución. Añade la banda y sus grados a esa lista. Consulta Bandas en ESX.

La consola muestra «CONSULTA FALLIDA» al arrancar el recurso

Causa. Las tablas no existen. El recurso no las crea.

Solución. Importa install/cuxial_admin.sql y reinicia el recurso. Las líneas que siguen al mensaje muestran la consulta y el motivo que da la base de datos.

/admin responde que no formo parte del staff

Causa. Una de estas:

• No hay ninguna fila tuya en cuxial_admin_staff.
• La fila usa scope = 'discord' y no tienes Discord vinculado a FiveM.
• La fila se añadió con el servidor en marcha y aún no se ha cargado.
• La fila apunta a un rango que no existe. La consola muestra entonces un aviso que termina en «apuntan a un rango o ámbito que no existe».
• Todavía no has cargado un personaje.

Solución. Revisa la fila, vincula Discord y escribe staffreload en la consola del servidor. Consulta Instalación.

Aparece el cursor pero no el panel

Causa. La interfaz no carga. La carpeta web/build falta o está incompleta, normalmente por una subida parcial.

Solución. Vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

He cambiado una tecla en el config pero sigue funcionando la antigua

Causa. keybinds solo define el valor por defecto. Cuando un jugador ya ha entrado, FiveM recuerda su asignación.

Solución. Cada jugador la cambia en los ajustes de teclas de GTA, en el apartado de FiveM. Los jugadores nuevos reciben el nuevo valor por defecto.

La interfaz sale en un idioma y las notificaciones en otro

Causa. Hay dos ajustes. La interfaz sigue locale de shared/config.lua. Las notificaciones y los nombres de tecla siguen la convar ox:locale.

Solución. Pon los dos en el mismo idioma. Se incluyen en y es:

server.cfg

setr ox:locale "es"

Quiero los nombres de los permisos en otro idioma

Causa. Los nombres de los permisos salen de los campos label de data/permissions.lua.

Solución. Traduce los campos label de data/permissions.lua. Los nombres de los rangos se editan desde el panel.

La función de ver pantalla no está disponible

Causa. Una de estas:

• cuxial_admin_screen_owners está vacía. La consola lo avisa al arrancar el recurso.
• Tu identificador de Discord no está en esa lista.
• A tu rango le falta player.screen.
• La convar se cambió sin reiniciar el recurso.

Solución. Añade tu identificador de Discord a la convar y reinicia el recurso:

server.cfg

set cuxial_admin_screen_owners "ID_DE_DISCORD_1,ID_DE_DISCORD_2"

Ver pantalla funciona en el juego pero no desde el panel web

Causa. Fuera del juego el vídeo solo puede llegar por el relay, y el relay no está configurado o sus valores se rechazan.

Solución. Define las dos convars. La dirección debe empezar por ws:// o wss://, y la clave debe tener exactamente 64 caracteres hexadecimales en minúscula:

server.cfg

set sd_phone_relay_url "wss://TU_HOST_DE_RELAY/RUTA"
set sd_phone_relay_key "TU_CLAVE_HEX_DE_64_CARACTERES"

Ver pantalla no se abre con un jugador al que ya miran otros

Causa. Ya hay screen.maxWatchers miembros del staff mirando a ese jugador desde dentro del juego.

Solución. Espera a que uno termine, o sube screen.maxWatchers. Cada espectador añade carga de subida.

El botón del micrófono no hace nada al ver pantalla

Causa. screen.audio es false.

Solución. Pon screen.audio = true en shared/config.lua.

La consola avisa de que faltan las convars del panel remoto

Causa. remote.enabled es true pero cuxial_admin_remote_url o cuxial_admin_remote_secret no están definidas. El panel remoto queda apagado; el panel del juego no se ve afectado.

Solución. Si no usas el panel web, pon remote.enabled = false. Si lo usas, añade las dos convars antes de que arranque el recurso.

Un miembro del staff no puede entrar al panel web

Causa. Su rango tiene el acceso remoto desactivado, o no está en la tabla de staff. La consola indica cuál de las dos. Un rango dado a un personaje solo vale desde fuera después de que ese personaje haya entrado una vez al servidor con Discord vinculado.

Solución. Activa el acceso remoto del rango desde el panel, o pide al miembro del staff que entre una vez con ese personaje.

Un rango dado a un rol de Discord no se aplica

Causa. Los rangos por rol necesitan el servicio externo de panel web, que informa de quién lleva cada rol.

Solución. Conecta el servicio de panel web, o da el rango por cuenta de Discord o por personaje.

No puedo conceder, editar o borrar un rango

Causa. Una de estas:

• El rango tiene un permiso que tú no tienes.
• La persona ya tiene un rango con permisos que tú no tienes.
• Intentas retirarte tu propio rango.
• Intentas borrar un rango que alguien todavía tiene.

Solución. Pídeselo a alguien con un rango superior, o retira el rango a sus miembros antes de borrarlo.

He editado los rangos en data/permissions.lua y no cambia nada

Causa. seed solo se usa la primera vez que arranca el recurso, cuando la tabla de rangos está vacía.

Solución. Edita los rangos desde el panel.

¿Desde dónde se banea a un jugador?

Causa. El panel pone avisos y expulsa. Los baneos son de txAdmin.

Solución. Banea desde txAdmin. El baneo aparece después en el historial de sanciones.

Coger las llaves dice que el sistema de llaves no está en marcha

Causa. cuxial_garages no está iniciado.

Solución. Inicia cuxial_garages. Sin él, los vehículos generados desde el panel aparecen igualmente, pero sin llaves.

El editor de apariencia no se abre

Causa. cuxial_appearance no está iniciado.

Solución. Inicia cuxial_appearance.

Las acciones de servicios comunitarios fallan

Causa. cuxial_cmservices no está iniciado.

Solución. Inicia cuxial_cmservices.

No hay selector de zona para el clima

Causa. El clima por zonas solo existe con av_weather. Con prim_climatime, o sin recurso de clima, el clima es el mismo en todo el mapa.

Solución. Usa av_weather para poner el clima por zonas.

Ha desaparecido un reporte

Causa. Los reportes abiertos viven en memoria. Un reporte se descarta cuando su jugador se desconecta, vuelve a la selección de personaje o cuando se reinicia el recurso. Solo se guardan los reportes cerrados.

Solución. Cierra el reporte para conservar su transcripción. Las transcripciones se borran pasados reportRetentionDays.

Un jugador no puede enviar más mensajes en su reporte

Causa. Ha llegado a limits.messagesPerReport, o escribe más rápido que limits.messageCooldown.

Solución. Responde o cierra el reporte. Sube el límite en shared/config.lua si es bajo para tu servidor.

Los nombres sobre los jugadores no se ven a larga distancia

Causa. Los jugadores que están más allá del radio de red no están cargados en el cliente del miembro del staff.

Solución. Sube nameplates.cullingRadius y nameplates.range. Un radio mayor consume más ancho de banda de ese miembro del staff mientras tiene los nombres activos.

Dar efectivo no suma nada al saldo del framework

Causa. Con ox_inventory, moneyItems = 'auto' entrega el efectivo como ítem: cash en QBox y QBCore, money en ESX. Una tabla que incluya cash hace lo mismo.

Solución. Pon en moneyItems una tabla sin cash para darlo como saldo, o comprueba que el ítem existe en tu inventario. Consulta Dinero.