BeastHunt

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper

标签： game-mechanics minigame utility

? BeastHunt

---

? Table of Contents

• ✨ Features
• ? Game Modes
• ?️ Setup & Installation
• ? Commands & Permissions
• ⚙️ Configuration
• ? Pro Tips

---

✨ Features

Feature	Description
⚡ 4 Game Modes	Capture, Kill, Timed, and the new Infection mode.
? Multi-World	Fully automated lobby and arena rotation system.
? Heartbeat FX	Dynamic sound system: Beasts hear faster heartbeats as Hunters get closer.
? Custom Kits	Configurable loadouts (Swords, Bows, Potions) per role.
?️ In-Game Editor	Visual wands (/bh tool) to set spawns and objectives easily.
? Stats & Top	Track Wins/Kills and display a global Leaderboard.
? Smart Spec	Late joiners get a Compass Menu to teleport to players instantly.

---

? Game Modes

? 1. Capture Mode

Classic Tag with an objective.

• ? Beasts: Must touch the Objective Token (Floating Diamond) hidden in the map.
• ⚔️ Hunters: Tag (hit) all Beasts before they reach the objective or time runs out.
• Mechanic: Beasts are frozen/eliminated upon being hit.

⚔️ 2. Kill Mode

Traditional PvP Combat.

• ? Beasts: Survive until the timer runs out. You can fight back!
• ⚔️ Hunters: Kill all Beasts. You have infinite lives.
• Mechanic: Standard combat rules apply.

⏳ 3. Timed Mode

Hide & Seek / Parkour Survival.

• ? Beasts: Run, hide, and parkour. Survive until the timer hits 00:00.
• ⚔️ Hunters: Catch all beasts before time is up.
• Mechanic: No objectives, pure movement and evasion.

? 4. Infection Mode (NEW!)

One vs All. The swarm grows.

• The Goal: Starts with one Hunter. When a Beast is caught or killed, they become a Hunter.
• Win Condition: Hunters win if everyone is infected. Beasts win if at least one survives.

---

?️ Setup & Installation

1. Download: Drop the BeastHunt.jar into your plugins folder.
2. Worlds: Import your Lobby and Parkour worlds (ensure the folders are in the server root).
3. Config: Add your world names to config.yml.
4. Setup Spawns (In-Game):

1. Teleport: /bh tp <worldname>

2. Spawn Tool: /bh tool spawns

• Left Click: Cycle spawn (Gold = Beast / Emerald = Hunter).
• Right Click: Remove spawn.

3. Objective Tool: /bh tool objective

• Left Click: Set Objective Token.
• Right Click: Remove it.

4. Save: Just type /bh stop or leave.

---

? Commands & Permissions

Command	Arguments	Permission	Description
/bh capture	[num] [t:sec]	beasthunt.use	Start Capture match.
/bh kill	[num] [t:sec]	beasthunt.use	Start Kill match.
/bh infection	[num] [t:sec]	beasthunt.use	Start Infection match.
/bh countdown	[seconds]	beasthunt.use	Start Timed match.
/bh stop	-	beasthunt.stop	Force stop game.
/bh tool	<mode>	beasthunt.tool	Get editor wands.
/bh teleport	<world>	beasthunt.teleport	Admin TP to maps.
/bh stats	-	beasthunt.stats	View personal stats.
/bh top	-	beasthunt.stats	View Leaderboard.

? Tip: Use t:120 to force a match to last exactly 120 seconds.
Example: /bh infection t:60

---

⚙️ Configuration

? Click to view full config.yml ```yaml # Define your maps here parkour-worlds: - world: "map_forest" weight: 10 # Customize the equipment for Kill/Infection modes kits: hunter: - "DIAMOND_SWORD" - "BOW" - "ARROW:10" beast: - "IRON_SWORD" - "SPEED_POTION" # Visuals & UI scoreboard: enabled: true lines: show-mode: true show-time: true # Immersion settings heartbeat: enabled: true max-distance: 20 # Distance blocks to start hearing the beat # Nametags (Above Head) nametags: hunter-prefix: "&a&lHUNTER &a" beast-prefix: "&c&lBEAST &c" ```

? Pro Tips for Admins

❗ TAB / Velocity Users
If you use a TAB plugin and don't see the "HUNTER/BEAST" nametags, go to your TAB config.yml and add your game worlds to the disable-features-in-worlds list (specifically for nametags/teams).

?️ Void Respawn
Hunters have infinite lives! If they fall into the void, the plugin automatically teleports them to a safe Hunter spawn point to keep the action going.

? Lobby Parkour
Since players are in adventure mode with no hunger in the lobby, we recommend building a small parkour course to keep them entertained while waiting!

⚖️ License

This project is licensed under the MIT License.