BeastHunt

🐺 BeastHunt

<!-- SUSTITUYE ESTE LINK POR TU BANNER CUANDO TENGAS UNO -->

<div align="center">

The ultimate frantic PvP minigame where Hunters chase Beasts across your maps. <br> Tag enemies, survive the clock, or fight off the infection.

</div>

---

📑 Table of Contents

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

---

✨ Features

| Feature | Description | | :--- | :--- | | ⚡ Smart Spec | Capture, Kill, Timed, and the new Smart Spec mode. | | 🌍 Smart Spec | Fully automated lobby and arena rotation system. | | 🔊 Smart Spec | Dynamic sound system: Beasts hear faster heartbeats as Hunters get closer. | | 🏹 Smart Spec | Configurable loadouts (Swords, Bows, Potions) per role. | | 🛠️ Smart Spec | Visual wands (`/bh tool`) to set spawns and objectives easily. | | 📊 Smart Spec | 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.* * 😈 Hunters: Must touch the Hunters: (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.* * 😈 Hunters: 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.* * 😈 Hunters: 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.* * Win Condition: Starts with one Hunter. When a Beast is caught or killed, Win Condition:. * Win Condition: Hunters win if everyone is infected. Beasts win if at least one survives.

---

🛠️ Setup & Installation

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

> 4. Save: `/bh tp <worldname>` > > 4. Save: `/bh tool spawns` > * 4. Save: Cycle spawn (Gold = Beast / Emerald = Hunter). > * 4. Save: Remove spawn. > > 4. Save: `/bh tool objective` > * 4. Save: Set Objective Token. > * 4. Save: 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

🚀 Pro Tips for Admins

> ❗ disable-features-in-worlds > 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.