# 🎮 TTP Survival - Wave-Based Survival System for QBCore

**TTP Survival** is a comprehensive wave-based survival system for QBCore frameworks that provides an immersive combat experience with multiple unique locations, customizable difficulty, and rewarding gameplay mechanics. Players team up to survive waves of increasingly difficult enemies across 19 unique arenas, from mountain peaks to underground bunkers.

## ✨ Key Features

### 🌍 **19 Preconfigured Survival Locations**

### ⚔️ **Advanced Combat System**

- **Wave-Based Progression**: 10 configurable waves with increasing difficulty

- **Dynamic Enemy Scaling**: Enemy count scales with player count and wave number

- **Vehicle Spawns**: Enemy vehicles appear from wave 3+

- **Helicopter Support**: Armed helicopters from wave 5+

- **Enemy Types**: Gang members, military, police, aliens, holiday characters, and juggernauts

- **Relationship Groups**: Custom AI relationship system for proper combat behavior

- **Smart Enemy AI**: Enemies use cover, tactical movement, and team coordination

### 💰 **Economy & Rewards**

- **Entry Fee System**: Pay to enter missions (configurable per location)

- **Per-Kill Rewards**: Pay per enemy eliminated (configurable)

- **Wave Completion Bonus**: Per wave (configurable)

- **Mission Completion**: For completing all waves (configurable)

- **Refund System**: Optional refund on mission failure

- **Payment Types**: Cash, bank, or crypto support

### 🎯 **Gameplay Mechanics**

- **Lives System**: 3 lives per player with auto-revive

- **Weapon Looting**: Pick up enemy weapons with configurable drop rates

- **Auto-Pickup**: Walk over loot to collect automatically

- **Medical Supplies**: Bandages and medkits spawn throughout missions

- **Temporary Inventory**: Weapons don't persist after missions

- **Team Play**: Up to 4 players per session

- **Private Instances**: Routing bucket system for isolated missions

### 🎨 **Customization Options**

- **Fully Configurable**:

  - Wave count and enemy counts

  - Enemy health, armor, and accuracy

  - Reward amounts and payment types

  - Lives and revive delays

  - Weapon drops and loot rates

  - Starting weapons and ammo

### 🗺️ **Location-Specific Features**

Each location includes:

- Custom enemy ped models specific to the theme

- Enemy spawn points per location

- Medpack spawn locations

- Unique weapon pools

- Vehicle spawn configurations

- Helicopter spawn options

- Custom pricing

---

## 🛠️ **Technical Features**

### **Server-Side Authority**

- Server-authoritative mission state

- Anti-cheat protection through server validation

- Network synchronization for all players

- Routing bucket isolation for private instances

### **Optimized Performance**

- Efficient enemy tracking system

- Dynamic spawn point distribution

- Smart cleanup of corpses and loot

- Optimized relationship group management

- Threaded combat AI for smooth gameplay

### **Developer-Friendly**

- Clean, well-commented code

- Modular file structure

- Easy configuration system

- Export functions for external resources

- Event-driven architecture

---

## 📦 **Installation**

1. Download and place `ttp-survival` in your resources folder

2. Add `ensure ttp-survival` to your `server.cfg`

3. Ensure dependencies are installed:

   - `qb-core`

   - `ox_lib`

4. Configure `config.lua` to your preferences

5. Restart your server

## ⚖️ **License & Credits**

- **Script**: TTP Development

- **Framework**: QBCore

- **UI Library**: ox_lib

- All locations use default GTA V map coordinates

- Compatible with most inventory systems