# \ud83d\udc3a BeastHunt<\/p>\n
<\/p>\n
\n
\n
\n<\/p>\n
**The ultimate frantic PvP minigame where Hunters chase Beasts across your maps.**
\n
\nTag enemies, survive the clock, or fight off the infection.<\/p>\n<\/div>\n
—<\/p>\n
## \ud83d\udcd1 Table of Contents
\n* [\u2728 Features](#-features)
\n* [\ud83c\udfae Game Modes](#-game-modes)
\n* [\ud83d\udee0\ufe0f Setup & Installation](#-setup–installation)
\n* [\ud83d\udcdc Commands & Permissions](#-commands–permissions)
\n* [\u2699\ufe0f Configuration](#-configuration)
\n* [\ud83d\ude80 Pro Tips](#-pro-tips-for-admins)<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
| Feature | Description |
\n| :— | :— |
\n| \u26a1 **4 Game Modes** | Capture, Kill, Timed, and the new **Infection** mode. |
\n| \ud83c\udf0d **Multi-World** | Fully automated lobby and arena rotation system. |
\n| \ud83d\udd0a **Heartbeat FX** | Dynamic sound system: Beasts hear faster heartbeats as Hunters get closer. |
\n| \ud83c\udff9 **Custom Kits** | Configurable loadouts (Swords, Bows, Potions) per role. |
\n| \ud83d\udee0\ufe0f **In-Game Editor** | Visual wands (`\/bh tool`) to set spawns and objectives easily. |
\n| \ud83d\udcca **Stats & Top** | Track Wins\/Kills and display a global Leaderboard. |
\n| \ud83d\udc40 **Smart Spec** | Late joiners get a Compass Menu to teleport to players instantly. |<\/p>\n
—<\/p>\n
## \ud83c\udfae Game Modes<\/p>\n
### \ud83d\udea9 1. Capture Mode
\n*Classic Tag with an objective.*
\n* \ud83d\ude08 **Beasts:** Must touch the **Objective Token** (Floating Diamond) hidden in the map.
\n* \u2694\ufe0f **Hunters:** Tag (hit) all Beasts before they reach the objective or time runs out.
\n* *Mechanic:* Beasts are frozen\/eliminated upon being hit.<\/p>\n
### \u2694\ufe0f 2. Kill Mode
\n*Traditional PvP Combat.*
\n* \ud83d\ude08 **Beasts:** Survive until the timer runs out. You can fight back!
\n* \u2694\ufe0f **Hunters:** Kill all Beasts. You have infinite lives.
\n* *Mechanic:* Standard combat rules apply.<\/p>\n
### \u23f3 3. Timed Mode
\n*Hide & Seek \/ Parkour Survival.*
\n* \ud83d\ude08 **Beasts:** Run, hide, and parkour. Survive until the timer hits `00:00`.
\n* \u2694\ufe0f **Hunters:** Catch all beasts before time is up.
\n* *Mechanic:* No objectives, pure movement and evasion.<\/p>\n
### \ud83e\udddf 4. Infection Mode (NEW!)
\n*One vs All. The swarm grows.*
\n* **The Goal:** Starts with one Hunter. When a Beast is caught or killed, **they become a Hunter**.
\n* **Win Condition:** Hunters win if everyone is infected. Beasts win if at least one survives.<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Setup & Installation<\/p>\n
1. **Download:** Drop the `BeastHunt.jar` into your `plugins` folder.
\n2. **Worlds:** Import your Lobby and Parkour worlds (ensure the folders are in the server root).
\n3. **Config:** Add your world names to `config.yml`.
\n4. **Setup Spawns (In-Game):**<\/p>\n
> **1. Teleport:** `\/bh tp —<\/p>\n ## \ud83d\udcdc Commands & Permissions<\/p>\n | Command | Arguments | Permission | Description | > \ud83d\udca1 **Tip:** Use `t:120` to force a match to last exactly 120 seconds. —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n “`yaml # Customize the equipment for Kill\/Infection modes # Visuals & UI # Immersion settings # Nametags (Above Head) ## \ud83d\ude80 Pro Tips for Admins<\/p>\n > \u2757 **TAB \/ Velocity Users** > \ud83d\udee1\ufe0f **Void Respawn** > \ud83c\udfc3 **Lobby Parkour** This project is licensed under the MIT License.<\/p>\n","protected":false},"excerpt":{"rendered":" The ultimate frantic PvP minigame where Hunters chase Beasts across your maps. Tag enemies, survive the clock, or fight off the infection.<\/p>\n","protected":false},"featured_media":26728,"template":"","meta":{"_minecraft_slug":"beasthunt","_minecraft_project_id":"Rd4cVjyn","_minecraft_author":"lasolucionoptima","_minecraft_license":"MIT","_minecraft_downloads":15,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"beasthunt.zip","_minecraft_size_bytes":90068,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:50:24.926745Z","_minecraft_date_created":"2026-01-25T04:54:32.508522Z","_minecraft_date_modified":"2026-01-25T01:48:17.928111Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/beasthunt","_minecraft_icon_attachment_id":26728,"_minecraft_imported_at":"2026-06-01T10:02:40+00:00","_minecraft_import_hash":"1ae78d57c61660f5fbc318857360c827","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,866,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-26727","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-minigame","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n>
\n> **2. Spawn Tool:** `\/bh tool spawns`
\n> * **Left Click:** Cycle spawn (Gold = Beast \/ Emerald = Hunter).
\n> * **Right Click:** Remove spawn.
\n>
\n> **3. Objective Tool:** `\/bh tool objective`
\n> * **Left Click:** Set Objective Token.
\n> * **Right Click:** Remove it.
\n>
\n> **4. Save:** Just type `\/bh stop` or leave.<\/p>\n
\n| :— | :— | :— | :— |
\n| `\/bh capture` | `[num] [t:sec]` | `beasthunt.use` | Start Capture match. |
\n| `\/bh kill` | `[num] [t:sec]` | `beasthunt.use` | Start Kill match. |
\n| `\/bh infection` | `[num] [t:sec]` | `beasthunt.use` | Start Infection match. |
\n| `\/bh countdown` | `[seconds]` | `beasthunt.use` | Start Timed match. |
\n| `\/bh stop` | – | `beasthunt.stop` | Force stop game. |
\n| `\/bh tool` | `
\n| `\/bh teleport` | `
\n| `\/bh stats` | – | `beasthunt.stats` | View personal stats. |
\n| `\/bh top` | – | `beasthunt.stats` | View Leaderboard. |<\/p>\n
\n> *Example:* `\/bh infection t:60`<\/p>\n\ud83d\udcc4 Click to view full config.yml<\/b><\/summary>\n
\n# Define your maps here
\nparkour-worlds:
\n – world: “map_forest”
\n weight: 10<\/p>\n
\nkits:
\n hunter:
\n – “DIAMOND_SWORD”
\n – “BOW”
\n – “ARROW:10”
\n beast:
\n – “IRON_SWORD”
\n – “SPEED_POTION”<\/p>\n
\nscoreboard:
\n enabled: true
\n lines:
\n show-mode: true
\n show-time: true<\/p>\n
\nheartbeat:
\n enabled: true
\n max-distance: 20 # Distance blocks to start hearing the beat<\/p>\n
\nnametags:
\n hunter-prefix: “&a&lHUNTER &a”
\n beast-prefix: “&c&lBEAST &c”
\n “`
\n<\/details>\n
\n> 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).<\/p>\n
\n> 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.<\/p>\n
\n> 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!
\n## \u2696\ufe0f License<\/p>\n