This plugin requires dependencies to work: LibsDisguises and ProtocolLib
Please make sure you are using the correct dependency versions for your server version:
Minecraft 1.21 / 1.21.1 / 1.21.10:
ProtocolLib: Version 5.3.0 or newer (Latest Dev-builds #720+ recommended)
LibsDisguises: Version 11.0.18 or newer
Minecraft 1.20.x / 1.20.4:
ProtocolLib: Version 5.1.0 or newer
LibsDisguises: Version 10.0.44
⚠️ WARNING FOR GEYSER USERS: Geyser (Bedrock) players will not see the disguise correctly due to technical limitations and rendering engine constraints of the Bedrock client (it does not support smooth interpolation for bound falling block entities).
[HR][/HR]
BlockHunt (Classic Hide & Seek) Hide in plain sight! Blend in with the environment or hunt down the intruders!
✨ Features
Flawless Block Disguise: Players instantly transform into their chosen block using the powerful LibsDisguises API. They look exactly like real blocks to everyone else!
Solid Block System: If a block-player stands still for 4 seconds, the plugin automatically snaps them perfectly to the Minecraft block grid. Blend into the map seamlessly!
Custom Block Selector GUI: Administrators can configure a unique pool of available blocks for each individual arena. Selection is made via an intuitive custom menu.
Dynamic Scoreboard: The sidebar displays essential live game data: arena name, the player's current role, and the exact time remaining in the round.
⚔️ Gameplay Balance: Hunters spawn with iron gear right 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 in the configuration files.
️ Anti-Grief & Exploits Protection: Automatically blocks breaking/placing blocks, dropping items, and using external commands during an active match.
[HR][/HR]
Commands & Permissions
For Players:
/bh join [name] — Join the queue for a specific arena. (Permission: bh.player)
/bh leave — Leave the current game and return to the main spawn point. (Permission: bh.player)
For Administrators (Permission: bh.admin):
/bh create [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 [name] pos1 / pos2 — Set the physical boundaries of the arena map.
/bh [name] setspawn blocks — Set the spawn location for the Blocks team.
/bh [name] setspawn hunters — Set the spawn location for the Hunters team.
/bh [name] blocks add — Open the setup GUI for available arena blocks (just put blocks inside and click the Nether Star to save).
[HR][/HR]
️ Installation
[OL]
[*]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 files.
[*]Set the global coordinates using
/bh setlobby and
/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.
[/OL]
[HR][/HR]
Lightweight and optimized for high-performance servers. If you encounter any issues, please feel free to report them in the discussion section!