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

# Instalación

Instala Cuxial PvP paso a paso: dependencias, arenas, armas, permisos y orden de arranque.

Cuxial PvP no necesita importar SQL ni añadir ítems al inventario. La clasificación la guarda el propio recurso.

{% stepper %}
{% step %}

## Comprueba las dependencias

Deben estar instaladas y funcionando antes de añadir el script:

* OneSync activado en el servidor
* `ox_lib`
* `cuxial_bridge`, con uno de los frameworks compatibles: QBox, QBCore o ESX
* `ox_inventory` o `qb-inventory`

Opcionales:

* `av_weather` o `cd_easytime`, para congelar la hora del día mientras dura una partida.
* `ox_inventory` aporta además los nombres y los iconos de las armas de la escalera de Gun Game.
  {% endstep %}

{% step %}

## Copia el recurso

Coloca la carpeta `CuxiaPvP` dentro de tu directorio `resources`. Mantén el nombre de la carpeta: los exports se llaman a través de él.
{% endstep %}

{% step %}

## Define el punto de salida

Al acabar una partida los jugadores van a `exitCoords`. Cámbialo por un lugar de tu mapa:

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

```lua
exitCoords = vector4(0.0, 0.0, 72.0, 0.0),
```

{% endcode %}
{% endstep %}

{% step %}

## Adapta las arenas y las armas a tu servidor

Los mapas de `data/maps.lua` y las armas de `data/weapons.lua` son ejemplos. Sustitúyelos antes de abrir el script a los jugadores:

* **Mapas.** Cada uno lista los puntos de aparición de los dos equipos. Usa coordenadas de arenas que existan en tu servidor.
* **Armas de duelo.** Cada `value` debe ser un arma que exista en tu servidor, incluidas las add-on.
* **Escalera de Gun Game.** Revisa `ladder` y `finisher` en `data/gungame.lua`.

{% hint style="warning" %}
Un mapa cuyas coordenadas apuntan a un interior que no tienes deja caer a los jugadores al vacío. Comprueba todos los mapas antes de abrir.
{% endhint %}

El formato de cada archivo está explicado en [Configuración](/scripts/es/ocio/cuxial-pvp/configuration.md).
{% endstep %}

{% step %}

## Ajusta tu script de clima y el de ambulancia

Indica qué script de hora usas y los eventos que reviven a un jugador en tu servidor:

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

```lua
-- 'av' = av_weather | 'cd' = cd_easytime
weatherSystem = 'av',

revive = {
    enabled = true,
    events = {
        'hospital:client:Revive',
        'esx_ambulancejob:revive',
    },
    delay = 500,
},
```

{% endcode %}

Deja en `events` solo el evento de revivir de tu script de ambulancia.
{% endstep %}

{% step %}

## Concede el permiso de la herramienta de zonas

Guardar una zona de Gun Game escribe un archivo dentro del recurso, así que va detrás de un permiso ACE:

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

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

{% endcode %}
{% endstep %}

{% step %}

## Elige el idioma

Incluye inglés y español. El script sigue el idioma de `ox_lib`:

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

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

{% endcode %}
{% endstep %}

{% step %}

## Inicia el recurso

Inícialo después de sus dependencias y de tu framework:

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

```cfg
ensure ox_lib
# aquí tu framework (qbx_core, qb-core o es_extended)
# aquí tu inventario (ox_inventory o qb-inventory)
ensure cuxial_bridge
ensure CuxiaPvP
```

{% endcode %}
{% endstep %}

{% step %}

## Comprueba que funciona

1. Entra al servidor y escribe `/Cuxiall`. Se abre el menú.
2. Crea un duelo, haz que entre un segundo jugador, asígnalo al otro equipo y empieza. Los dos aparecen en la arena con el arma elegida.
3. Termina la partida. Los dos vuelven a `exitCoords` con el chaleco que tenían.
4. Con el permiso concedido, escribe `/pvpzone gungame Prueba`, dibuja una zona y pulsa <kbd>Enter</kbd>. La zona se guarda en `data/gungame_zones.lua`.
   {% endstep %}
   {% endstepper %}

{% hint style="info" %}
La tecla del menú viene sin asignar a propósito. Cada jugador la asigna en los ajustes de teclas de FiveM, o puedes abrir el menú desde tu propio recurso con el export `toggleUI`. Consulta [Exports y eventos](/scripts/es/ocio/cuxial-pvp/developers.md).
{% endhint %}

Siguiente: aprende cómo se juegan las partidas en la [Guía de funciones](/scripts/es/ocio/cuxial-pvp/features.md), o ajusta las reglas en [Configuración](/scripts/es/ocio/cuxial-pvp/configuration.md).


---

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