SkylexClear v1.0.0

SkylexClear — Description

SkylexClear is a lightweight yet powerful server utility plugin designed for Minecraft Java Edition 1.20 and 1.21. It combines two essential tools into one: an automatic entity cleaner (lag cleaner) and a region-based block removal system powered by a custom WorldGuard flag.


Automatic Entity Cleaner (Lag Cleaner)

Keep your server running smoothly by automatically removing ground entities at a configurable interval.

• Set any cleanup interval (default: every 5 minutes)
• Warns online players before each cleanup with fully customizable countdown messages (e.g. 60s, 30s, 10s, 5s warnings)
• Removes dropped items and/or hostile/passive mobs separately — your choice
• Spares named mobs (mobs with a name tag are never removed)
• Fully configurable entity exclusion list — protect villagers, horses, armor stands, pets, and more
• Disable entity clearing per world (e.g. disable in the End)
• All messages support & color codes

Region Block Auto-Removal (WorldGuard Integration)

Automatically remove specific blocks placed by players inside protected WorldGuard regions after a configurable delay.

- Register the custom WorldGuard flag skylex-clear on any region:
- /rg flag <region> skylex-clear allow → enables block removal in that region
- /rg flag <region> skylex-clear deny → disables it

• Each block material has its own configurable timer (e.g. cobwebs removed after 60s, TNT after 10s)
• Notifies the player who placed the block with a customizable message showing block type, time, and region name
• Optional particle effect when a block is removed
• Bypass permission for staff or builders who should not be affected
• Works only on player-placed blocks — natural generation is never touched

Commands

| Command | Description |
| /sclear reload | Reload the config without restarting |
| /sclear clear | Manually trigger an entity clear instantly |
| /sclear info | Show next clear countdown and active tracked blocks |

Aliases: /skylexclear, /sc

Permissions

| Permission | Description | Default |
| skylexclear.admin | Access to all commands | OP |
| skylexclear.notify | Receive cleanup countdown alerts | All players |
| skylexclear.bypass | Block placements are never tracked | Nobody |

Requirements

• Minecraft Java Edition 1.20 / 1.21
• Paper or Spigot
• WorldGuard 7.x + WorldEdit 7.x (optional — block removal feature requires it)

Fully Configurable

Every aspect of the plugin is controlled through a single well-documented config.yml:

• Cleanup interval and warning times
• Per-material block removal timers
• Excluded entity types
• Disabled worlds
• All chat messages with color code support
• WorldGuard flag default behavior