Block Guard is a powerful all‑in‑one administration and anti‑grief tool for Minecraft 1.17, designed to help server operators enforce block placement rules and audit contraband items across player inventories and world containers.
Key Features
Unplaceable Block Prevention Define any number of forbidden blocks in your config.yml (e.g. COMMAND_BLOCK, BARRIER, TNT) and BlockGuard will silently cancel placement and notify the player.
Flexible Scanning & Searching
/bg search <player> <query>: Quickly search a specific player’s inventory or Ender Chest for any material or part of a custom display name.
/bg scan all [loaded|unloaded|all] <material|unplaceable>:
loaded — scan only currently loaded chunks
unloaded — load & scan chunks within the world border
all — both loaded and unloaded
<material> — search for a single block/item (e.g. DIAMOND_BLOCK)
unplaceable — search for everything in your forbidden‑block list
Comprehensive Container Support Scans all Container tile‑entities—chests, barrels, furnaces, hoppers, shulker boxes and more—ensuring no hidden contraband goes undetected.
Per‑Player & Container Logging Every match is logged to a per‑player YAML file (plugins/BlockGuard/founddata/<UUID>.yml) or a shared containers.yml, recording player/UUID, world coordinates, timestamp, and item details for easy auditing.
Item Name & Lore Customization Override display names and lore for any material via config.yml under blocks.edit.<MATERIAL>, automatically applied on /bg update or during scans—no in‑game commands required.
Fine‑Grained Permissions Toggle permission enforcement and assign:
blockguard.reload — reload config & messages
blockguard.update — apply name/lore updates
blockguard.search — inventory searches
blockguard.scan — world/container scans
blockguard.admin or blockguard.* — master permissions
Installation & Usage
Drop BlockGuard.jar into your plugins/ folder.
Edit config.yml to set your forbidden blocks and name/lore overrides.
Customize messages in messages.yml.
Restart or /bg reload.
Use /bg help to view available commands.
BlockGuard empowers you to enforce your server’s block rules, track down illicit items, and keep your world safe—all with a single, easy‑to‑configure plugin!