PlayerHunt
The best manhunt plugin, with a wide range of customization options.
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. <br> <br> <img src="https://github.com/user-attachments/assets/2073c988-63c5-400f-a07b-dd02dc394ec5"/>
/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. <br> <br> <img src="https://github.com/user-attachments/assets/c8289b99-6076-4959-82a6-8bf3af9ebef0"/>
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> ```