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?

---

---

🧟 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

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.

📋 Click to see all GUI menus

🏠 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.

---

📝 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	Reload config.yml without restarting

General Commands

Command	Description
/infected status	Display current game state and team counts
/infected track	Open the target picker if you are infected

---

🔐 Permissions

Permission	Access
infectedmanhunt.admin	Full control — GUI, start/stop, reload, team management
infectedmanhunt.command	Base command access for general players

---

🧭 Compass Rules

• Only infected players carry the tracking compass
• Right-click → cycle between available runners
• Sneak + right-click → open the target picker GUI
• If a runner is in another dimension, the compass falls back to their last-known location
• Runners cannot pick up, craft, or hold a hunter compass during a match

---

⚙️ Configuration

All settings live in plugins/InfectedManhunt/config.yml and can be adjusted from the GUI.

📄 Click to see all config options

🚦 Start Settings

Key	Description
start.teleport_to_spawn	Teleport all players to spawn when a match begins
start.announce_titles	Show title messages on game start and when players become infected

💀 Respawn Settings

Key	Description
respawn.mode	vanilla, world_spawn, or fixed
respawn.world	World name used for fixed respawn mode
respawn.x / respawn.y / respawn.z	Coordinates for fixed respawn mode

🧭 Tracking Settings

Key	Description
tracking.update_ticks	How often the compass updates its target position
tracking.message_cooldown_seconds	Cooldown between last-known location messages
tracking.notify_last_known	Enable or disable last-known location messages entirely

🎨 Team Settings

Key	Description
teams.speedrunner_color	Scoreboard/chat color for the runner team
teams.infected_color	Scoreboard/chat color for the infected team
teams.speedrunner_prefix	Chat prefix displayed for runners
teams.infected_prefix	Chat prefix displayed for infected players

---

🔨 Building From Source

mvn package

Output: target/infectedmanhunt-1.0.2.jar

---

📋 Notes for Server Owners

• The plugin is designed around vanilla-feeling gameplay with minimal visual clutter.
• The GUI is the primary control surface — most server owners will never need to memorize commands.
• Live team management lets admins correct player state during an active match without resetting anything.
• Disconnect-safe state means players who crash or leave won't corrupt the ongoing game.

---