> 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/interfaz/cuxial-pausemenu/troubleshooting.md).

# Problemas frecuentes

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

Los fallos más habituales después de instalar Cuxial Pause Menu, con la causa y la solución de cada uno.

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia o arranca después del menú. Cuxial Pause Menu necesita OneSync, `ox_lib` y `cuxial_bridge`.

**Solución.** Activa OneSync y arranca primero las dependencias:

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

```cfg
ensure ox_lib
ensure cuxial_bridge
ensure cuxial_pausemenu
```

{% endcode %}

</details>

<details>

<summary>Salen dos menús, o la pantalla parpadea al pulsar Esc</summary>

**Causa.** Hay otro recurso de menú de pausa en marcha. Los dos reaccionan a <kbd>Esc</kbd>, y Cuxial Pause Menu cierra la pantalla de pausa de GTA cada vez que el otro la abre.

**Solución.** Quita el otro menú de pausa de `server.cfg` y reinicia el servidor.

</details>

<details>

<summary>Pulsar Esc no hace nada</summary>

**Causa.** Una de estas:

* Otra interfaz tiene el cursor (inventario, teléfono, otro menú). El menú de pausa espera a que se cierre.
* El jugador cambió la tecla en los ajustes de GTA.
* La interfaz no carga. Falta la carpeta `web/dist` o está incompleta, normalmente por una subida a medias.

**Solución.** Cierra la otra interfaz, o revisa la tecla «Abrir el menú de pausa» en los ajustes de teclas de GTA. Si el menú no le aparece a nadie, comprueba que dentro del recurso existen `web/dist/index.html` y la carpeta `web/dist/assets`; si faltan, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

</details>

<details>

<summary>He cambiado keys.menu o keys.map y sigue funcionando la tecla anterior</summary>

**Causa.** Las dos son solo valores por defecto. Cuando un jugador ya ha entrado, FiveM recuerda su tecla.

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

</details>

<details>

<summary>Policías y sanitarios de servicio salen siempre a 0</summary>

**Causa.** Los valores de `duty` no coinciden con tus trabajos. En QBox y QBCore se comparan con el tipo y con el nombre del trabajo. En ESX solo con el nombre, así que los valores por defecto `'leo'` y `'ems'` no coinciden con nada.

**Solución.** Pon tus propios valores en `shared/config.lua`:

{% code title="shared/config.lua" %}

```lua
duty = { police = 'police', medical = 'ambulance' },
```

{% endcode %}

Solo se cuentan los jugadores que están de servicio.

</details>

<details>

<summary>La moneda extra sale a 0, o no uso ninguna</summary>

**Causa.** `coins.enabled` es `true` y la cuenta de `coins.account` no existe en tu framework.

**Solución.** Escribe el nombre de tu cuenta en `coins.account`, o pon `coins.enabled = false` para ocultarla.

</details>

<details>

<summary>Efectivo y banco salen a 0, o el nombre es el de FiveM en vez del personaje</summary>

**Causa.** El menú no ha podido leer el personaje. `cuxial_bridge` no está conectado al framework, o arrancó antes que él.

**Solución.** Arranca tu framework antes que `cuxial_bridge`, y `cuxial_bridge` antes que `cuxial_pausemenu`.

</details>

<details>

<summary>El número de plazas no es correcto</summary>

**Causa.** Con `server.maxPlayers = 0` el menú muestra el valor de `sv_maxclients`.

**Solución.** Escribe en `server.maxPlayers` el número que quieras mostrar.

</details>

<details>

<summary>No salen iconos sobre los jugadores con el menú abierto</summary>

**Causa.** Una de estas:

* `aura.enabled` es `false`.
* El jugador está más lejos que `aura.distance`, o detrás de una pared con `aura.requireLos = true`.
* El jugador está muerto o abatido con `aura.clearOnDeath = true`.
* Buscas tus propios iconos en primera persona, o `aura.showSelf` es `false`.
* El jugador abrió y cerró el menú más de `aura.rate.limit` veces en pocos segundos. Los iconos vuelven solos.

**Solución.** Revisa el bloque `aura` en `shared/config.lua`.

</details>

<details>

<summary>El menú se cierra solo</summary>

**Causa.** Otro recurso le quitó el cursor con el menú abierto. Tras `aura.healMs` sin foco, el menú se cierra.

**Solución.** Sube `aura.healMs` si un recurso tuyo toma el foco un instante a propósito.

</details>

<details>

<summary>La pantalla de pausa de GTA no se abre nunca, ni desde otro recurso</summary>

**Causa.** Es intencionado. Cada `native.watchdogMs` el menú busca una pantalla de pausa de GTA que no haya abierto él, la cierra y se abre.

**Solución.** Pon `native.watchdogMs = 0` para quitar esa comprobación. <kbd>Esc</kbd> sigue abriendo Cuxial Pause Menu.

</details>

<details>

<summary>Un acceso no tiene imagen</summary>

**Causa.** El archivo indicado en `image` no está dentro de `web/dist/img/tiles/`.

**Solución.** Copia la imagen a esa carpeta y escribe su nombre de archivo exacto en la entrada de `tiles`.

</details>

<details>

<summary>Los textos salen en otro idioma</summary>

**Causa.** El menú sigue la convar `ox:locale`. Las normas, las redes y el nombre del servidor no se traducen: se muestran tal como están escritos en `shared/config.lua`.

**Solución.** Define la convar en `server.cfg` y reinicia. Incluye `es` y `en`:

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

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

{% endcode %}

</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/interfaz/cuxial-pausemenu/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.