🐺 BeastHunt

📑 Table of Contents

• ✨ Features
• 🎮 Game Modes
• 🛠️ Setup & Installation
• 📜 Commands & Permissions
• ⚙️ Configuration
• 🚀 Pro Tips

✨ Features

🎮 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

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

⚙️ Configuration

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