Infected Manhunt

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper purpur spigot

标签： game-mechanics minigame social

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.

---