# Wargames

**3M Wargames** is a standalone PvP arena resource for FiveM that ships with a modern NUI mode picker + in‑match HUD, killfeed, and a persistent top leaderboard (MySQL).

### Modes

* **FFA** (Free‑For‑All) — everyone vs everyone, fast respawn, first to target kills wins.
* **TDM** (Team Deathmatch) — SAS vs WARCOM, team max size & target kills.
* **S\&D** (Search & Destroy) — Operators vs Terrorists, rounds, plant/defuse holds, bomb timer.

### Key features (from code)

* **NUI picker** (mode / team / loadout) + **HUD overlay**
* **Killfeed** with optional team colors, headshot detection, streaks, and S\&D events
* **Routing buckets / instances** per lobby (optional)
* **Safe spawns** (zone polygon + clean spawn points + separation)
* **Loadouts** via **ox\_inventory** (server side) or native GiveWeapon fallback
* **Inventory snapshot/restore** (ox\_inventory) when joining/leaving matches
* **Clothing bridge** (Illenium / esx\_skin / 0r‑clothing / fivem‑appearance) for team outfits
* **Ambulance revive bridge** (wasabi / qb‑ambulancejob / esx\_ambulancejob / tk\_ambulancejob / fallback instant revive)
* **Persistent stats** table: `wargames_stats` (kills/deaths/wins per mode)

### Requirements

#### Mandatory

* `oxmysql`
* `ox_lib` (loaded in shared\_scripts)

#### Optional (auto‑detected / configurable)

* `ox_inventory` (for safe inventory snapshot + server‑side loadout giving)
* Notification resource: `okokNotify` (if `Config.Notify.system = 'okok'`)
* Clothing resources depending on your chosen provider:
  * `illenium-appearance`
  * `esx_skin`
  * `0r-clothing`
  * `fivem-appearance`
* Ambulance systems (if you want native revive integration):
  * `wasabi_ambulance`, `qb-ambulancejob`, `esx_ambulancejob`, `tk_ambulancejob`

### Quick start

1. Import the database file: **`db.sql`** (creates `wargames_stats`)
2. Configure **`config.lua`** (entry marker, zone/spawns, loadouts, S\&D settings)
3. Ensure dependencies (see Installation)
4. Start the resource: `ensure 3M_Wargames`
5. In-game, go to the **Entry marker** and press **E** to open the menu