BeastHunt
The ultimate frantic PvP minigame where Hunters chase Beasts across your maps. Tag enemies, survive the clock, or fight off the infection.
🐺 BeastHunt
The ultimate frantic PvP minigame where Hunters chase Beasts across your maps.
Tag enemies, survive the clock, or fight off the infection.
📑 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
- Download: Drop the
BeastHunt.jarinto yourpluginsfolder. - Worlds: Import your Lobby and Parkour worlds (ensure the folders are in the server root).
- Config: Add your world names to
config.yml. - 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 stopor 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:120to 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.ymland 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.
