Infected Manhunt

<div align="center"> # 🧟 Infected Manhunt ### Beat the Ender Dragon before the infection takes everyone </div> <div align="center"> !(https://img.shields.io/badge/Minecraft-1.21%2B-28A745?style=for-the-badge&logo=minecraft) !(https://img.shields.io/badge/API-Paper%2FSpigot%2FPurpur%2FBukkit-2875D7?style=for-the-badge) !(https://img.shields.io/badge/Mode-Infected_Manhunt-FF4D4D?style=for-the-badge) !(https://img.shields.io/badge/Version-1.0.2-FFC107?style=for-the-badge) </div> > **One player starts infected. Every runner who dies joins the hunt. Can the survivors defeat the Ender Dragon before the infection spreads to everyone — or will the infected team grow too powerful to stop?** --- <div align="center"> ## 🎬 Inspired by Sapnap's Infected Manhunt Series <table> <tr> <td align="center"> <strong>🧟 Infected Manhunt</strong><br> <a href="https://www.youtube.com/watch?v=ReZMjIoMBwY"><img src="https://img.youtube.com/vi/ReZMjIoMBwY/0.jpg" width="300"></a> </td> <em>Inspired by Sapnap's viral format</em> </td> </tr> </table> </div> --- ## 🧟 How It Works The game starts with a single infected hunter. Everyone else is a runner racing to beat the Ender Dragon. The twist? Every time a runner dies, they switch sides and start hunting too. The longer the game goes, the more the infected team snowballs — making every death feel like a catastrophe for the survivors. | Team | Goal | Win Condition | |:--|:--|:--| | 🏃 **Runners** | Defeat the Ender Dragon | Kill the dragon before everyone is infected | | 🧟 **Infected** | Infect every runner | Convert the entire lobby to their team | --- ## ✨ Features | Feature | Description | |:--|:--| | **🧟 Infection on Death** | Runners who die instantly switch to the infected team and begin hunting | | **📈 Snowballing Gameplay** | Every death grows the infected team, making late-game incredibly intense | | **🧭 Compass Tracking** | Infected players always have a compass pointing at active runners | | **🎯 Target Picker GUI** | Infected can choose exactly which runner to track via an in-game menu | | **🖥️ Full Admin GUI** | Manage games, teams, settings, and tracking without touching any files | | **🔁 Live Team Management** | Move players between teams mid-match from the GUI or a single command | | **🔌 Disconnect-Safe State** | Leaving and rejoining never corrupts a player's team assignment | | **⚙️ Configurable Respawns** | Choose between vanilla, world spawn, or a fixed custom location for infected players | | **🎨 Custom Team Colors** | Set your own colors and chat prefixes for each team | --- ## 🚀 Quick Start <div align="center"> | Step | Action | Details | |:---:|:---|:---| | **1** | 📥 **Download** | Get `infectedmanhunt-*.jar` from releases or build from source | | **2** | 📁 **Install** | Place the jar in your server's `plugins/` folder | | **3** | 🔄 **Restart** | Start or restart the server to generate configs | | **4** | ⚙️ **Configure** | Edit `plugins/InfectedManhunt/config.yml` if needed | | **5** | 🎮 **Play!** | Run `/infected gui` in-game and start your first match | </div> ### Requirements - Minecraft **1.21+** - **Paper**, **Purpur**, **Spigot**, or **Bukkit** *(Paper or Purpur recommended)* --- ## 🖥️ Admin GUI The GUI is the primary control surface — most server owners will never need to memorize a command. Open it any time with `/infected gui`. <details> <summary><strong>📋 Click to see all GUI menus</strong></summary> #### 🏠 Main Menu - Start a match with a **random** infected player - Start a match by **selecting** the first infected manually - Stop and fully reset the current match - View live match status - Open tracking, respawn, and team settings - Reload config without restarting #### 🧭 Tracking Settings - Adjust compass update speed - Set the cooldown on last-known location messages - Toggle last-known tracking messages on or off #### 💀 Respawn Settings - Set infected respawn mode: `vanilla`, `world_spawn`, or `fixed` - Save your current location as the fixed respawn point #### 🎨 Team Settings - Change runner and infected team colors - Edit runner and infected chat prefixes - Open the live **Team Management** screen #### 👥 Team Management (Live) - **Left-click** a player → make them a runner - **Right-click** a player → make them infected - **Shift-click** → toggle their team Designed for mid-match corrections and moderation — no need to stop and restart the game. </details> --- ## 📝 Commands ### Admin Commands | Command | Description | |:--|:--| | `/infected gui` | Opens the full admin GUI | | `/infected start <player>` | Start a game with a specific infected player | | `/infected start random` | Start a game with a randomly selected infected player | | `/infected stop` | Stop and fully reset the current game | | `/infected team <player> <runner\|infected>` | Move a player to a specific team during an active match | | `/infected reload