> 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/ocio/cuxial-pvp/troubleshooting.md).

# Problemas frecuentes

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

Los problemas más habituales tras instalar Cuxial PvP, 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 que el script. Cuxial PvP necesita OneSync, `ox_lib` y `cuxial_bridge`.

**Solución.** Activa OneSync e inicia antes las dependencias:

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

```cfg
ensure ox_lib
ensure cuxial_bridge
ensure CuxiaPvP
```

{% endcode %}

</details>

<details>

<summary>El export falla con «No such export»</summary>

**Causa.** Se cambió el nombre de la carpeta. Los exports se llaman a través del nombre del recurso.

**Solución.** Mantén la carpeta como `CuxiaPvP`, o usa el nuevo nombre de carpeta en cada llamada: `exports.<carpeta>:toggleUI(true)`.

</details>

<details>

<summary>Ninguna tecla abre el menú</summary>

**Causa.** La tecla del menú no tiene asignación por defecto, para no chocar con otros recursos.

**Solución.** Usa `/Cuxiall`, asigna «Abrir CuxiaPvP» en los ajustes de teclas de FiveM, o abre el menú desde tu propio recurso con `exports.CuxiaPvP:toggleUI(true)`.

</details>

<details>

<summary>El comando se ejecuta pero no aparece el menú</summary>

**Causa.** La interfaz no está cargando. Falta la carpeta `web/build` o está incompleta, normalmente tras una subida parcial.

**Solución.** Vuelve a copiar el recurso desde el paquete que descargaste, comprobando que `web/build` se sube entera, y reinicia el recurso.

</details>

<details>

<summary>Los jugadores empiezan el duelo sin arma</summary>

**Causa.** El arma elegida no existe en tu servidor. Las armas de `data/weapons.lua` son ejemplos e incluyen armas add-on.

**Solución.** Deja en `data/weapons.lua` solo armas que tenga tu servidor y añade sus imágenes a `web/build/weapons`. Haz lo mismo con `ladder` y `finisher` en `data/gungame.lua`.

</details>

<details>

<summary>Los jugadores caen al vacío al empezar un duelo</summary>

**Causa.** El mapa usa coordenadas de una arena que no está en tu servidor. Los mapas de `data/maps.lua` son ejemplos.

**Solución.** Sustituye los puntos de aparición de cada mapa por coordenadas de tus propias arenas, o quita los mapas que no tengas.

</details>

<details>

<summary>Los jugadores siguen muertos entre rondas o después de la partida</summary>

**Causa.** Los eventos de `revive.events` no son los de tu script de ambulancia, o `revive.enabled` está en `false`.

**Solución.** Pon en `revive.events` el evento de cliente que revive en tu script de ambulancia y deja `revive.enabled = true`. Consulta [Configuración](/scripts/es/ocio/cuxial-pvp/configuration.md).

</details>

<details>

<summary>La hora del día no cambia, o se queda congelada después de la partida</summary>

**Causa.** `weatherSystem` no coincide con el script de hora que usas.

**Solución.** Pon `weatherSystem = 'av'` para `av_weather` o `'cd'` para `cd_easytime` en `data/config.lua`.

</details>

<details>

<summary>«No hay zonas configuradas para esta modalidad» al crear un Gun Game</summary>

**Causa.** `data/gungame_zones.lua` no tiene zonas.

**Solución.** Dibuja una dentro del juego con `/pvpzone gungame <nombre>`. Consulta [Comandos y permisos](/scripts/es/ocio/cuxial-pvp/commands.md#herramienta-de-zonas).

</details>

<details>

<summary>«No se pudo guardar la zona»</summary>

**Causa.** El jugador no tiene el permiso ACE, o la zona tiene menos de tres esquinas.

**Solución.** Concede el permiso y vuelve a dibujar la zona:

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

```cfg
add_ace group.admin cuxialpvp.zones allow
```

{% endcode %}

</details>

<details>

<summary>«Falta cuxial_bridge o su herramienta de zonas»</summary>

**Causa.** El `cuxial_bridge` instalado es anterior al que se entrega con el script.

**Solución.** Actualiza `cuxial_bridge` a la versión incluida en tu descarga y reinicia el servidor.

</details>

<details>

<summary>Un mapa, un arma o una zona no muestra imagen</summary>

**Causa.** Falta la imagen o su nombre no coincide con el `value` de la entrada.

**Solución.** Nombra el archivo exactamente igual que el `value`, respetando mayúsculas y minúsculas:

| Entrada          | Imagen                          |
| ---------------- | ------------------------------- |
| Mapa             | `web/build/maps/<value>.png`    |
| Arma de duelo    | `web/build/weapons/<value>.png` |
| Zona de Gun Game | `web/build/zones/<value>.webp`  |

Las armas de la escalera de Gun Game toman su icono de `ox_inventory`.

</details>

<details>

<summary>Todos muestran el avatar por defecto de Discord</summary>

**Causa.** `discord.botToken` está vacío o no es válido. Los jugadores sin cuenta de Discord vinculada muestran siempre el avatar por defecto.

**Solución.** Crea un bot en el portal de desarrolladores de Discord y pega su token en `discord.botToken` de `data/config.lua`. El bot no necesita permisos.

</details>

<details>

<summary>Un jugador no puede apostar</summary>

**Causa.** Las apuestas se pagan en efectivo, y cada jugador puede apostar una vez por partida.

**Solución.** El jugador necesita el importe en efectivo, no en el banco.

</details>

<details>

<summary>«Ya tienes una sala abierta» o «No caben más salas ahora mismo»</summary>

**Causa.** Se alcanzaron los límites de `data/config.lua`.

**Solución.** Sube `limits.maxLobbiesPerHost` o `limits.maxLobbies`. Consulta [Configuración](/scripts/es/ocio/cuxial-pvp/configuration.md).

</details>

<details>

<summary>La clasificación está vacía tras cada reinicio</summary>

**Causa.** `leaderboard.clearOnRestart` está en `true`.

**Solución.** Ponlo en `false` en `data/config.lua`.

</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/ocio/cuxial-pvp/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.