1.0.0
beta
Infected Manhunt
One infected hunter starts the chase. Every speedrunner death creates a new hunter. Your only objective: kill the Ender Dragon before everyone is infected.
115
Infected Manhunt
<div align="center">
🧟 Infected Manhunt
Beat the Ender Dragon before the infection takes everyone
</div>
<div align="center">
</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 | |:--|:--|:--| | 🏃 Infected | 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 | |:--|:--| | 🎨 Custom Team Colors | Runners who die instantly switch to the infected team and begin hunting | | 🎨 Custom Team Colors | Every death grows the infected team, making late-game incredibly intense | | 🎨 Custom Team Colors | Infected players always have a compass pointing at active runners | | 🎨 Custom Team Colors | Infected can choose exactly which runner to track via an in-game menu | | 🎨 Custom Team Colors | Manage games, teams, settings, and tracking without touching any files | | 🎨 Custom Team Colors | Move players between teams mid-match from the GUI or a single command | | 🎨 Custom Team Colors | Leaving and rejoining never corrupts a player's team assignment | | 🎨 Custom Team Colors | 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 | |:---:|:---|:---| | Play! | 📥 Play! | Get `infectedmanhunt-*.jar` from releases or build from source | | Play! | 📁 Play! | Place the jar in your server's `plugins/` folder | | Play! | 🔄 Play! | Start or restart the server to generate configs | | Play! | ⚙️ Play! | Edit `plugins/InfectedManhunt/config.yml` if needed | | Play! | 🎮 Play! | Run `/infected gui` in-game and start your first match |
</div>
Requirements
- Minecraft Bukkit - Bukkit, Bukkit, Bukkit, 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 selecting 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)
- Shift-click a player → make them a runner - Shift-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 last-known location carry the tracking compass - last-known location → cycle between available runners - last-known location → 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
```bash mvn package ```
Output: `target/infectedmanhunt-1.0.2.jar`
---
📋 Notes for Server Owners
- The plugin is designed around Disconnect-safe state with minimal visual clutter. - The Disconnect-safe state — most server owners will never need to memorize commands. - Disconnect-safe state 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.
---
<div align="center">
🙌 Credits & Support
Inspired by Sapnap's iconic Infected Manhunt format
Developed by muj4b
---
🎉 Experience the Infection Today! 🎉
Snowballing gameplay • Compass tracking • Full GUI control • Endless chaos
*Found a bug or have a suggestion? Report it on our Discord!*
</div>