#🧹 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:
[Optional: Add a logo/banner image for the host here if Modrinth allows.]
