Minecraft Manhunt

Overview

This plugin is a free, drag-and-drop solution to anyone who wants to play Minecraft Manhunt with their friends. It implements a player-tracking compass into your server that will point towards the chosen speedrunner - it even works in the Nether and the End!

This plugin was obviously inspired by
Dream's Minecraft Manhunt series, so credit where it's due.

Commands

• /selectrunner <name> | /runner <name> - Choose who the speedrunner will be.
• /getcompass | /compass - Give yourself a new tracking compass (hunters only).

Permissions

• manhunt.command.selectrunner - Access to /selectrunner.
• manhunt.command.getcompass - Access to /getcompass.

Usage

This plugin is very simple to use. All permissions are given by default, so no need to worry about not being able to use any of the commands. It is for use on Minecraft 1.16+ only, but I may add support for older versions if that's what people want - note that the tracking compass cannot work in dimensions that aren't the Overworld in versions prior to 1.16.

Once a speedrunner is selected, all other online players become hunters and are given a tracking compass each. If someone joins the server
after a speedrunner has been selected, they will not have a role, meaning if you want them to be a hunter too, you will need to select the speedrunner again by using the appropriate command.

If a hunter dies, they will automatically be given a new tracking compass upon respawning. If a hunter somehow loses their tracking compass, they can easily give themself another one by using the appropriate command.

How the Tracking Compass Works

The tracking compass in this plugin was designed to work intuitively across all three of Minecraft's dimensions - the Overworld, the Nether and the End. To use it, a hunter must simply right-click while holding it and its needle will point towards the speedrunner's last known location.

If the hunter is in the same dimension as the speedrunner, their last known location will be where the speedrunner was at the time of right-clicking.

If the hunter is in a different dimension to the speedrunner, their last known location will be where the speedrunner was just before they teleported from the dimension that the hunter is in (in most cases, this will be a portal).

Configuration File (config.yml)

Code (Text):

              TRACKING COMPASS              

Name

compass-name: "&eTracking Compass"

Lore (text underneath the name)

compass-lore:

• ""
• "&7Right-click to get the runner's"
• "&7last known location."

              GAMEPLAY OPTIONS              

Whether or not to clear everyone's inventory upon selecting a runner using /selectrunner <name> (the tracking compass is added to the hunters' inventories after this)

Default: true

selectrunner-clear-inventory: true

Whether or not to fully heal everyone's health, hunger and saturation upon selecting a runner

Default: true

selectrunner-heal: true

Whether or not to set the time to day (0 ticks) upon selecting a runner

Default: true

selectrunner-daytime: true

Whether or not to set the weather to clear upon selecting a runner

Default: true

selectrunner-clear-weather: true

Whether or not to play a sound when a hunter uses their tracking compass

Default: true

compass-use-play-sound: true

Sound to play if the above option is true - list of sounds: hub.spigotmc.org/javadocs/spigot/org/bukkit/Sou…

Default: UI_BUTTON_CLICK

compass-use-sound: UI_BUTTON_CLICK

Whether or not to remove tracking compasses from dropped items upon death

Default: true

remove-compass-on-death: true

                  MESSAGES                  

When a runner has been successfully selected using /selectrunner <name>

selectrunner-success: "&6%player% &ahas been selected as the runner."

When the player specified to be the runner is invalid

selectrunner-invalid-player: "&cInvalid player specified. Are they offline?"

When no player was specified to be the runner

selectrunner-no-player-specified: "&cYou must specify a player to be the runner."

When a hunter has successfully given themself a new tracking compass using /getcompass

getcompass-success: "&aYou have been given a new compass."

When a runner tries to give themself a tracking compass

getcompass-executed-by-runner: "&cOnly hunters can use this command."

When a player with no role tries to give themself a tracking compass

getcompass-no-role: "&cYou don't have a role."

When the console tries to give itself a tracking compass

getcompass-executed-by-console: "&cThis command can only be executed by a player."

When a hunter uses their tracking compass and it successfully points towards the runner's last known location

compass-use-success: "&aCompass pointing towards &6%player%&a's last known location."

When a hunter uses their tracking compass but the runner is not online

compass-use-runner-offline: "&cThe runner is not online."

When the runner tries to use a tracking compass

compass-use-by-runner: "&cOnly hunters can use this."

When a hunter tries to use their tracking compass but the last location of the runner is not known (this should never happen through normal gameplay, so don't worry about it)

compass-use-location-unknown: "&cLast location is not known."

Questions / Support / Bugs

If you have questions, need support or have encountered any bugs with the plugin, please do not use private messages or reviews to let me know. Instead, use the Discussion section and I will get back to you as quickly as I can.