Manhunt6

Manhunt6 is a Paper plugin that implements the popular Manhunt game mode for Minecraft 1.21.4 and above.

Installation

Requirements

• Paper server running Minecraft 1.21.4
• Java 21 or higher

Setup

1. Download the Manhunt6 JAR file
2. Place it in your server's plugins directory
3. Start or restart your server

Commands

Command	Description	Permission
/manhunt hunters add <player>	Add a player to the hunters team	manhunt6.command.players
/manhunt hunters clear	Remove all hunters from the pending list	manhunt6.command.players
/manhunt runners add <player>	Add a player to the speedrunners team	manhunt6.command.players
/manhunt runners clear	Remove all speedrunners from the pending list	manhunt6.command.players
/manhunt remove <player>	Remove a player from either team	manhunt6.command.players
/manhunt start	Begin the Manhunt game	manhunt6.command.start
/manhunt stop	Abort the current game	manhunt6.command.stop
/manhunt query	Show current game status	manhunt6.command.query (default: all)
/manhunt query pending	Show pending players list	manhunt6.command.query (default: all)
/manhunt query running	Show running game information	manhunt6.command.query (default: all)
/manhunt compass	Get a compass pointing to speedrunners	manhunt6.command.compass
/manhunt surrender	Surrender in the game	manhunt6.command.surrender

Permission Management

By default, all commands are restricted to operators except for:

• /manhunt query - Available to all players
• /manhunt surrender - Available to all players
• /manhunt compass - Available to all players

Permission Structure

• manhunt6.command (OP-only): Main permission that includes:
  • manhunt6.command.players - Team management commands
  • manhunt6.command.start - Start game
  • manhunt6.command.stop - Stop game
• manhunt6.command.query (Default: true): View game information
• manhunt6.command.surrender (Default: true): Allow players to surrender
• manhunt6.command.compass (Default: true): Allow hunters to get compasses

Game Rules and Behavior

Hunter Compass

• Hunters receive a compass pointing to speedrunners
• Compass updates to nearest speedrunner
• Shows distance to target if enabled in config
• Can be obtained with /manhunt compass (if you're a hunter)

Player Disconnects

• If lose-on-quit is true:
• Disconnected speedrunners lose a life
• Disconnected hunters are considered out of the game
• If lose-on-quit is false:
• Players can reconnect and continue playing

Runner Lives System

• Speedrunners have runner-lives chances to respawn
• Lives are tracked per player
• When lives reach 0, the player is eliminated

Configuration

The plugin creates a configuration file at plugins/Manhunt6/config.yml. Here's a detailed breakdown of all options:

Option	Description	Default
language	Plugin messages language (supports en or zh)	en
lose-on-quit	Whether players lose when they disconnect	true
hunter-loses-on-death	Whether hunters lose the game when they die	false
runners-lose-condition	When speedrunners lose (one or all)	all
runners-win-condition	When speedrunners win (see below)	runner_kills_the_dragon
runner-lives	Number of lives each speedrunner has	1
announce-runner-max-lives	Announce runner lives at game start	false
ban-locate-bar	Disable the locate bar if possible	true
compass-shows-distance	Show distance to target in compass tooltip	true

Win Conditions for Speedrunners

Speedrunners can win in several ways, configurable via runners-win-condition:

1. runner_frees_the_end - A speedrunner gets the "Free The End" advancement
2. anyone_frees_the_end - Any player gets the "Free The End" advancement
3. runner_kills_the_dragon - A speedrunner kills the Ender Dragon
4. dragon_dies - The Ender Dragon dies (any cause)
5. one_runner_portals - A speedrunner returns from The End to Overworld through the portal
6. all_runners_portal - All speedrunners return from The End to Overworld through the portal

Troubleshooting

Common Issues

• Game won't start
  • Check that you have at least 1 hunter and 1 speedrunner

• Verify no game is already running with /manhunt query

• Compass not working

  • Ensure the player is a hunter
  • Use /manhunt compass to get a new compass
  • Check that speedrunners are in the same world

• Messages not displaying correctly

  • Verify the language file exists (plugins/Manhunt6/language/[lang].yml)
  • Try switching to English with language: en in config

• Win condition not triggering

  • Verify the correct win condition is set in config
  • Check that the Ender Dragon was actually killed or portal was used

Best Practices

• Pre-game Setup:

  • Use a fresh world or reset the End before starting
  • Ensure all players are ready before starting the game

• Balance Teams:

  • For fair gameplay, have 2-3 hunters per speedrunner
  • Adjust runner-lives for longer games (2-3 lives for casual play)

• Backup:

  • Backup your world before hosting events
  • Consider using a separate world for Manhunt games

Support

If you encounter issues not covered in this guide:

1. Check the server logs for error messages
2. Verify you're using the correct Paper version
3. Review the configuration settings carefully

Author

• teddyxlandlee