xClearBlocks

#🧹 ClearBlock: Scheduled Region Clearing for Spigot/Paper

ClearBlock is an essential maintenance plugin designed for survival, creative, or resource servers that rely on fixed areas (like build plots or mining worlds) staying clean and lag-free.

It utilizes the power of WorldGuard to precisely target and remove specific blocks and dropped items on a set schedule, ensuring a pristine environment for your players without constant manual intervention.

✨ Features

WorldGuard Integration: Target a specific ProtectedRegion ID defined in your WorldGuard setup. Only blocks and items inside this region are scanned and cleared.

Asynchronous Scanning: The heavy task of scanning thousands of blocks runs asynchronously (on a separate thread) to prevent server main thread lag, maintaining smooth gameplay.

Configurable Block Clearing: Specify a list of blocks (e.g., COBWEB, WATER, LAVA, GRAVEL) that will be instantly cleared.

Dropped Item Removal: Toggle a configuration option (clear-items-enabled: true) to automatically remove all dropped org.bukkit.entity.Item entities within the target region.

Scheduled Warnings: Players receive configurable, synchronized chat warnings 30 seconds before the clear event starts, giving them time to secure their items and avoid confusion.

Configurable Interval: Set the clear interval in Minecraft Ticks (e.g., 72000 ticks = 1 hour).

⚙️ Installation & Setup

Requirements

Spigot/Paper/BukkitTacoSpigot (1.18+)

WorldGuard (v7.0.9 or newer recommended)

WorldEdit (v7.2.14 or newer recommended)

Configuration (config.yml)

Stop your server.

Place the xClearBlock.jar in your plugins/ folder.

Start the server once to generate the default config.yml, then stop it again.

Edit the configuration:

# The list of materials (blocks) to clear. Use ALL CAPS names.
blocks-to-clear: 
  - COBWEB
  - LAVA
  - WATER

# The ID of the WorldGuard region that should be scanned and cleared.
# THIS MUST BE A REGION YOU HAVE PRE-DEFINED!
target-region-id: my_clearing_region 

# Set to true to clear all dropped items (org.bukkit.entity.Item) within the region.
clear-items-enabled: true

# How often the clearing task should run, in Minecraft Ticks.
# 72000 Ticks = 1 hour
clear-interval-ticks: 1200

Start your server. The plugin will announce its successful enablement in the console.

💖 Brought to you by Xaso Studios!

This project is proudly supported by Phyntra Host.

If you're looking for incredibly fast, lag-free hosting to run your large Spigot, Paper, or custom server with complex plugins like ClearBlock, check out their plans:

👉 [Phyntra Host]

[Optional: Add a logo/banner image for the host here if Modrinth allows.]