PVP

Système PvP avec zones FFA, zones Only et matchs de lobby en équipes. Chaque zone et chaque match tourne dans sa propre dimension. En plus, il y a un classement et un affichage de match. Le script crée lui-même la table.

Fonctionnalités

• Zones FFA : chacun pour soi. Par zone, des armes fixes ou les propres armes du joueur. Respawn avec gilet et courte protection au spawn.
• Zones Only : tout le monde a les mêmes armes, en option avec un véhicule (p. ex. BF 400) à chaque spawn.
• Lobbys : équipe A contre équipe B en mode best-of avec manche décisive. Map, mode (à pied ou véhicule), manches, jusqu'à 3 armes et un mot de passe optionnel au choix. Le propriétaire peut expulser, mélanger et dissoudre.
• Spectateur : celui qui est éliminé pendant une manche regarde ses coéquipiers encore en vie et change avec ← →.
• Affichage de match en haut au centre et Classement avec les filtres FFA, Only et Lobby (victoires et défaites comprises).
• Protection des armes : les armes fixes n'existent qu'en PvP. Les vraies armes et leurs munitions restent protégées.
• Logs Discord, exports et tes propres fonctions pour brancher d'autres scripts.

Installation

1. Place le dossier off_pvp dans ton dossier resources.
2. Ajoute dans le server.cfg, après oxmysql et ESX :

ensure oxmysql
ensure es_extended
ensure off_pvp

1. Adapte les points PvP, les zones et les maps dans config/ à ton serveur.

La table off_pvp_stats est créée automatiquement au premier démarrage.

Configuration

Les réglages se trouvent dans config/settings/ : config.lua pour tout ce qui est général, config.ffa.lua, config.only.lua et config.lobby.lua pour les trois modes.

config/settings/config.lua

Points PvP (points) :

config/settings/config.ffa.lua et config/settings/config.only.lua

Config.ffa et Config.only contiennent les zones. Chaque zone a :

config/settings/config.lobby.lua

Config.lobby contient les réglages des lobbys :

Config.maps contient les maps des lobbys :

config/functions.lua

C'est ici que tu branches tes propres scripts. Les erreurs qu'elles contiennent arrivent dans la console, le script continue de tourner. kind vaut toujours 'ffa', 'only' ou 'lobby'.

config/settings/config.server.lua et langues

Webhooks Discord pour lobby (lobby créé, match lancé, match terminé, lobby dissous) et zones (entrée et sortie de zone). '' désactive un log. Tous les textes se trouvent dans config/locales/ (un fichier par langue).

En jeu

• Menu : E à un point PvP. Ça ne marche que vivant, à pied, dans la dimension normale et pas en gangwar.
• FFA et Only : Rejoindre te téléporte dans la zone. Après la mort, tu reprends sur un spawn après respawn.seconds. En haut, tu vois les kills, les morts et les joueurs dans la zone.
• Quitter : /quitffa (ou ton quitCommand) te ramène à l'endroit où tu as rejoint. Vie et gilet sont comme avant, tes propres armes reviennent. La commande quitte aussi un lobby en attente.
• Créer un lobby : choisis la map, le mode, les manches, les armes et, en option, un mot de passe. Les nouveaux joueurs vont dans l'équipe la plus petite. Changer d'équipe est possible tant que l'autre équipe n'est pas pleine. Après 5 mauvais mots de passe, le lobby est bloqué pour toi pendant 60 secondes.
• Propriétaire : lance, mélange, expulse et dissout. Si le propriétaire part, le membre suivant prend le relais.
• Lancement : celui qui est mort, dans une autre dimension, en gangwar ou plus loin que startRange d'un point PvP est retiré du lobby. Chaque équipe a besoin d'au moins un joueur.
• Match :
• Chaque manche commence par la préparation (figé, sans armes), ensuite il y a les armes et le gilet.
• Une manche est gagnée par l'équipe qui élimine toute l'équipe adverse. Pas de respawn pendant une manche. Si les deux derniers tombent en même temps, personne ne marque.
• Si la limite de temps est atteinte, l'équipe avec le plus de joueurs en vie gagne, en cas d'égalité personne ne marque.
• Le match est gagné par l'équipe qui remporte en premier plus de la moitié des manches. Quand toutes les manches sont jouées, le meilleur score gagne. En cas d'égalité, il y a des manches décisives (overtimeRounds), puis un match nul.
• Le tir allié est activé. Un teamkill compte comme une mort, pas comme un kill.
• Celui qui quitte un match en cours prend une défaite. Si une équipe est vide ensuite, l'autre gagne tout de suite.
• Ensuite, tout le monde revient à son point de départ, le lobby reste ouvert et attend à nouveau.
• Spectateur : après spectateDelay secondes, tu regardes un coéquipier en vie. En bas au centre s'affichent son nom et les flèches. ← et → changent de joueur.
• Garage (maps véhicule) : pendant la manche, E au marker du garage de ton équipe ouvre la liste des véhicules. Chaque joueur a un véhicule, un nouveau remplace l'ancien.
• Classement : les meilleurs joueurs par mode (nombre via leaderboardSize), triés par kills. Les nouvelles valeurs apparaissent au plus tard après une minute, tout de suite après un match.

Pour les développeurs

-- Serveur
local inPvp = exports.off_pvp:IsInPvp(source)        -- FFA, Only ou match en cours
local ffa = exports.off_pvp:IsFFA(source)
local only = exports.off_pvp:IsOnly(source)
local lobby = exports.off_pvp:IsLobby(source)        -- dans un match en cours
local inLobby = exports.off_pvp:IsInLobby(source)    -- membre d'un lobby, en attente ou en match
local info = exports.off_pvp:GetPvp(source)          -- { kind, id, team, alive, kills, deaths } ou nil
local removed = exports.off_pvp:RemoveFromPvp(source) -- sort le joueur d'une zone, d'un match ou d'un lobby en attente, true/false
local stats = exports.off_pvp:GetStats(source)       -- { ffa = { kills, deaths }, only = { ... }, lobby = { kills, deaths, wins, losses } } ou 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 } ou nil

• Statebag offPvp : 'ffa', 'only' ou 'lobby' tant que le joueur est dans une zone ou un match.
• offinventory : canOpen() dans off_inventory/config/functions.lua bloque l'inventaire et le coffre du véhicule en PvP dès que offpvp tourne.

Problèmes fréquents

Au démarrage, le script signale les erreurs et les remarques dans la console du serveur. Les zones et maps erronées y sont indiquées et ignorées.