> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/nucleo/cuxial-admin/troubleshooting.md).

# Problemas frecuentes

Problemas habituales de Cuxial Admin, con su causa y su solución.

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.

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia o arranca después del panel. Cuxial Admin necesita `ox_lib`, `oxmysql`, `cuxial_bridge` y `qbx_core`. No funciona en QBCore ni en ESX.

**Solución.** Arranca primero las dependencias:

{% code title="server.cfg" %}

```cfg
ensure ox_lib
ensure oxmysql
ensure qbx_core
ensure cuxial_bridge
ensure cuxial_admin
```

{% endcode %}

</details>

<details>

<summary>La consola muestra «CONSULTA FALLIDA» al arrancar el recurso</summary>

**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.

</details>

<details>

<summary>/admin responde que no formo parte del staff</summary>

**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](/scripts/es/nucleo/cuxial-admin/installation.md).

</details>

<details>

<summary>Aparece el cursor pero no el panel</summary>

**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.

</details>

<details>

<summary>He cambiado una tecla en el config pero sigue funcionando la antigua</summary>

**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.

</details>

<details>

<summary>La interfaz sale en un idioma y las notificaciones en otro</summary>

**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`:

{% code title="server.cfg" %}

```cfg
setr ox:locale "es"
```

{% endcode %}

</details>

<details>

<summary>Quiero los nombres de los permisos en otro idioma</summary>

**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.

</details>

<details>

<summary>La función de ver pantalla no está disponible</summary>

**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:

{% code title="server.cfg" %}

```cfg
set cuxial_admin_screen_owners "ID_DE_DISCORD_1,ID_DE_DISCORD_2"
```

{% endcode %}

</details>

<details>

<summary>Ver pantalla funciona en el juego pero no desde el panel web</summary>

**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:

{% code title="server.cfg" %}

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

{% endcode %}

</details>

<details>

<summary>Ver pantalla no se abre con un jugador al que ya miran otros</summary>

**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.

</details>

<details>

<summary>El botón del micrófono no hace nada al ver pantalla</summary>

**Causa.** `screen.audio` es `false`.

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

</details>

<details>

<summary>La consola avisa de que faltan las convars del panel remoto</summary>

**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.

</details>

<details>

<summary>Un miembro del staff no puede entrar al panel web</summary>

**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.

</details>

<details>

<summary>Un rango dado a un rol de Discord no se aplica</summary>

**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.

</details>

<details>

<summary>No puedo conceder, editar o borrar un rango</summary>

**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.

</details>

<details>

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

**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.

</details>

<details>

<summary>¿Desde dónde se banea a un jugador?</summary>

**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.

</details>

<details>

<summary>Coger las llaves dice que el sistema de llaves no está en marcha</summary>

**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.

</details>

<details>

<summary>El editor de apariencia no se abre</summary>

**Causa.** `cuxial_appearance` no está iniciado.

**Solución.** Inicia `cuxial_appearance`.

</details>

<details>

<summary>Las acciones de servicios comunitarios fallan</summary>

**Causa.** `cuxial_cmservices` no está iniciado.

**Solución.** Inicia `cuxial_cmservices`.

</details>

<details>

<summary>No hay selector de zona para el clima</summary>

**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.

</details>

<details>

<summary>Ha desaparecido un reporte</summary>

**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`.

</details>

<details>

<summary>Un jugador no puede enviar más mensajes en su reporte</summary>

**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.

</details>

<details>

<summary>Los nombres sobre los jugadores no se ven a larga distancia</summary>

**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.

</details>

<details>

<summary>Dar efectivo no suma nada al saldo del framework</summary>

**Causa.** `cash` está en `moneyItems`, así que se entrega como ítem del inventario.

**Solución.** Quita `cash` de `moneyItems` para darlo como saldo, o comprueba que el ítem existe en tu inventario.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cuxial.com/scripts/es/nucleo/cuxial-admin/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.