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 Block Guard 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

1. Drop BlockGuard.jar into your plugins/ folder.
   
   
2. Edit config.yml to set your forbidden blocks and name/lore overrides.
   
   
3. Customize messages in messages.yml.
   
   
4. Restart or /bg reload.
   
   
5. Use /bg help to view available commands.

Block Guard 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!