> 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.md).

# Cuxial PvP

Arenas PvP para FiveM: duelos por equipos, Gun Game, modo espectador, apuestas y clasificación.

Cuxial PvP añade partidas PvP instanciadas a tu servidor. Los jugadores abren un menú, crean una sala o se unen a una, y combaten en una arena que el resto del servidor ni ve ni interrumpe.

## Qué hace

* **Duelos por equipos**, desde 1v1 hasta 30v30, por rondas o por tiempo, con el arma, el mapa, la hora del día, el chaleco y la regla de disparos a la cabeza que elija el anfitrión.
* **Gun Game**, todos contra todos dentro de una zona dibujada: cada pocas bajas subes un peldaño en la escalera de armas, y el último es un remate cuerpo a cuerpo.
* **Salas** con contraseña opcional, reparto de equipos por el anfitrión y tope de jugadores.
* **Partidas aisladas.** Cada partida corre en su propio routing bucket, sin población ambiente.
* **Lista de partidas en vivo** con marcador, jugadores y bote de apuestas.
* **Modo espectador** con cámara que cambia de un jugador a otro.
* **Apuestas en efectivo** sobre los duelos, repartidas en proporción a lo que apostó cada ganador.
* **Clasificación por modalidad**: victorias, derrotas, bajas y muertes.
* **Herramienta de zonas dentro del juego** para dibujar zonas de Gun Game con cámara libre, restringida por un permiso ACE.
* **Avatares de Discord** en salas, HUD y marcador.
* **Salida limpia.** El chaleco, la hora del día y la posición se restauran al acabar la partida, y las apuestas se devuelven si una partida se cancela.

## Requisitos

| Recurso                         | Obligatorio | Para qué se usa                                                                 |
| ------------------------------- | ----------- | ------------------------------------------------------------------------------- |
| OneSync                         | Sí          | Routing buckets y estado del jugador                                            |
| `ox_lib`                        | Sí          | Callbacks, teclas, notificaciones, idiomas                                      |
| `cuxial_bridge`                 | Sí          | Conecta con tu framework (QBox, QBCore o ESX) y con tu inventario               |
| `ox_inventory` o `qb-inventory` | Sí          | El inventario con el que trabaja `cuxial_bridge`                                |
| `av_weather` o `cd_easytime`    | No          | Congela la hora del día durante la partida                                      |
| Token de bot de Discord         | No          | Muestra la foto real de Discord de cada jugador en lugar del avatar por defecto |

Cuxial PvP no necesita base de datos ni ítems de inventario.

## Páginas

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-download">:download:</i></td><td><strong>Instalación</strong></td><td>Dependencias, arenas, permisos y orden de arranque.</td><td><a href="/scripts/es/ocio/cuxial-pvp/installation.md">Instalación</a></td></tr><tr><td><i class="fa-gamepad">:gamepad:</i></td><td><strong>Guía de funciones</strong></td><td>Cómo funcionan en juego las salas, los duelos, Gun Game, el modo espectador y las apuestas.</td><td><a href="/scripts/es/ocio/cuxial-pvp/features.md">Guía de funciones</a></td></tr><tr><td><i class="fa-sliders">:sliders:</i></td><td><strong>Configuración</strong></td><td>Todas las opciones de la carpeta <code>data</code>: reglas, mapas, armas y zonas.</td><td><a href="/scripts/es/ocio/cuxial-pvp/configuration.md">Configuración</a></td></tr><tr><td><i class="fa-terminal">:terminal:</i></td><td><strong>Comandos y permisos</strong></td><td>Comandos, teclas y el permiso de la herramienta de zonas.</td><td><a href="/scripts/es/ocio/cuxial-pvp/commands.md">Comandos y permisos</a></td></tr><tr><td><i class="fa-code">:code:</i></td><td><strong>Exports y eventos</strong></td><td>Abre el menú y lee el estado de la partida desde tus propios recursos.</td><td><a href="/scripts/es/ocio/cuxial-pvp/developers.md">Exports y eventos</a></td></tr><tr><td><i class="fa-wrench">:wrench:</i></td><td><strong>Problemas frecuentes</strong></td><td>Los problemas habituales y cómo resolverlos.</td><td><a href="/scripts/es/ocio/cuxial-pvp/troubleshooting.md">Problemas frecuentes</a></td></tr></tbody></table>


---

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