🐺 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

# 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.