# PlayerHunt
PlayerHunt 是一个引人入胜的 Minecraft 插件，允许玩家参与一场刺激的狩猎游戏。猎人必须追踪并消灭逃跑者，而逃跑者必须躲避猎人并尝试击败末影龙来赢得游戏。
## 特性
- **团队管理：** 添加和管理猎人和逃跑者团队中的玩家。
- **猎人指南针：** 猎人会收到一个指向最近逃跑者的指南针。
- **倒计时器：** 游戏开始前可配置的倒计时器。
- **语言支持：** 可定制的语言消息，以定制游戏体验。
## 指令
### /playerhunt
用于管理 PlayerHunt 游戏的的主要指令。子指令包括：
- **/playerhunt start:** 启动带有倒计时器的游戏。
- **/playerhunt stop:** 立即停止游戏。
- **/playerhunt reload:** 重新加载插件的配置和语言文件。
- **/playerhunt team:** 管理与团队相关的操作。
### /playerhunt team
团队管理的子指令：
- **/playerhunt team add hunter ``:** 将玩家添加到猎人团队。
- **/playerhunt team add runner ``:** 将玩家添加到逃跑者团队。
- **/playerhunt team remove ``:** 从游戏中移除玩家。
- **/playerhunt team view:** 查看当前团队。
- **/playerhunt team clear:** 移除所有玩家从游戏中。
- **/playerhunt team last:** 将游戏玩家设置为上场游戏中的玩家。
## 配置
该插件使用 `config.yml` 文件来管理设置。主要的配置选项包括：
- **countdown:** 游戏开始前的倒计时时间。
- **compass:** 与猎人指南针相关的设置，包括冷却时间和显示选项。
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
```
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
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%
```