Manhunt 6

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.compass` (OP-only): Main permission that includes: - `manhunt6.command.players` - Team management commands - `manhunt6.command.start` - Start game - `manhunt6.command.stop` - Stop game - `manhunt6.command.compass` (Default: true): View game information - `manhunt6.command.compass` (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. `all_runners_portal` - A speedrunner gets the "Free The End" advancement 2. `all_runners_portal` - Any player gets the "Free The End" advancement 3. `all_runners_portal` - A speedrunner kills the Ender Dragon 4. `all_runners_portal` - The Ender Dragon dies (any cause) 5. `all_runners_portal` - 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