# SZ Fightzone — Family Venue Capture System

Turn your city into a battleground. Families fight to capture venues, hold them, and collect tribute into a vault they can rob. Everything runs with a live HUD and a full in-game admin panel.

## 🏴 How It Works

1. **A venue opens** on your schedule (or manually) and every eligible family gets an announcement.

2. **Pull a weapon on the venue boss** to start the capture.

3. **Every second, standing players in the zone are counted per family.** The family with the most players standing fills its own timer, while other families keep their progress. A tie freezes the timer.

4. **The first family to reach the required time wins** and owns the venue for a set period.

5. **Tribute is paid into the venue's vault** at regular intervals while they hold it.

6. **Owners rob the vault** at the boss NPC to collect the money.

7. When ownership ends, the venue cools down and opens again for the next fight.

Families are based on **jobs**. Legal jobs (police, ambulance, …) can be excluded, or you can allow only specific jobs.

## 📺 Live HUD & Announcements

- **Venue status cards:** being captured, owned, or capturable

- **Capture progress bar** with the leading family, timer and standing count

- **Announcements** for venue open, capture started and venue captured

- Works with the built-in notifications, qb-core, ox_lib, ESX or your own notify export

## 💰 Tribute & Vault

- Random tribute between a min and max amount, at an interval you set per venue

- Optional instant first tribute when a venue is captured

- The vault keeps its balance for the next owner

- Robbing requires the owner job, a minimum job grade and being at the boss

- Pays out as cash or bank; ox_target or qb-target interaction with a progress bar

- Failed robbery attempts are logged with the reason

## 🛡️ Fair & Secure

- All checks are done on the server: weapon in hand, distance, job, grade, downed state

- If the zone is left empty, or the optional time limit runs out, the capture is cancelled

- In overlapping zones, a player only counts for the nearest venue

- Rate limits on every player and panel request

## 🛠️ In-Game Admin Panel

- **Dashboard:** active venues, captures, wins, vault deposits and withdrawals, top families and top earning players, live event feed (24 hours / 7 days / 30 days / all time)

- **Venues:**

- Add a new venue at your location

- Edit, open/close, reset, end a capture, delete

- Teleport to a venue

- Add or remove vault money with a logged reason

- **Logs:** all events, entry/exit, captures, vault activity, with search and filters

- **System:** shut the system down with a reason shown to players, or reset all venues

- **Discord logs** with a separate webhook per channel (captures, vault, robberies, zone entry, system)

## ⚙️ Fully Configurable

Venues, NPCs, blips, zones, markers, timings, payouts, jobs, texts, notifications, Discord and UI are all in **config.lua**. Automatic opening hours are supported. Database tables are created automatically.

## 📋 Requirements

- QBCore (Qbox supported)

- oxmysql

- Optional: ox_lib / progressbar, ox_target / qb-target

Admin panel command: `/fightzone`