[!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.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

[!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.

<center>

🧱 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!

</center>

✨ 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

1. Download the plugin and drop it into your /plugins/ folder.
2. Ensure you have ProtocolLib and LibsDisguises installed (check the version matrix above!).
3. Restart your server to generate the configuration files.
4. Set the global coordinates using /bh setlobby and /bh setreturn.
5. 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.

<center> <sub>Lightweight and optimized for high-performance servers. To receive support, please register here first. https://gemini.google.com/gem/1eSVzr_adR9stNWTR_iKeb0xH3MiCl32l?usp=sharing then follow this link again