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.]