# Death Swap Minigame Plugin Documentation


## Overview
This plugin creates a Death Swap minigame where two teams (Hunters and Runners) periodically swap locations. The goal is to eliminate the other team before the next swap occurs.


## Key Features
- Customizable team sizes (1v1 up to 6v6)
- Configurable swap intervals (10 seconds to 30 minutes)
- Automatic team balancing
- Win conditions when one team is eliminated
- Admin controls for game management

## Setup Instructions
1. **Download the plugin** and place the `.zip` file into your server’s `plugins` folder.

2. Extract it and Restart or reload your server.


## Commands

### Setup Commands
1. **/sethunter <amount>**
- Sets maximum number of hunters (1-6)

2. **/setrunner <amount>**
- Sets maximum number of runners (1-6)

3. **/selecthunter <player>**
- Adds a player to the hunter team

4. **/selectrunner <player>**
- Adds a player to the runner team

5. **/settime <time>**
- Sets swap interval (e.g., "30s", "2m", "90")

### Game Control Commands
1. **/startdeathswap**
- Starts the game if teams are properly set up

2. **/stopdeathswap**
- Force stops an ongoing game

3. **/deathswapstatus**
- Shows current game configuration and status

## Game Mechanics
1. **Teams**:
- Hunters (red team) - Try to eliminate runners
- Runners (green team) - Try to survive and eliminate hunters

2. **Swapping**:
- At each interval, one random runner swaps locations with all hunters
- 10-second warning before each swap

3. **Winning**:
- Game ends when one team is completely eliminated
- Winners are announced in chat

## Permissions
- `deathswap.admin` - Required for all admin commands

## Notes
- Players who disconnect are automatically removed from their teams
- The game automatically checks win conditions after each death
- Minimum swap interval is 10 seconds, maximum is 30 minutes