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

El recurso no arranca

Causa. Falta una dependencia o arranca después de la tablet. Cuxial Tablet necesita OneSync, un framework (QBox, QBCore o ESX), ox_lib, oxmysql y cuxial_bridge 2.17.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_tablet

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

Comprar, reclamar o transferir coins falla y el saldo siempre marca 0

Causa. La cuenta de dinero de vip.account (coins por defecto) no existe en tu framework.

Solución. Crea la cuenta en la configuración del framework y reinicia el servidor, o apunta vip.account a una cuenta que exista. Consulta Crea la cuenta de coins.

Los premios en ítems se devuelven o avisan de que no caben

Causa. El nombre del ítem en el catálogo no existe en tu inventario, o el jugador no tiene sitio. Un premio que no se puede entregar se devuelve; un premio de caja que no cabe va a la bandeja de regalos.

Solución. Usa nombres de ítem que existan en tu inventario. Desde el panel, el selector de ítems solo ofrece los que tu inventario conoce.

Los artículos de la tienda salen sin imagen

Causa. El artículo no tiene image en el catálogo y el inventario no tiene imagen para ese nombre de ítem, o el inventario no es uno que Cuxial Bridge reconozca.

Solución. Pon image en el artículo desde el panel con una URL completa o una ruta dentro de la carpeta web/images del inventario, o añade la imagen a tu inventario. Sin image, la tablet usa nui://<inventario>/web/images/<item>.webp.

/tabletadmin responde que no tengo acceso

Causa. No tienes el permiso de admin.permission (admin por defecto). En QBox y QBCore es un permiso del framework que se concede en server.cfg; en ESX tu grupo debe ser admin o superadmin.

Solución. Concede el permiso y vuelve a conectar. Consulta Permisos.

La tablet no se abre

Causa. Una de estas:

• tablet.enabled es false.
• El jugador está muerto, nadando, conduciendo o esposado y tablet.canOpen lo prohíbe.
• El personaje todavía no ha cargado.
• El jugador cambió la tecla en los ajustes de GTA.

Solución. Revisa tablet.enabled y tablet.canOpen desde el panel, y la tecla en los ajustes de teclas de GTA, en el apartado de FiveM.

Aparece el cursor pero no la tablet

Causa. La interfaz no carga. La carpeta web/dist 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 la tecla de la tablet en el config pero sigue funcionando la antigua

Causa. tablet.keybind solo define el valor por defecto. Cuando un jugador ya ha entrado, FiveM recuerda su asignación. Lo mismo vale para live.camera.stopKey.

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 otro idioma

Causa. La tablet sigue la convar ox:locale.

Solución. Defínela antes de que arranque el recurso. Se incluyen en y es:

server.cfg

setr ox:locale "es"

He editado shared/config.lua o un archivo de data/ y no cambia nada

Causa. Esos archivos son solo los valores de fábrica. Los valores vivos se guardan en la base de datos la primera vez que arranca el recurso y, desde entonces, se editan desde el panel.

Solución. Haz el cambio desde /tabletadmin. Para volver a los valores del archivo, usa Fábrica en esa sección del panel. Solo las opciones de Opciones estáticas se leen del archivo en cada arranque.

Nadie puede redactar noticias ni emitir

Causa. El trabajo del jugador no está en news.publisherJobs o live.broadcasterJobs, o news.enabled / live.enabled es false.

Solución. Añade los nombres de trabajo desde el panel, en las secciones Noticias y Directos. El staff siempre puede publicar y emitir.

Los directos se ven borrosos o a tirones con muchos espectadores

Causa. No hay relay configurado, así que el vídeo pasa por el servidor de juego a calidad reducida y la subida del servidor crece con cada espectador.

Solución. Configura las convars del relay en server.cfg. Consulta Instalación. La dirección debe empezar por ws:// o wss:// y la clave debe tener 64 caracteres hexadecimales en minúscula.

La lista de vehículos o propiedades del perfil sale vacía

Causa. Los adaptadores de hooks/server/vehicles.lua y hooks/server/properties.lua leen qbx_vehicles y nolag_properties. Sin ellos, o en otro framework, las listas quedan vacías.

Solución. Edita esos archivos para leer tus propios recursos de garaje y vivienda, manteniendo la forma del retorno. Consulta Hooks.

Los trabajos completados no dan XP del pase

Causa. La tablet solo se entera de los trabajos completados por cuxial_jobs o por el export EmitJobCompleted.

Solución. Llama a exports.cuxial_tablet:EmitJobCompleted(src, info) desde tu recurso de trabajos cuando termine un trabajo. Consulta Exports y eventos.

Las horas trabajadas del perfil marcan 0

Causa. El adaptador de hooks/server/playtime.lua lee la tabla player_jobs_activity, que tu servidor no tiene.

Solución. Edita Hooks.GetWorkedHours en ese archivo para leer tu propia fuente.

Un código no se puede canjear

Causa. Una de estas:

• El código ha agotado sus usos o su fecha de caducidad, o se desactivó desde el panel.
• El personaje ya lo canjeó; un código se canjea una vez por personaje.
• El jugador lo ha intentado más de vip.codes.redeemPerHour veces en una hora.

Solución. Revisa el código en la pestaña Operaciones del panel, donde se listan sus usos y canjes.

Una transferencia se rechaza

Causa. La cantidad está por debajo de vip.wallet.transfer.min, el remitente ha llegado hoy a vip.wallet.transfer.maxPerDay, el destinatario no está conectado, o vip.wallet.transfer.enabled es false.

Solución. Ajusta los límites desde el panel, en la sección VIP.

La mira personalizada no se dibuja

Causa. crosshair.enabled es false, el jugador no ha activado su mira en la página Mira, o no está apuntando y Siempre visible está apagado.

Solución. Activa la mira desde la página. El staff puede revisar el perfil de un jugador desde la pestaña Operaciones.

Los jugadores no ven hitmarker ni números de daño

Causa. crosshair.allowHitmarker o crosshair.allowDamageNumbers es false, lo que los apaga para todos sin importar sus ajustes.

Solución. Actívalos desde el panel, en la sección Mira.

La consola imprime todas las consultas

Causa. debug es true en shared/config.lua o la convar cuxial_tablet_debug vale 1.

Solución. Pon debug = false y quita la convar, y reinicia el recurso.