# 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 - **Team Management:** Add and manage players in hunter and runner teams. - **Compass for Hunters:** Hunters receive a compass that points to the nearest runner. - **Countdown Timer:** 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 start:** Starts the game with a countdown timer. - **/playerhunt stop:** Stops the game immediately. - **/playerhunt reload:** Reloads the plugin configuration and language files. - **/playerhunt team:** Manages team-related actions.

### /playerhunt team Subcommands for team management: - **/playerhunt team add hunter ``:** Adds a player to the hunter team. - **/playerhunt team add runner ``:** Adds a player to the runner team. - **/playerhunt team remove ``:** Removes a player from the game. - **/playerhunt team view:** Views the current teams. - **/playerhunt team clear:** 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: - **countdown:** 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: 'Runner Compass (Right-Click)' lore: - 'Shows you the direction to the nearest runner.' - '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: - **deathMessages:** Messages for player deaths, differentiated by whether they are hunters or runners. - **commands:** Messages for various plugin commands. - **countdown:** 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: "PlayerHunt »" 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: "Runner %player% has died! There are %runners% runners left." # A hunter kills runner. PlaceholderAPI parsed for runner runnerKilled: "Runner %runner% has been killed by the hunter %hunter%. There are %runners% runners left." # Hunter dies to anything that is not a player hunterDied: "Hunter %hunter% has died!" # Hunter dies to a runner hunterKilled: "Hunter %hunter% has been killed by the runner %runner%" helpHeader: "Help: %command%" commands: # /playerhunt reload reload: "Configurations and languages reloaded." # /playerhunt start start: # Player executes the command starting: "Countdown has been initiated and the game will start in %time%s." # There are not enough players (one hunter and one runner) to start the game notEnoughPlayers: "Not enough players to start a player hunt." # Player tries to execute this command while a game is already running gameAlreadyStarted: "Game already started. If you want to stop it, you can use /playerhunt stop." # /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: "The game was forcefully stopped." # Player tries to execute this command while a game isn't already running gameNotStarted: "Game not started. If you want to start it, you can use /playerhunt start." # /playerhunt add add: hunter: "Added %player% as hunter." runner: "Added %player% as runner." # Player tries to add an offline player notFound: "A player with that name is not online!" # Player tries to add a player that already is in a team alreadyInTeam: "The player is already in a team! Remove the player using /playerhunt remove." # /playerhunt add [hunter/runner] help: |- /playerhunt team add hunter - Add a player to the hunter team /playerhunt team add runner - Add a player to the runner team # /playerhunt team team: # /playerhunt team view view: |- Hunters: %hunters% Runners: %runners% # /playerhunt team remove remove: success: "Removed %player% from the game." # Player tries to remove an offline player notFound: "A player with that name is not online!" # Player tries to remove while the countdown is progressing inCountdown: "You can't remove players during countdown!" help: "/playerhunt team remove - Remove a player from the game" # /playerhunt team clear clear: "Cleared all players from game." # /playerhunt team last last: "Set game players to the last game's players." # /playerhunt team help: |- /playerhunt team add hunter - Add a player to the hunter team /playerhunt team add runner - Add a player to the runner team /playerhunt team remove - Remove a player from the game /playerhunt team last - Set current team to players from previous game /playerhunt team clear - Remove all players /playerhunt team view - See the current teams help: |- /playerhunt team - Commands to manage teams (add or remove players) /playerhunt start - Start the game /playerhunt stop - Stop the game /playerhunt reload - Reload configuration and languages countdown: # Countdown to the start of the game in chat message: "Game starts in %time%s..." 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: "%time%" subtitle: "seconds left" fade-in: 3 stay: 20 fade-out: 3 gameStarted: title: "Player Hunt Started!" subtitle: "You are a %team%." fade-in: 10 stay: 80 fade-out: 10 gameEnded: title: "Player Hunt Ended!" subtitle: "The winner team was %team%." gameEndedAbrupt: title: "Player Hunt Ended!" subtitle: "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: "There are no runners in your current world." # The compass is in cooldown cooldownMessage: type: ACTION_BAR content: "Compass in cooldown! Cannot use for %time%s." # The Compass is successfully used, and the direction updated message: type: ACTION_BAR content: "X: %x%, Z: %z%" gameStarted: |- Player Hunt Hunters: %hunters% Runners: %runners% 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: |- The player hunt game has ended. The %team% have won! Winners: %winners% Losers: %losers% ```

Implore Studios

Members

PlayerHunt