PVP

Sistema PvP con zone FFA, zone Only e match a squadre nelle lobby. Ogni zona e ogni match gira in una dimensione propria. In più ci sono una classifica e un pannello del match. La tabella la crea lo script da solo.

Funzionalità

• Zone FFA: tutti contro tutti. Per ogni zona armi fisse o le armi del giocatore. Respawn con giubbotto e breve protezione allo spawn.
• Zone Only: tutti hanno le stesse armi, a scelta con un veicolo (es. BF 400) a ogni spawn.
• Lobby: squadra A contro squadra B in modalità best-of con round decisivo. Si possono scegliere mappa, modalità (a piedi o veicolo), round, fino a 3 armi e una password facoltativa. Il proprietario può espellere, mescolare e sciogliere.
• Spettatore: chi viene eliminato in un round guarda i compagni ancora vivi e cambia con ← →.
• Pannello del match in alto al centro e Classifica con i filtri FFA, Only e Lobby (incluse vittorie e sconfitte).
• Protezione armi: le armi fisse esistono solo nel PvP. Le armi vere e le loro munizioni restano protette.
• Log su Discord, export e funzioni tue per collegare altri script.

Installazione

1. Metti la cartella off_pvp nella tua cartella resources.
2. Aggiungi nel server.cfg, dopo oxmysql ed ESX:

ensure oxmysql
ensure es_extended
ensure off_pvp

1. Adatta punti PvP, zone e mappe in config/ al tuo server.

La tabella off_pvp_stats viene creata automaticamente al primo avvio.

Configurazione

Le impostazioni sono in config/settings/: config.lua per tutto ciò che è generale, config.ffa.lua, config.only.lua e config.lobby.lua per le tre modalità.

config/settings/config.lua

Punti PvP (points):

config/settings/config.ffa.lua e config/settings/config.only.lua

Config.ffa e Config.only contengono le zone. Ogni zona ha:

config/settings/config.lobby.lua

Config.lobby contiene le impostazioni delle lobby:

Config.maps contiene le mappe per le lobby:

config/functions.lua

Qui colleghi i tuoi script. Gli errori al loro interno finiscono in console, lo script continua a funzionare. kind è sempre 'ffa', 'only' o 'lobby'.

config/settings/config.server.lua e lingue

Webhook Discord per lobby (lobby creata, match avviato, match terminato, lobby sciolta) e zones (ingresso e uscita da una zona). '' disattiva un log. Tutti i testi sono in config/locales/ (un file per lingua).

In gioco

• Menu: E a un punto PvP. Funziona solo da vivo, a piedi, nella dimensione normale e non nel gangwar.
• FFA e Only: Entra ti teletrasporta nella zona. Dopo la morte riparti da uno spawn dopo respawn.seconds. In alto vedi kill, morti e i giocatori nella zona.
• Uscire: /quitffa (o il tuo quitCommand) ti riporta nel punto in cui sei entrato. Vita e giubbotto sono come prima, le tue armi tornano. Il comando fa uscire anche da una lobby in attesa.
• Crea lobby: scegli mappa, modalità, round, armi e, se vuoi, una password. I nuovi giocatori vanno nella squadra più piccola. Si può cambiare finché l'altra squadra non è piena. Dopo 5 password sbagliate la lobby è bloccata per te per 60 secondi.
• Proprietario: avvia, mescola, espelle e scioglie. Se il proprietario esce, subentra il membro successivo.
• Avvio: chi è morto, in un'altra dimensione, nel gangwar o più lontano di startRange da un punto PvP viene tolto dalla lobby. Ogni squadra ha bisogno di almeno un giocatore.
• Match:
• Ogni round inizia con la preparazione (congelati, senza armi), poi arrivano armi e giubbotto.
• Vince il round chi elimina tutta la squadra avversaria. Durante un round non c'è respawn. Se gli ultimi due cadono insieme, nessuno prende il punto.
• Se scade il tempo, vince la squadra con più giocatori vivi, in caso di parità nessuno prende il punto.
• Vince il match chi per primo conquista più della metà dei round. Se tutti i round sono stati giocati, vince il punteggio più alto. In caso di parità ci sono round decisivi (overtimeRounds), poi pareggio.
• Il fuoco amico è attivo. Un teamkill conta come morte, non come kill.
• Chi lascia un match in corso riceve una sconfitta. Se poi una squadra resta vuota, l'altra vince subito.
• Dopo tutti tornano al loro punto di partenza, la lobby resta aperta e torna in attesa.
• Spettatore: dopo spectateDelay secondi guardi un compagno vivo. In basso al centro ci sono il suo nome e le frecce. ← e → cambiano.
• Garage (mappe con veicoli): durante il round, E al marker del garage della tua squadra apre la lista dei veicoli. Ogni giocatore ha un veicolo, uno nuovo sostituisce il vecchio.
• Classifica: i migliori giocatori per modalità (numero tramite leaderboardSize), ordinati per kill. I nuovi valori compaiono al massimo dopo un minuto, dopo un match subito.

Per sviluppatori

-- Server
local inPvp = exports.off_pvp:IsInPvp(source)        -- FFA, Only o match in corso
local ffa = exports.off_pvp:IsFFA(source)
local only = exports.off_pvp:IsOnly(source)
local lobby = exports.off_pvp:IsLobby(source)        -- in un match in corso
local inLobby = exports.off_pvp:IsInLobby(source)    -- membro di una lobby, in attesa o nel match
local info = exports.off_pvp:GetPvp(source)          -- { kind, id, team, alive, kills, deaths } o nil
local removed = exports.off_pvp:RemoveFromPvp(source) -- toglie il giocatore da zona, match o lobby in attesa, true/false
local stats = exports.off_pvp:GetStats(source)       -- { ffa = { kills, deaths }, only = { ... }, lobby = { kills, deaths, wins, losses } } o nil

-- Client
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' finché il giocatore è in una zona o in un match.
• offinventory: canOpen() in off_inventory/config/functions.lua blocca inventario e bagagliaio nel PvP non appena offpvp è attivo.

Problemi comuni

All'avvio lo script segnala errori e avvisi nella console del server. Zone e mappe con errori vengono indicate lì e ignorate.