?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
BeastHunt

BeastHunt

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

21
0
21
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

View source

Tags

Creators

Details

Licensed MIT
Published 4 months ago

๐Ÿบ BeastHunt

Version Minecraft Software License

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

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.