> For the complete documentation index, see [llms.txt](https://incity-development.gitbook.io/incity-development/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://incity-development.gitbook.io/incity-development/resources/ic_arenas.md).

# ic\_arenas

**A complete PvP arena system for FiveM.** Walk up to an NPC or use command, pick a fight, and drop into your own private copy of the map — with rankings, rewards and a scoreboard that remembers what you did.

***

### What is ic\_arenas?

ic\_arenas gives your server a permanent home for competitive combat. Players browse a menu of arenas, choose a mode, pick a weapon and fight — in an isolated world where nothing from the rest of the server can walk in.

It is not a deathmatch script with a leaderboard bolted on. Every match is recorded, every kill counts toward something, and the ranked mode moves a rating that players can lose. That is the difference between somewhere people shoot each other and somewhere people come back to.

***

### 🎮 Three ways to fight

#### 🔴 Free For All

*No teams. No allies. Everyone in the lobby is a target.*

You are back on your feet seconds after dying, so it never really stops. First player to the kill target takes the match — everyone else finishes where their kills put them. The HUD shows your place in the lobby at all times, and it goes critical the moment anybody is a kill or two from ending it.

#### 🔵 Team Deathmatch

*Two sides, one shared score.*

Every kill you land moves your team toward the target — and every one you hand over moves theirs. Instant respawn, so the pressure never lets up. A bell rings when a side gets close, so the last stretch of a match is the loudest part of it.

Friendly fire is a per-lobby switch, so you can run a casual arena and a punishing one side by side.

#### 🟣 Showdown — **ranked**

*One life a round.*

Die and you sit it out, watching a team-mate, until the next round opens. Take enough rounds and the match is yours. This is the mode that carries an **ELO rating** — it climbs when you win and falls when you lose, and walking out mid-match concedes it.

Rounds open with a countdown, everybody frozen on their marks. Your weapon is locked the moment the round goes live, so nobody strolls out of a firefight to fetch something better.

***

### ✨ What's inside

#### 🏆 Ranked play that actually ranks

Separate leaderboards per mode. Free For All and Team Deathmatch rank on kills; Showdown runs a proper **ELO rating** where beating a strong team pays more than beating a weak one.

Break into a top ten and you **earn a title** — Champion, Warlord, Executioner — and it follows you: your team-mates see it over your head and beside your name. Every mode gets its own set of titles, and you write them.

#### 🔫 Loadouts, not free-for-all weapons

Every arena offers a set of weapons and players pick one before they spawn.

Loadouts are named by **role**, one name per weapon category, so the same gun reads the same in every arena on your server:

|                 |               |                |              |
| --------------- | ------------- | -------------- | ------------ |
| 🔫 **Duelist**  | 💨 **Raider** | 🎯 **Assault** | 💥 **Shock** |
| 🔭 **Marksman** |               |                |              |

#### 🔥 Killstreaks with teeth

Ten tiers from **DOUBLE KILL** to **GODLIKE**, each with its own callout and sound. The deeper ones pay out — full armour, a burst of speed — and one death puts you back to nothing.

**Four different visual styles** to pick from, so the callout matches your server's look rather than someone else's. Any lobby can switch streaks off entirely, and any player can mute them for themselves.

#### 📊 Stats that stick around

Kills, deaths, K/D, matches, wins and playtime, tracked **per mode.**

#### 📜 Match history

Every finished match on a player's record: the scoreline, how long it ran, what it did to their rating — and **the full roster of who else was in it**. Open any match and see how everybody did.

#### 🎯 A HUD built for a firefight

* **Live score plate** — your kills, your deaths and where you stand, in a piece designed to hold up over grass, sky, asphalt and neon
* **Killfeed** with the weapon that got the kill
* **Hit markers** — white for a hit, red for a kill, **gold for a headshot** — with the damage floating up off it
* **Round and match screens** that tell each player what the result meant for *them*
* **Team panel** down the side in Showdown: who is on your side and who is still standing, updated the instant somebody goes down
* **Team markers** over each team-mate's head, so you never shoot your own
* **Spectate** a team-mate while you sit a round out, arrow keys to switch

#### 🗺️ Maps you can draw yourself

Every arena is a polygon boundary plus a set of spawn points. Cross the line and a countdown starts — get back inside or it kills you.

Turn on debug and **the fence draws itself in the world with every corner numbered**, so a post in the wrong place tells you exactly which line of the config to fix.

#### 🎙️ Squad voice

Everyone on a side shares a radio channel for as long as they are in the lobby, so a team can actually coordinate instead of shouting across the map. Works with pma-voice; costs you one config line.

#### 📢 Discord integration

A post per finished match — the scoreline and the full roster — straight into a channel. Per-mode switches, so you can post the ranked matches and keep the casual ones out.

#### 🩹 Revives that work

**Eleven ambulance scripts detected automatically**, and the arena does not take any of them at their word: the client checks the player actually got back up and asks again if they did not. A medical resource nobody has tested still ends with players on their feet.

#### ⚙️ Yours to change

* Every command can be **bound to a key** from the game's own settings menu — by the player, without you editing anything
* Every arena is a few lines in a config file
* Kill rewards per lobby — health, armour, **items**
* Win rewards for the side that takes the match
* AFK kick, so a full arena is a busy one

***

### 🕹️ How it works

**1. Find the arena.** Players spot the NPC on the map by its blip, or open the menu with a command or a key they bound themselves.

**2. Browse.** Every lobby of every mode in one panel, with **live** headcounts and scores. See who is already in there before you commit — including how they are doing.

**3. Look before you leap.** Open a lobby and you get the map picture, the loadouts on offer, what a kill pays, the rules of that arena, and a live scoreboard of the fight in progress.

**4. Pick a side, pick a weapon.** Team modes let you choose a side; every mode makes you pick a loadout. Then you drop straight in.

**5. Fight.** Your own private copy of the map — no traffic, no pedestrians, nobody from the rest of the server. Just the arena and everybody who chose it.

**6. Climb.** Kills feed your streak, your streak pays out, the match feeds your record and your record feeds the board.

***

### ✅ Works with what you already run

|                 |                                                                                               |
| --------------- | --------------------------------------------------------------------------------------------- |
| **Frameworks**  | QBCore · Qbox · ESX · ox\_core · ND Core                                                      |
| **Inventories** | ox\_inventory · qb-inventory · qs-inventory · tgiann-inventory · codem-inventory *(optional)* |
| **Targets**     | ox\_target · qb-target *(optional — works without one)*                                       |
| **Voice**       | pma-voice *(optional)*                                                                        |
| **Ambulance**   | qb · qbx · qbx\_medical · esx · wasabi · wasabi v2 · tk · p · ND · ars · ak47                 |
| **Required**    | `ox_lib` · `oxmysql`                                                                          |

***

### 💡 Perfect for

**PvP servers** — a full competitive stack out of the box: modes, ranks, ratings and history.

**Roleplay servers** — a fight club, a cartel proving ground, a legal underground venue. It lives behind an NPC and nothing leaks into the city.

**Hybrid servers** — somewhere for players to go when they want twenty minutes of shooting without leaving for another server.

**Training servers** — real gunfights against real players, with numbers that say whether anybody is getting better.