Cuxial Admin necesita importar un SQL y una fila de staff antes de que alguien pueda abrir el panel. No añade ítems al inventario.

Comprueba las dependencias

Estos recursos deben estar instalados y funcionando antes de añadir el panel:

• Un framework: QBox (qbx_core), QBCore (qb-core) o ESX (es_extended)
• ox_lib
• oxmysql
• Un inventario: ox_inventory, o qb-inventory en QBCore
• cuxial_bridge 2.14.0 o posterior
• OneSync activado en el servidor

Actualiza Cuxial Bridge a 2.14.0 o posterior antes de instalar el panel. Las versiones anteriores no tienen funciones que el panel usa para revivir, curar, la guantera y el maletero.

Lo que cambia en cada framework está en Compatibilidad.

Las integraciones opcionales están en la Introducción. Ninguna hace falta para arrancar.

Copia el recurso

Coloca la carpeta cuxial_admin dentro de tu directorio resources. No le cambies el nombre.

Importa el SQL

Ejecuta install/cuxial_admin.sql en tu base de datos. Crea cinco tablas: cuxial_admin_ranks, cuxial_admin_staff, cuxial_admin_sanctions, cuxial_admin_report_transcripts y cuxial_admin_audit.

El recurso no crea sus tablas por sí solo. Sin esta importación fallan todas las consultas.

Añade el primer superadmin

Añade tu cuenta de Discord como primer superadmin. El archivo SQL termina con una plantilla comentada para esta fila: sustituye TU_ID_DE_DISCORD por tu identificador de Discord y ejecútala.

INSERT INTO `cuxial_admin_staff` (`scope`, `identifier`, `label`, `rank`, `added_by`)
VALUES ('discord', 'TU_ID_DE_DISCORD', 'Tu nombre', 'superadmin', 'instalación');

• scope = 'discord' da el rango a esa cuenta de Discord, en todos sus personajes. El jugador debe tener Discord vinculado a FiveM.
• Para dárselo a un solo personaje, usa scope = 'character' y el citizenid del personaje como identifier.

El rango superadmin se crea la primera vez que arranca el recurso. Si añades la fila con el servidor en marcha, escribe staffreload en la consola del servidor para aplicarla.

A partir de aquí, concede y retira rangos desde el panel. Quien esté en cuxial_admin_staff como superadmin tiene el control total.

Define las convars

Todas son opcionales. Sin ellas el panel funciona, con la función de ver pantalla y el panel web remoto apagados. El panel web remoto necesita además remote.enabled = true en shared/config.lua.

server.cfg

# Idioma de las notificaciones y de los nombres de tecla (incluye en y es)
setr ox:locale "es"

# Staff que puede ver la pantalla de un jugador: identificadores de Discord separados por comas
set cuxial_admin_screen_owners "ID_DE_DISCORD_1,ID_DE_DISCORD_2"

# Relay de media opcional para ver pantalla
set sd_phone_relay_url "wss://TU_HOST_DE_RELAY/RUTA"
set sd_phone_relay_key "TU_CLAVE_HEX_DE_64_CARACTERES"
set sd_phone_relay_ttl "45"

# Panel web remoto opcional
set cuxial_admin_remote_url "http://TU_SERVICIO_DE_PANEL"
set cuxial_admin_remote_secret "TU_SECRETO_COMPARTIDO"

# Traza de SQL en la consola del servidor
set cuxial_admin_debug "0"

Escribe la clave del relay y el secreto remoto con set, nunca con setr. setr envía el valor a todos los jugadores.

Qué hace cada una se explica en Configuración.

Arranca el recurso

Arranca el panel después del framework, el inventario y Cuxial Bridge:

server.cfg

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure cuxial_bridge
ensure cuxial_admin

En QBCore, qb-inventory se puede cambiar por ox_inventory. El framework y el inventario deben arrancar antes que Cuxial Bridge, que los detecta al cargar.

Las integraciones opcionales se detectan con el servidor en marcha, así que su posición en la lista no importa.

Comprueba que funciona

1. Entra al servidor con la cuenta que has añadido y carga un personaje.
2. Pulsa U o escribe /admin. Se abre el panel.
3. Abre el apartado de staff y comprueba que aparece tu rango.
4. Con otra cuenta, escribe /report y envía un mensaje. Aparece en la pestaña de reportes del panel.

Siguiente: ajusta el panel a tu servidor en Configuración.