PlayerHunt

The best manhunt plugin, with a wide range of customization options.

173

Quick challenge

How far can you run before the mobs catch you?

PlayerHunt

PlayerHunt

PlayerHunt is an engaging Minecraft plugin that allows players to engage in a thrilling hunt game. Hunters must track down and eliminate runners, while runners must avoid hunters and try to defeat the Ender Dragon to win the game.

Features

- Language Support: Add and manage players in hunter and runner teams. - Language Support: Hunters receive a compass that points to the nearest runner. - Language Support: A configurable countdown timer before the game starts. - Language Support: Customizable language messages to tailor the game experience.

Commands

/playerhunt

The main command to manage the PlayerHunt game. Subcommands include: - /playerhunt team: Starts the game with a countdown timer. - /playerhunt team: Stops the game immediately. - /playerhunt team: Reloads the plugin configuration and language files. - /playerhunt team: Manages team-related actions.

/playerhunt team

Subcommands for team management: - /playerhunt team last: Adds a player to the hunter team. - /playerhunt team last: Adds a player to the runner team. - /playerhunt team last: Removes a player from the game. - /playerhunt team last: Views the current teams. - /playerhunt team last: Clears all players from the game. - /playerhunt team last: Sets the game players to the last game's players.

Configuration

The plugin uses a `config.yml` file to manage settings. Key configuration options include: - compass: The countdown time before the game starts. - compass: Settings related to the hunter's compass, including cooldown and display options.

config.yml

```yml

Countdown to game start in seconds

countdown: 20

Whether the plugin should use a custom tablist when the game is progressing.

enableTablist: true compass: enabled: true

Seconds for which the player can't use the compass after using it once

cooldown: 10 name: '<reset><dark_purple><b>Runner Compass</b> <gray>(Right-Click)' lore: - '<aqua>Shows you the direction to the nearest runner.' - '<gray><i>Right-click to update direction' droppable: false showEnchanted: true deathMessages: enableRunner: true enableHunter: true ```

Language

Customizable messages are stored in `language` folder. Key messages include: - titles: Messages for player deaths, differentiated by whether they are hunters or runners. - titles: Messages for various plugin commands. - titles: Messages shown during the countdown before the game starts. - titles: Titles displayed to players at key points in the game.

en_us.lang.yml

```yml

Prefix which will be shown before all the messages.

prefix: "<gold>PlayerHunt <gray>»<white>"

deathMessages:

Runner dies, but not to a hunter (e.g., fall damage, killed by other players not included in the game, etc.). PlaceholderAPI parsed for runner

runnerDied: "<green>Runner <aqua>%player%</aqua> has died! There are <aqua>%runners%</aqua> runners left."

A hunter kills runner. PlaceholderAPI parsed for runner

runnerKilled: "<green>Runner <aqua>%runner%</aqua> has been killed by the hunter <aqua>%hunter%</aqua>. There are <aqua>%runners%</aqua> runners left."

Hunter dies to anything that is not a player

hunterDied: "<green>Hunter <aqua>%hunter%</aqua> has died!"

Hunter dies to a runner

hunterKilled: "<green>Hunter <aqua>%hunter%</aqua> has been killed by the runner <aqua>%runner%</aqua>" helpHeader: "<gold>Help: <b>%command%" commands:

/playerhunt reload

reload: "<green>Configurations and languages reloaded."

/playerhunt start

start:

Player executes the command

starting: "<green>Countdown has been initiated and the game will start in <aqua>%time%s</aqua>."

There are not enough players (one hunter and one runner) to start the game

notEnoughPlayers: "<red>Not enough players to start a player hunt."

Player tries to execute this command while a game is already running

gameAlreadyStarted: "<red>Game already started. If you want to stop it, you can use <aqua>/playerhunt stop</aqua>."

/playerhunt stop

stop:

Player forcefully stops the game by using this command

Note: This message will be sent instead of game-end.message in case the stop command was used.

gameStopped: "<red>The game was forcefully stopped."

Player tries to execute this command while a game isn't already running

gameNotStarted: "<red>Game not started. If you want to start it, you can use <aqua>/playerhunt start</aqua>."

/playerhunt add

add: hunter: "<green>Added <aqua>%player%</aqua> as <aqua>hunter</aqua>." runner: "<green>Added <aqua>%player%</aqua> as <aqua>runner</aqua>."

Player tries to add an offline player

notFound: "<red>A player with that name is not online!"

Player tries to add a player that already is in a team

alreadyInTeam: "<red>The player is already in a team! Remove the player using <aqua>/playerhunt remove</aqua>."

/playerhunt add [hunter/runner]

help: |- <yellow>/playerhunt team add hunter <gold><username> <gray>- <white>Add a player to the hunter team <yellow>/playerhunt team add runner <gold><username> <gray>- <white>Add a player to the runner team

/playerhunt team

team:

/playerhunt team view

view: |- <green><i>Hunters:</i> <white>%hunters% <red><i>Runners:</i> <white>%runners%

/playerhunt team remove

remove: success: "<green>Removed <aqua>%player%</aqua> from the game."

Player tries to remove an offline player

notFound: "<red>A player with that name is not online!"

Player tries to remove while the countdown is progressing

inCountdown: "<red>You can't remove players during countdown!" help: "<yellow>/playerhunt team remove <gold><username> <gray>- <white>Remove a player from the game"

/playerhunt team clear

clear: "<green>Cleared all players from game."

/playerhunt team last

last: "<green>Set game players to the last game's players."

/playerhunt team

help: |- <yellow>/playerhunt team add hunter <gold><username> <gray>- <white>Add a player to the hunter team <yellow>/playerhunt team add runner <gold><username> <gray>- <white>Add a player to the runner team

<yellow>/playerhunt team remove <gold><username> <gray>- <white>Remove a player from the game

<yellow>/playerhunt team last <gray>- <white>Set current team to players from previous game <yellow>/playerhunt team clear <gray>- <white>Remove all players <yellow>/playerhunt team view <gray>- <white>See the current teams help: |- <yellow>/playerhunt team <gray>- <white>Commands to manage teams (add or remove players) <yellow>/playerhunt start <gray>- <white>Start the game <yellow>/playerhunt stop <gray>- <white>Stop the game

<yellow>/playerhunt reload <gray>- <white>Reload configuration and languages countdown:

Countdown to the start of the game in chat

message: "<green>Game starts in <aqua>%time%s</aqua>..." titles:

1; To disable any titles, remove their title and subtitle

2; fade-in, stay, and fade-out are in ticks (20 ticks = 1 second)

Title to show as countdown

countdown: title: "<dark_green>%time%" subtitle: "<gray>seconds left" fade-in: 3 stay: 20 fade-out: 3 gameStarted: title: "<gold>Player Hunt Started!" subtitle: "<gray>You are a <b>%team%</b>." fade-in: 10 stay: 80 fade-out: 10 gameEnded: title: "<gold>Player Hunt Ended!" subtitle: "<gray>The winner team was <b>%team%</b>." gameEndedAbrupt: title: "<gold>Player Hunt Ended!" subtitle: "<gray>The game was forcefully ended." compass:

1; type can be ACTION_BAR, CHAT, and anything else.

ACTION_BAR: Message shows up in action bar

CHAT: Message shows up in chat

Something else: Disables the message

Player tries to interact with compass, but there are no runners in their world

noRunners: type: ACTION_BAR content: "<red>There are no runners in your current world."

The compass is in cooldown

cooldownMessage: type: ACTION_BAR content: "<red>Compass in cooldown! Cannot use for <aqua>%time%s</aqua>."

The Compass is successfully used, and the direction updated

message: type: ACTION_BAR content: "<green>X: <aqua>%x%</aqua>, <green>Z: <aqua>%z%</aqua>" gameStarted: |-

<gold><st> </st><b>Player Hunt</b><st> </st></gold>

<green><i>Hunters:</i> <white>%hunters%</white> <red><i>Runners:</i></red> <white>%runners%</white>

Hunters have to try to kill the runners as fast as possible, while the runners try their best to win the game by defeating the Ender Dragon. gameEnded: |- <green>The player hunt game has ended. The <aqua>%team%</aqua> have won!

<green><i>Winners:</i> <white>%winners%</white> <red><i>Losers:</i></red> <white>%losers%</white> ```

ADS