Block Guard

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 : 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

— 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/.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., 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!