PVP SYSTEM

# PvP System — FFA, Team Deathmatch & Arena Lobbies for FiveM

**FFA, 1v1 to 4v4 and custom teams up to 12v12. Your players open the menu, pick a lobby and fight.**

Risk PvP System is a FiveM PvP system for ESX, QBCore and QBox, also known as an FFA script, PvP lobby system or arena script. Players create their own free for all or team deathmatch lobbies at an NPC, admins build the zones ingame, and every match runs in its own routing bucket with a kill feed, killcam, death screen and a saved leaderboard. It ships in 7 languages.

---

## Why this one

Most FFA scripts do one thing: a single free for all zone, or 1v1 duels, or 4v4 at most. This one is the whole PvP side of your server in one resource.

- **Every mode in one menu.** Free for all, 1v1, 2v2, 3v3, 4v4 and custom sizes up to 12v12, all from the same lobby list.

- **Zones are built ingame.** Fly to the spot with a free camera, set the middle, scroll the radius, click the spawn points. No coordinates in any file.

- **Every lobby is its own world.** Each match runs in its own routing bucket, so a gunfight never leaks into the city.

- **A killcam is included.** When you die, the camera swings to the player who killed you and follows him until you respawn.

- **ESX, QBCore and QBox, 7 languages.** Most FFA scripts only run on ESX and only speak English.

---

## The Lobby Menu

Players walk up to the PvP NPC and press `E` (or use `ox_target` / `qb-target`). The menu opens with the game blurred behind it.

| Tab | What players see |

| --- | --- |

| **All** | Every open lobby, selected each time the menu opens |

| **1v1 · 2v2 · 3v3 · 4v4** | Only lobbies of that team size |

| **FFA** | Free for all lobbies |

| **Custom** | Every lobby a player created himself, plus odd sizes like 2v3 |

Every card shows the map picture, the mode, who leads the match and with how many kills, the time left and the weapons. Updates arrive the moment something changes, and the clocks count down in the menu itself. Full lobbies can still be watched as a spectator.

---

## Create Your Own Lobby

Every player can host a match. You decide who may create lobbies with one config line.

| Setting | Options |

| --- | --- |

| **Mode** | FFA, 1v1, 2v2, 3v3, 4v4 or custom teams up to 12v12 |

| **Visibility** | Public, or private with a password |

| **Zone** | Every zone that has enough spawn points for the chosen team size |

| **Kill limit** | 1 to 50 kills, or off |

| **Time limit** | 1 to 30 minutes, or off |

| **Rounds** | Best of 1 up to best of 9 |

| **Health** | 100 to 200 HP |

| **Weapons** | 47 weapons in 6 categories, quick picks or a search |

| **Rules** | Headshot only, friendly fire, spectators, heal on kill, spawn protection, armor |

A zone only shows up when every team has enough spawn points, so nobody can start a 6v6 on a map built for duels.

---

## The Zone Creator

Admins type `/pvpzones` and build the arenas ingame. No coordinates, no restart.

| Step | What you do |

| --- | --- |

| **Fly** | Free camera with `WASD`, mouse to look, `SHIFT` for speed |

| **Middle** | Aim and press `E` |

| **Radius** | Mouse wheel, 20 to 1000 meters, with a visible sphere |

| **Spawn points** | Click red and blue spawns, `G` switches the team, up to 48 points |

| **Rules** | Set the rules of the fixed lobbies of that zone and save |

Every mode you tick gets a **fixed server lobby** that never closes, so there is always a match to join. Drop a screenshot named after the zone into the `mapimages` folder and it shows on every card.

---

## Inside a Match

| Feature | What it does |

| --- | --- |

| **Kill feed** | Killer, weapon picture, headshot mark and victim. In team modes the entry and both names are red or blue |

| **Round HUD** | Time left and the kills of the leader, with his name or team |

| **K/D HUD** | Your kills, deaths and kill streak |

| **Death screen** | Who killed you, with which weapon, from how far and with how much HP left |

| **Killcam** | The camera swings to your killer and follows him until you respawn |

| **Team names** | Teammates' names in team color above their heads, visible through walls (optional) |

| **Respawn** | Spawn protection after every respawn, heal on kill if the lobby wants it |

| **End screen** | Results, ready button and the next round |

Leave the zone and you are teleported back. Type `/leave` and you are back where you started, with your own weapons, health and armor.

---

## 7 Languages Included

| Language | Included |

| --- | --- |

| English, German | ✅ |

| Spanish, Portuguese | ✅ |

| French, Italian, Dutch | ✅ |

Every text of the menu, the HUDs, the zone creator and the notifications is translated, and `Config.Locale` switches the whole UI. German servers know this kind of script as an FFA Script or Lobbysystem, Spanish and Portuguese servers call it a sistema PvP with todos contra todos, French servers a système PvP with chacun pour soi. Your own language is one more file, and any text you have not translated yet falls back to English.

---

## Spectate Any Match

Players can watch any public match, even a full one. They fly a free camera inside the zone and see the round HUD and the kill feed.

---

## Leaderboard and Stats

Kills, deaths, wins and games are saved for every player. The menu shows your K/D, your wins and your rank, and the leaderboard lists the top 100 by K/D with a podium for the best three.

---

## Built for Your Other Scripts

Death screens, ambulance scripts and shops can check if a player is inside a match.

```lua

-- Death screen or ambulance script: skip your own death handling inside a PvP match

if exports['risk-pvpsystem']:IsInZone() then return end

-- Server: block a shop, a job or a teleport while the player is in a round

if exports['risk-pvpsystem']:IsInRound(source) then return end

-- Client: only true in a free for all lobby

local ffa = exports['risk-pvpsystem']:IsInFFA()

```

Two hooks in the config run your own code when a player joins or leaves a round, for example to pause your ambulance job.

---

## Compatibility

| | Supported |

| --- | --- |

| **Framework** | ESX · QBCore · QBox — auto-detected at runtime |

| **Inventory** | No items needed. Weapons are given natively and your own weapons come back after the round. ox_inventory's weapon wheel is handled automatically |

| **Target** | ox_target · qb-target · built-in `E` key |

| **Database** | oxmysql · mysql-async · ghmattimysql — tables created automatically |

| **Notify** | GTA notify, or your own (risk-hudv3 is prepared) |

| **Languages** | English · German · Spanish · French · Italian · Dutch · Portuguese, add your own in one file |

---

## What You Get

- ✅ FFA, 1v1, 2v2, 3v3, 4v4 and custom teams up to 12v12

- ✅ Player-created lobbies, public or private with a password

- ✅ Ingame zone creator with free fly camera

- ✅ Fixed server lobbies for every zone

- ✅ Own routing bucket for every lobby

- ✅ 47 weapons in 6 categories with a weapon picker

- ✅ Rules: headshot only, friendly fire, spectate, heal on kill, spawn protection, armor

- ✅ Killcam that swings to your killer

- ✅ Death screen with weapon, distance and the killer's HP

- ✅ Team colored kill feed with headshot mark

- ✅ Round HUD with the leader's name, K/D HUD with kill streak

- ✅ Team name tags through walls

- ✅ Spectator free camera, also for full lobbies

- ✅ Leaderboard with K/D, wins and rank

- ✅ 7 languages, every string translatable

- ✅ Game blur behind the menu, whole UI color in one config line

- ✅ Exports for death screens, ambulance scripts and shops

- ✅ Exploit-safe, server-authoritative, 0.00ms idle

---

## Installation

1. Drop `risk-pvpsystem` into your resources folder

2. Add `ensure risk-pvpsystem` to your `server.cfg`

3. Set the place of the PvP NPC and your language in `config/config.lua` and restart

4. Type `/pvpzones` ingame and build your first zone

Database tables are created automatically on the first start. No SQL import needed.

**Requirements:** `oxmysql`, `mysql-async` or `ghmattimysql` · ESX, QBCore or QBox

---

## FAQ

**What is Risk PvP System?**

A FiveM PvP system for ESX, QBCore and QBox with player-created FFA and team deathmatch lobbies, an ingame zone creator, a killcam and a saved leaderboard.

**Is it an FFA script or an arena script?**

Both. Free for all is one mode next to 1v1, 2v2, 3v3, 4v4 and custom team sizes, all in the same lobby menu.

**Does it work with my inventory?**

Yes. The PvP System never uses inventory items. Round weapons are given natively and your own weapons are given back after the round, so it works with ox_inventory, qb-inventory, qs-inventory and any other inventory.

**Do I need to enter coordinates?**

No. Admins build every zone ingame with `/pvpzones`. The only position in the config is the NPC that opens the menu.

**Can players fight in the city by accident?**

No. Every lobby runs in its own routing bucket, and a player who leaves the zone is teleported back.

**Can I use it as a gangwar replacement?**

It is a lobby based system: players join a match on purpose. For organized team fights between gangs, a private 6v6 lobby with a password works well.

**Does it work with my death screen or ambulance script?**

Yes. Your death screen can skip PvP deaths with the `IsInZone` export, and two config hooks pause anything else while a player is in a round.

**How is the performance?**

0.00ms idle. The server only sends lobby updates when something changes, and only to players who have the menu open. Players outside the PvP System get nothing.

**Which languages are included?**

7, all complete: English, German, Spanish, French, Italian, Dutch and Portuguese. Add your own with one file, missing texts fall back to English.

**Can I change the colors?**

Yes. One line in the config sets the main color of the whole UI, and you can replace `logo.png` with your own logo.

---

https://youtu.be/taVfaqga91s