PHPackages                             hazardteam/autoclearchunk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. hazardteam/autoclearchunk

ActiveProject[Utility &amp; Helpers](/categories/utility)

hazardteam/autoclearchunk
=========================

A PocketMine-MP plugin that automatically clears chunks in specified worlds at regular intervals.

3.0.2(12mo ago)703[1 issues](https://github.com/HazardTeam/AutoClearChunk/issues)[1 PRs](https://github.com/HazardTeam/AutoClearChunk/pulls)MITPHP

Since Apr 16Pushed 12mo ago1 watchersCompare

[ Source](https://github.com/HazardTeam/AutoClearChunk)[ Packagist](https://packagist.org/packages/hazardteam/autoclearchunk)[ RSS](/packages/hazardteam-autoclearchunk/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (5)Versions (5)Used By (0)

AutoClearChunk
==============

[](#autoclearchunk)

[![](https://camo.githubusercontent.com/68ca63f38d262f6e2b186af8b444fc622cf38774d6035e38e9bf20432743f945/68747470733a2f2f706f676769742e706d6d702e696f2f736869656c642e73746174652f4175746f436c6561724368756e6b)](https://poggit.pmmp.io/p/AutoClearChunk)[![](https://camo.githubusercontent.com/06b4451eaaab520b59dc7ce949deefcae3b30fc20ca4be6974553441b5abf95b/68747470733a2f2f706f676769742e706d6d702e696f2f736869656c642e646c2e746f74616c2f4175746f436c6561724368756e6b)](https://poggit.pmmp.io/p/AutoClearChunk)

A PocketMine-MP plugin that automatically clears chunks in specified worlds at regular intervals.

Features
========

[](#features)

- **Automated Chunk Management**: Automatically clears unloaded chunks in configured worlds to optimize server performance.
- **Flexible Scheduling**: Allows for a configurable interval to automatically clear chunks, adapting to your server's specific needs.
- **Graceful Unloading**: Includes a configurable grace period, ensuring chunks without players remain loaded for a specified duration before being considered for unloading.
- **Manual Control**: Provides commands to manually trigger chunk clearing for immediate action.
- **Customizable Player Feedback**: Offers configurable messages for different events, enhancing the player experience with clear notifications.
- **World Exclusion**: Supports a blacklist to exclude specific worlds from the automatic chunk clearing process.
- **Stay Up-to-Date**: Features an auto-update notifier to inform you of the latest plugin releases.

Default Config
==============

[](#default-config)

```
# AutoClearChunk Configuration

# Enable Auto-Schedule
# Determines whether the plugin automatically schedules the task to clear unloaded chunks at the specified interval.
# Set to 'true' to enable auto-scheduling, 'false' to disable.
enable-auto-schedule: true

# Clear Interval Duration
# Defines the time interval at which unloaded chunks are automatically cleared.
# The value should be specified in a duration format.
# Examples: 1h (1 hour), 30m (30 minutes), 15s (15 seconds)
clear-interval-duration: 5m30s

# Chunk Unload Grace Period Duration
# Specifies how long a chunk without players should wait before being considered for unloading.
# Set to "0s" to disable the grace period and unload instantly (reverts to old behavior).
# Examples: 30s, 5m, 1h
chunk-unload-grace-period-duration: "30s"

# Clear Chunk Message
# Message displayed when chunks are cleared using the /clearchunk command.
# Use %d as a placeholder for the number of cleared chunks and %s for the world name.
# Color codes are supported.
# Default: "&aSuccessfully cleared %d chunks in world %s"
clearchunk-message: "&aSuccessfully cleared %d chunks in world %s"

# Clear Chunk Broadcast Message
# Message broadcast to all players when chunks are cleared using the /clearchunk command.
# Use %d as a placeholder for the number of cleared chunks and %s for the world name.
# Color codes are supported.
# Default: "&e%d chunks have been cleared in world %s"
clearchunk-broadcast-message: "&e%d chunks have been cleared in world %s"

# Clear All Chunk Message
# Message displayed when chunks are cleared using the /clearallchunk command.
# Use %d as a placeholder for the number of cleared chunks.
# Color codes are supported.
# Default: "&aSuccessfully cleared %d chunks in all worlds"
clearallchunk-message: "&aSuccessfully cleared %d chunks in all worlds"

# Clear All Chunk Broadcast Message
# Message broadcast to all players when chunks are cleared using the /clearallchunk command.
# Use %d as a placeholder for the number of cleared chunks.
# Color codes are supported.
# Default: "&e%d chunks have been cleared in all worlds"
clearallchunk-broadcast-message: "&e%d chunks have been cleared in all worlds"

# Enable Broadcast Messages
# Set to 'true' to enable broadcasting messages to all players when chunks are cleared, 'false' to disable.
broadcast-message: true

# Blacklisted Worlds
# List of world names that will be excluded from the chunk clearing process.
# Add the exact names of any worlds you want to exclude.
# Default: []
blacklisted-worlds:
  - your_world
  - another_world
```

Configuration
=============

[](#configuration)

The plugin configuration file (`config.yml`) allows you to customize various aspects of the AutoClearChunk plugin. Here are the configurable options:

- `enable-auto-schedule` (boolean): Set this option to `true` if you want to enable the automatic chunk clearing schedule. If set to `false`, chunks will only be cleared manually using commands.
- `clear-interval-duration` (string): Specify the duration interval at which chunks should be cleared automatically. The duration should be specified in the format of `1h30m` for 1 hour and 30 minutes.
- `chunk-unload-grace-period-duration` (string): Defines how long a chunk without players should wait before being considered for unloading. Set to "0s" to disable the grace period and unload instantly. Examples: `30s, 5m, 1h`.
- `clearchunk-message` (string): Customize the message sent to players when chunks are cleared using the `/clearchunk` command.
- `clearchunk-broadcast-message` (string): Customize the message broadcasted to all players when chunks are cleared using the `/clearchunk` command.
- `clearallchunk-message` (string): Customize the message sent to players when chunks are cleared using the `/clearallchunk` command.
- `clearallchunk-broadcast-message` (string): Customize the message broadcasted to all players when chunks are cleared using the `/clearallchunk` command.
- `broadcast-message` (boolean): Set this option to `true` if you want to enable the broadcasting message when Chunk Cleared
- `blacklisted-worlds` (array): Specify a list of worlds to exclude from chunk clearing. Add world names as individual array items.

You can edit the `config.yml` file using a text editor to adjust the plugin's behavior, customize messages, and define the worlds where chunk clearing should be applied.

Commands
========

[](#commands)

The AutoClearChunk plugin provides the following commands for chunk clearing:

- `/clearchunk`: Clears all chunks in the current world. Players receive a notification message.
    - Permission: `autoclearchunk.command.clearchunk`
- `/clearallchunk`: Clears all chunks in all configured worlds. Players receive a notification message.
    - Permission: `autoclearchunk.command.clearallchunk`

Permissions
===========

[](#permissions)

To control access to the commands provided by the AutoClearChunk plugin, the following permissions are available:

- `autoclearchunk.command.clearchunk`: Allows players to use the `/clearchunk` command.
- `autoclearchunk.command.clearallchunk`: Allows players to use the `/clearallchunk` command.

Grant these permissions to specific player groups or individuals using a permissions management plugin of your choice.

Upcoming Features
=================

[](#upcoming-features)

- Currently none planned. You can contribute or suggest for new features.

Additional Notes
================

[](#additional-notes)

- If you find bugs or want to give suggestions, please visit [here](https://github.com/HazardTeam/AutoClearChunk/issues).
- We accept all contributions! If you want to contribute, please make a pull request in [here](https://github.com/HazardTeam/AutoClearChunk/pulls).
- Icons made from [icons8.com](https://icons8.com)

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance47

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 60% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~445 days

Total

2

Last Release

362d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/85402087?v=4)[Anang Adi](/maintainers/AIPTU)[@AIPTU](https://github.com/AIPTU)

---

Top Contributors

[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (87 commits)")[![AIPTU](https://avatars.githubusercontent.com/u/85402087?v=4)](https://github.com/AIPTU "AIPTU (35 commits)")[![XanderID](https://avatars.githubusercontent.com/u/55838823?v=4)](https://github.com/XanderID "XanderID (20 commits)")[![Endermanbugzjfc](https://avatars.githubusercontent.com/u/53002741?v=4)](https://github.com/Endermanbugzjfc "Endermanbugzjfc (2 commits)")[![poggit-bot](https://avatars.githubusercontent.com/u/22427965?v=4)](https://github.com/poggit-bot "poggit-bot (1 commits)")

---

Tags

pocketmine-mp-pluginpocketmine-plugins

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/hazardteam-autoclearchunk/health.svg)

```
[![Health](https://phpackages.com/badges/hazardteam-autoclearchunk/health.svg)](https://phpackages.com/packages/hazardteam-autoclearchunk)
```

###  Alternatives

[muqsit/invmenu

A PocketMine-MP virion to create and manage virtual inventories!

2225.4k1](/packages/muqsit-invmenu)[muqsit/simple-packet-handler

Handle specific data packets (virion for PMMP API 4.0.0)

417.8k4](/packages/muqsit-simple-packet-handler)[dktapps/pmforms

Form API library for PocketMine-MP plugins

532.6k1](/packages/dktapps-pmforms)[muqsit/asynciterator

A virion that simplifies writing tasks that traverse iterators

183.1k](/packages/muqsit-asynciterator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
