PVP

PvP-System mit FFA-Zonen, Only-Zonen und Lobby-Matches in Teams. Jede Zone und jedes Match läuft in einer eigenen Dimension. Dazu gibt es ein Leaderboard und eine Match-Anzeige. Die Tabelle legt das Script selbst an.

Funktionen

• FFA-Zonen: Jeder gegen jeden. Pro Zone feste Waffen oder die eigenen Waffen des Spielers. Respawn mit Weste und kurzem Spawnschutz.
• Only-Zonen: Alle haben dieselben Waffen, optional mit Fahrzeug (z. B. BF 400) bei jedem Spawn.
• Lobbys: Team A gegen Team B im Best-of-Modus mit Entscheidungsrunde. Map, Modus (zu Fuß oder Fahrzeug), Runden, bis zu 3 Waffen und ein optionales Passwort sind wählbar. Der Owner kann kicken, mischen und auflösen.
• Zuschauen: Wer in einer Runde ausscheidet, schaut den lebenden Teamkameraden zu und wechselt mit ← →.
• Match-Anzeige oben in der Mitte und Leaderboard mit Filter FFA, Only und Lobby (inklusive Siege und Niederlagen).
• Waffenschutz: Feste Waffen gibt es nur im PvP. Die echten Waffen und ihre Munition bleiben geschützt.
• Discord-Logs, Exports und eigene Funktionen zum Anbinden anderer Scripts.

Installation

1. Ordner off_pvp in deinen resources-Ordner legen.
2. In die server.cfg, nach oxmysql und ESX:

ensure oxmysql
ensure es_extended
ensure off_pvp

1. PvP-Punkte, Zonen und Maps in config/ an deinen Server anpassen.

Die Tabelle off_pvp_stats wird beim ersten Start automatisch angelegt.

Konfiguration

Die Einstellungen liegen in config/settings/: config.lua für alles Allgemeine, config.ffa.lua, config.only.lua und config.lobby.lua für die drei Modi.

config/settings/config.lua

PvP-Punkte (points):

config/settings/config.ffa.lua und config/settings/config.only.lua

Config.ffa und Config.only enthalten die Zonen. Jede Zone hat:

config/settings/config.lobby.lua

Config.lobby enthält die Einstellungen für Lobbys:

Config.maps enthält die Maps für Lobbys:

config/functions.lua

Hier bindest du eigene Scripts an. Fehler darin landen in der Konsole, das Script läuft weiter. kind ist immer 'ffa', 'only' oder 'lobby'.

config/settings/config.server.lua und Sprachen

Discord-Webhooks für lobby (Lobby erstellt, Match gestartet, Match beendet, Lobby aufgelöst) und zones (Zone betreten und verlassen). '' schaltet einen Log aus. Alle Texte stehen in config/locales/ (eine Datei pro Sprache).

Im Spiel

• Menü: E an einem PvP-Punkt. Das geht nur lebend, zu Fuß, in der normalen Dimension und nicht im Gangwar.
• FFA und Only: Beitreten teleportiert dich in die Zone. Nach dem Tod geht es nach respawn.seconds an einem Spawn weiter. Oben siehst du Kills, Tode und die Spieler in der Zone.
• Verlassen: /quitffa (oder dein quitCommand) bringt dich an den Ort zurück, an dem du beigetreten bist. Leben und Weste sind wie vorher, die eigenen Waffen kommen zurück. Der Befehl verlässt auch eine wartende Lobby.
• Lobby erstellen: Map, Modus, Runden, Waffen und optional ein Passwort wählen. Neue Spieler kommen ins kleinere Team. Wechseln geht, solange das andere Team nicht voll ist. Nach 5 falschen Passwörtern ist die Lobby für dich 60 Sekunden gesperrt.
• Owner: startet, mischt, kickt und löst auf. Geht der Owner, übernimmt das nächste Mitglied.
• Start: Wer tot ist, in einer anderen Dimension, im Gangwar oder weiter als startRange von einem PvP-Punkt entfernt, fliegt aus der Lobby. Jedes Team braucht mindestens einen Spieler.
• Match:
• Jede Runde beginnt mit der Vorbereitung (eingefroren, ohne Waffen), danach gibt es Waffen und Weste.
• Eine Runde gewinnt, wer das ganze Gegnerteam ausschaltet. Innerhalb einer Runde gibt es keinen Respawn. Fallen die letzten beiden gleichzeitig, gibt es keinen Punkt.
• Läuft das Zeitlimit ab, gewinnt das Team mit mehr lebenden Spielern, bei Gleichstand gibt es keinen Punkt.
• Das Match gewinnt, wer zuerst mehr als die Hälfte der Runden holt. Sind alle Runden gespielt, gewinnt der höhere Stand. Bei Gleichstand gibt es Entscheidungsrunden (overtimeRounds), danach ein Unentschieden.
• Friendly Fire ist an. Ein Teamkill zählt als Tod, nicht als Kill.
• Wer ein laufendes Match verlässt, bekommt eine Niederlage. Ist ein Team danach leer, gewinnt das andere sofort.
• Danach kommen alle an ihren Ausgangsort zurück, die Lobby bleibt offen und wartet wieder.
• Zuschauen: Nach spectateDelay Sekunden schaust du einem lebenden Teamkameraden zu. Unten in der Mitte stehen sein Name und die Pfeile. ← und → wechseln.
• Garage (Fahrzeug-Maps): Während der Runde öffnet E am Garagen-Marker deines Teams die Fahrzeugliste. Jeder Spieler hat ein Fahrzeug, ein neues ersetzt das alte.
• Leaderboard: Die besten Spieler pro Modus (Anzahl über leaderboardSize), sortiert nach Kills. Neue Werte erscheinen spätestens nach einer Minute, nach einem Match sofort.

Für Entwickler

-- Server
local inPvp = exports.off_pvp:IsInPvp(source)        -- FFA, Only oder laufendes Match
local ffa = exports.off_pvp:IsFFA(source)
local only = exports.off_pvp:IsOnly(source)
local lobby = exports.off_pvp:IsLobby(source)        -- in einem laufenden Match
local inLobby = exports.off_pvp:IsInLobby(source)    -- Mitglied einer Lobby, wartend oder im Match
local info = exports.off_pvp:GetPvp(source)          -- { kind, id, team, alive, kills, deaths } oder nil
local removed = exports.off_pvp:RemoveFromPvp(source) -- holt den Spieler aus Zone, Match oder wartender Lobby, true/false
local stats = exports.off_pvp:GetStats(source)       -- { ffa = { kills, deaths }, only = { ... }, lobby = { kills, deaths, wins, losses } } oder 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 } oder nil

• Statebag offPvp: 'ffa', 'only' oder 'lobby', solange der Spieler in einer Zone oder einem Match ist.
• offinventory: canOpen() in off_inventory/config/functions.lua sperrt Inventar und Kofferraum im PvP, sobald offpvp läuft.

Häufige Fehler

Beim Start meldet das Script Fehler und Hinweise in der Server-Konsole. Fehlerhafte Zonen und Maps werden dort genannt und ignoriert.