Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Licensed MIT
Published 2 days ago
[!IMPORTANT] This plugin requires mandatory dependencies to function: LibsDisguises and ProtocolLib
Please ensure you are using the correct dependency versions compatible with your server:
- Minecraft 1.21 / 1.21.1 / 1.21.10:
- ProtocolLib: Version
5.3.0or newer (Latest Dev-builds #720+ recommended)- LibsDisguises: Version
11.0.18or newer- Minecraft 1.20.x / 1.20.4:
- ProtocolLib: Version
5.1.0or newer- LibsDisguises: Version
10.0.44
[!CAUTION] โ ๏ธ WARNING FOR GEYSER/BEDROCK USERS: Geyser (Bedrock) players will not see the block disguises correctly due to technical limitations and rendering constraints of the Bedrock engine. The Bedrock client does not natively support smooth interpolation for bound falling block entities.
๐งฑ BlockHunt (Classic Hide & Seek)
Hide in plain sight! Blend in with the environment or hunt down the survivors! Transform your server into a thrilling arena of hide and seek. Become a block or lead a global hunt!
โจ Features
- ๐ฏ Flawless Block Disguise: Players instantly transform into their chosen block using the powerful LibsDisguises API. To everyone else, they look exactly like real blocks!
- ๐ฆ Solid Block System: If a block-player stands still for 4 seconds, the plugin automatically snaps them perfectly to the Minecraft block grid, allowing them to blend seamlessly into the map.
- ๐ Custom Block Selector GUI: Administrators can configure a unique pool of available blocks for each arena using an intuitive custom graphical interface.
- ๐ Dynamic Scoreboard: The sidebar displays essential live game statistics: arena name, the player's current role, and the exact time remaining in the round.
- โ๏ธ Gameplay Balance: Hunters spawn with iron gear at the start, while Blocks receive swords for self-defense only after a configurable delay (e.g., halfway through the round).
- ๐ Full Localization: Every single message, menu title, and UI element is fully customizable within the configuration files.
- ๐ก๏ธ Anti-Grief Protection: Automatically blocks breaking/placing blocks, dropping items, and executing external commands during an active match.
๐ฎ Commands
๐ฅ For Players:
/bh join [arena_name]โ Join the game queue for a specific arena./bh leaveโ Leave the current game and return to the main spawn.
๐ ๏ธ For Administrators:
/bh create [arena_name]โ Create a brand new arena./bh setlobbyโ Set the waiting lobby spawn point where players wait for the countdown./bh setreturnโ Set the exit spawn point where players are sent after the game ends./bh [arena_name] pos1 / pos2โ Set the physical boundaries of the arena map./bh [arena_name] setspawn blocksโ Set the spawn location for the Blocks team./bh [arena_name] setspawn huntersโ Set the spawn location for the Hunters team./bh [arena_name] blocks addโ Open the setup GUI for available arena blocks (put blocks inside and click the Nether Star to save).
๐ Permissions
bh.playerโ Grants access to basic player commands (/bh join,/bh leave) and allows participating in games. Recommended for all regular players.bh.adminโ Grants full access to all administrative setup commands, arena creation, and configuration management. Recommended for administrators/OPs.
๐ ๏ธ Installation
- Download the plugin and drop it into your
/plugins/folder. - Ensure you have ProtocolLib and LibsDisguises installed (check the version matrix above!).
- Restart your server to generate the configuration files.
- Set the global coordinates using
/bh setlobbyand/bh setreturn. - Create an arena, set up team spawns, configure allowed blocks via the GUI, and you are ready! Minimum players required to auto-start a match is 2.