Cuxial Docs

Español

English

Español

English

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.

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.

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.

Define el punto de salida ​

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

data/config.lua
lua
exitCoords = vector4(0.0, 0.0, 72.0, 0.0),

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.

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.

El formato de cada archivo está explicado en Configuración.

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:

data/config.lua
lua
-- 'av' = av_weather | 'cd' = cd_easytime
weatherSystem = 'av',

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

Deja en events solo el evento de revivir de tu script de ambulancia.

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:

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

Elige el idioma ​

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

server.cfg
cfg
setr ox:locale "es"

Inicia el recurso ​

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

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

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 Enter. La zona se guarda en data/gungame_zones.lua.

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.

Siguiente: aprende cómo se juegan las partidas en la Guía de funciones, o ajusta las reglas en Configuración.

© Cuxial