> 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

## What is ic\_arenas?

ic\_arena is a comprehensive PvP arena system for FiveM that provides players with competitive combat experiences across multiple game modes. Players can engage in Free-For-All deathmatches, team-based battles, and elimination rounds with full statistics tracking, killstreak rewards, and an immersive HUD system.

### Key Features

#### 🎮 Multiple Game Modes

* **Free For All (FFA)** - Every player for themselves with instant respawn
* **Team Deathmatch (TDM)** - 2 teams battling with team spawn points
* **Showdown (Rounds)** - Elimination-based rounds, first team to win X rounds wins

#### 📊 Advanced Statistics System

* Separate stats tracking for each game mode
* Tracks kills, deaths, K/D ratio, and matches played
* Real-time HUD displaying current performance
* Persistent statistics saved to database

#### 🔥 Killstreak System

* 10 different killstreak levels (Double Kill → Godlike)
* Killstreak sounds for each level
* Rewards: Armor boosts and speed increases
* Toggle killstreak effects on/off per player

#### 🎯 Boundary System

* Polygon-based play area boundaries with min/max Z coordinates
* Warning system before player elimination
* Visual debug mode

#### 💎 Immersive HUD System

* **FFA/TDM HUD** - Diamond-styled UI showing kills and deaths
* **Showdown HUD** - Full round information with team scores, player status, and round timer
* **Killfeed** - Real-time kill notifications
* **Killstreak notifications** - Animated on-screen announcements

#### 🗺️ Flexible Map System

* Easy-to-configure map definitions
* Separate spawn points for FFA and team modes
* Weapon restriction support per lobby
* Pre-configured maps included

#### 🏥 Multi-Ambulance Support

* Auto-detection of 9+ popular ambulance scripts
* QB-Core, QBX, ESX, Wasabi, and more
* Easy custom integration for unsupported scripts

#### ⚙️ Customizable Settings

* Configurable respawn times
* Adjustable killstreak rewards
* Custom kill rewards (health/armor)
* Multiple arena NPCs support
* Language system (English, Czech)

### How It Works

#### 1. Find the Arena

Players locate the Arena NPC on the map (marked with a blip).

#### 2. Browse Lobbies

Open the arena menu to view all available lobbies across three game modes with real-time player counts.

#### 3. Choose Your Mode

* **FFA** - Jump in and start fighting immediately
* **TDM** - Select Team 1 or Team 2
* **Showdown** - Pick a team and compete in elimination rounds

#### 4. Enter Combat

Players spawn in isolated routing buckets with:

* Boundary protection system
* Team markers (TDM/Showdown only)
* Kill rewards on each elimination
* Killstreak bonuses as you dominate

#### 5. Track Performance

Monitor your progress with:

* Real-time HUD showing kills/deaths
* Killstreak notifications and sounds
* Live killfeed showing recent eliminations

### Resource Compatibility

Works seamlessly with any framework supported by ic\_lib:

* ✅ **Frameworks:** QB, QBX, ND Core, ESX
* ✅ **Ambulance Scripts:** qb-ambulancejob, qbx\_ambulancejob, esx\_ambulancejob, wasabi\_ambulance, tk\_ambulancejob, p\_ambulancejob, ND\_Ambulance, ars\_ambulancejob, ak47\_qb\_ambulancejob
* ✅ **Target Systems:** qb-target, ox\_target (optional - works standalone)
* ✅ **Database:** oxmysql

### Perfect For

* **PvP Servers** - Dedicated combat arenas
* **Roleplay Servers** - Legal fighting venues, underground fight clubs
* **Hybrid Servers** - Break from RP with competitive gameplay
* **Training Servers** - Practice combat mechanics