WorldChunkClear

# WorldChunkClear

WorldChunkClear is a lightweight Minecraft server plugin designed to clear chunks outside a custom polygon area.

It is useful for servers that need to prepare an island, map area, event zone, lobby, or protected region by removing unnecessary terrain around a defined polygon.

## Features

- Create custom polygon areas using multiple positions
- Supports multiple polygon points
- Clear chunks OUTSIDE the selected polygon
- Configurable chunk radius around the polygon
- Clear from world minimum height to maximum height
- Automatic backup before clearing
- Restore previously cleared blocks
- Layer-by-layer restoration
- Configurable blocks-per-tick for better server performance
- Progress percentage during Clear
- Progress percentage during Restore
- Configuration reload without restarting the server
- Backup files stored separately
- Designed to reduce server load during large operations

## Commands

/wcc pos1
Set the first polygon position.

/wcc pos2
Set the second polygon position.

/wcc pos3
Set the third polygon position.

/wcc set <number>
Set a specific polygon position.

/wcc list
Show all saved polygon positions.

/wcc info
Show information about the current polygon.

/wcc start clear
Start clearing chunks outside the polygon.

/wcc start back
Start restoring the previously cleared blocks.

/wcc reload
Reload the configuration without restarting the server.

/wcc cancel
Cancel the current operation.

## Configuration

The amount of chunks cleared around the polygon can be configured in config.yml.

Example:

chunk-radius: 5

You can also configure:

- Maximum blocks processed per tick
- Minimum Y
- Maximum Y
- Automatic backups
- Backup compression
- Messages
- World name

## Backup & Restore

Before clearing, WorldChunkClear can automatically create a backup of changed blocks.

When restoration is started, the plugin restores the saved blocks gradually instead of attempting to restore everything in a single server tick.

This helps reduce lag during large restore operations.

## Performance

WorldChunkClear provides a configurable blocks-per-tick option.

Example:

blocks-per-tick: 12000

Lower values reduce server load while higher values make the operation complete faster.

## Compatibility

Minecraft:
1.21.x

Platforms:
Spigot
Paper
Purpur

Java:
21+

## Permissions

worldchunkclear.admin

Allows access to WorldChunkClear administration commands.

## Important

Always keep a backup of your server before performing large world modification operations.

WorldChunkClear is designed to make large clearing and restoration operations safer, but server backups are still recommended.