PVP

Sistema PvP con zonas FFA, zonas Only y partidas de lobby por equipos. Cada zona y cada partida funciona en su propia dimensión. Además hay una clasificación y un marcador de partida. El script crea la tabla por sí mismo.

Funciones

• Zonas FFA: todos contra todos. Por zona, armas fijas o las propias armas del jugador. Respawn con chaleco y una breve protección al spawnear.
• Zonas Only: todos tienen las mismas armas, opcionalmente con un vehículo (p. ej. BF 400) en cada spawn.
• Lobbies: equipo A contra equipo B en modo best-of con ronda decisiva. Se pueden elegir mapa, modo (a pie o vehículo), rondas, hasta 3 armas y una contraseña opcional. El propietario puede expulsar, mezclar y disolver.
• Espectar: quien queda eliminado en una ronda mira a los compañeros vivos y cambia con ← →.
• Marcador de partida arriba en el centro y Clasificación con los filtros FFA, Only y Lobby (incluidas victorias y derrotas).
• Protección de armas: las armas fijas solo existen en el PvP. Las armas reales y su munición quedan protegidas.
• Logs de Discord, exports y tus propias funciones para conectar otros scripts.

Instalación

1. Pon la carpeta off_pvp en tu carpeta resources.
2. Añade en el server.cfg, después de oxmysql y ESX:

ensure oxmysql
ensure es_extended
ensure off_pvp

1. Ajusta los puntos PvP, las zonas y los mapas en config/ a tu servidor.

La tabla off_pvp_stats se crea automáticamente en el primer arranque.

Configuración

Los ajustes están en config/settings/: config.lua para todo lo general, config.ffa.lua, config.only.lua y config.lobby.lua para los tres modos.

config/settings/config.lua

Puntos PvP (points):

config/settings/config.ffa.lua y config/settings/config.only.lua

Config.ffa y Config.only contienen las zonas. Cada zona tiene:

config/settings/config.lobby.lua

Config.lobby contiene los ajustes de los lobbies:

Config.maps contiene los mapas de los lobbies:

config/functions.lua

Aquí conectas tus propios scripts. Los errores en ellas llegan a la consola, el script sigue funcionando. kind siempre es 'ffa', 'only' o 'lobby'.

config/settings/config.server.lua e idiomas

Webhooks de Discord para lobby (lobby creado, partida iniciada, partida terminada, lobby disuelto) y zones (entrar y salir de una zona). '' desactiva un log. Todos los textos están en config/locales/ (un archivo por idioma).

En el juego

• Menú: E en un punto PvP. Solo funciona vivo, a pie, en la dimensión normal y fuera del gangwar.
• FFA y Only: Unirse te teletransporta a la zona. Tras morir, sigues en un spawn después de respawn.seconds. Arriba ves kills, muertes y los jugadores de la zona.
• Salir: /quitffa (o tu quitCommand) te lleva de vuelta al sitio donde te uniste. Vida y chaleco quedan como antes, tus propias armas vuelven. El comando también te saca de un lobby en espera.
• Crear lobby: elige mapa, modo, rondas, armas y, si quieres, una contraseña. Los jugadores nuevos van al equipo más pequeño. Cambiar de equipo es posible mientras el otro no esté lleno. Tras 5 contraseñas incorrectas, el lobby queda bloqueado para ti durante 60 segundos.
• Propietario: inicia, mezcla, expulsa y disuelve. Si el propietario se va, el siguiente miembro toma el control.
• Inicio: quien esté muerto, en otra dimensión, en el gangwar o más lejos que startRange de un punto PvP sale del lobby. Cada equipo necesita al menos un jugador.
• Partida:
• Cada ronda empieza con la preparación (congelado, sin armas), después hay armas y chaleco.
• Gana una ronda quien elimina a todo el equipo rival. Dentro de una ronda no hay respawn. Si los dos últimos caen a la vez, nadie se lleva el punto.
• Si se acaba el tiempo, gana el equipo con más jugadores vivos, en caso de empate nadie se lleva el punto.
• Gana la partida quien primero consigue más de la mitad de las rondas. Si se han jugado todas las rondas, gana el marcador más alto. En caso de empate hay rondas decisivas (overtimeRounds), después empate.
• El fuego amigo está activado. Un teamkill cuenta como muerte, no como kill.
• Quien abandona una partida en curso recibe una derrota. Si después un equipo queda vacío, el otro gana al instante.
• Después todos vuelven a su punto de partida, el lobby sigue abierto y vuelve a esperar.
• Espectar: tras spectateDelay segundos miras a un compañero vivo. Abajo en el centro aparecen su nombre y las flechas. ← y → cambian.
• Garaje (mapas de vehículos): durante la ronda, E en el marker del garaje de tu equipo abre la lista de vehículos. Cada jugador tiene un vehículo, uno nuevo sustituye al anterior.
• Clasificación: los mejores jugadores por modo (cantidad mediante leaderboardSize), ordenados por kills. Los valores nuevos aparecen como mucho al minuto, tras una partida al instante.

Para desarrolladores

-- Servidor
local inPvp = exports.off_pvp:IsInPvp(source)        -- FFA, Only o partida en curso
local ffa = exports.off_pvp:IsFFA(source)
local only = exports.off_pvp:IsOnly(source)
local lobby = exports.off_pvp:IsLobby(source)        -- en una partida en curso
local inLobby = exports.off_pvp:IsInLobby(source)    -- miembro de un lobby, esperando o en partida
local info = exports.off_pvp:GetPvp(source)          -- { kind, id, team, alive, kills, deaths } o nil
local removed = exports.off_pvp:RemoveFromPvp(source) -- saca al jugador de una zona, partida o lobby en espera, true/false
local stats = exports.off_pvp:GetStats(source)       -- { ffa = { kills, deaths }, only = { ... }, lobby = { kills, deaths, wins, losses } } o nil

-- Cliente
local inPvp = exports.off_pvp:IsInPvp()
local ffa = exports.off_pvp:IsFFA()
local only = exports.off_pvp:IsOnly()
local lobby = exports.off_pvp:IsLobby()
local spectating = exports.off_pvp:IsSpectating()
local info = exports.off_pvp:GetPvp()                -- { kind, id, team, phase } o nil

• Statebag offPvp: 'ffa', 'only' o 'lobby' mientras el jugador esté en una zona o una partida.
• offinventory: canOpen() en off_inventory/config/functions.lua bloquea el inventario y el maletero en el PvP en cuanto offpvp está en marcha.

Problemas frecuentes

Al arrancar, el script muestra errores y avisos en la consola del servidor. Las zonas y mapas con errores aparecen ahí y se ignoran.