Description
Gallery
Changelog
Versions
Commands
| Command | Description |
|---|---|
/cm |
Open GUI |
/cm help |
List every command |
/chunkstatus |
View performance stats |
/chunkreload |
Reload config |
/optimizechunks |
Force chunk optimization |
/chunkgc |
Free up memory |
/chunksummary |
World analysis |
/maintenance <on\|off\|auto\|status> |
Toggle maintenance mode |
/chunklang <lang> |
Change language |
/chunkanalyze [world] |
Analyze chunk complexity |
/chunkregions |
Region stats |
/chunkmetrics |
Advanced metrics |
/cmtop |
Most expensive loaded chunks |
/cminspect |
Why your current chunk is kept loaded |
/cmfreeze <add\|remove\|list\|clear> |
Pin chunks so they never unload |
/cmpregen <start\|stop\|status\|resume> [radius] |
Pre-generate chunks |
/cmviz |
Chunk border particles coloured by heat |
/cmrtps |
Per-region TPS (Folia) |
/cmmap <refresh\|on\|off> |
Dynmap/BlueMap hot-chunk overlay |
Permissions
| Permission | Description | Default |
|---|---|---|
chunkmanager.admin |
All commands | op |
chunkmanager.notify |
Performance notifications | op |
chunkmanager.bypass |
Never marked AFK, no loading limits | false |
chunkmanager.radius.1 to chunkmanager.radius.6 |
Per-rank preload radius | false |
Features
- Heat-Based Unloading - Tracks activity, unloads cold chunks
- Auto Performance Adjust - Adapts to TPS/RAM automatically
- Chunk Prefetching - Predicts where players go, preloads chunks
- Region Optimization - Optimizes areas based on activity
- Smart Caching - Fast chunk reloading
- Live Monitoring - TPS, memory, cache stats
- Multi-Language - en, es, fr, de, pt, it, ru, ja, ko, zh, ar
- Developer API - Hook into it from your plugins
- World Blacklist - Exclude worlds you don't want managed
- Folia Support - Runs on Folia, Paper, Spigot and Bukkit 1.20.4 - 1.21.x
- AFK Saver - Idle players load fewer chunks, restored the moment they move
- Entity Limiter - Per-chunk caps for mobs, animals and items, named and tamed always safe
- Pre-Generation - TPS-aware, resumable, skips chunks that already exist
- Frozen Chunks - Pin any chunk so it never unloads
- Top Chunks & Analyzer - See which chunks cost the most and why
- Region TPS - Per-region tick times on Folia
- Map Overlay - Hot chunks drawn on Dynmap and BlueMap
- Respects Other Plugins - Never unloads force-loaded chunks, plugin tickets, WorldGuard regions or a running Chunky
- PlaceholderAPI - TPS, chunks, AFK and per-chunk values for scoreboards and tab lists
PlaceholderAPI
Values are cached once a second, so they are safe in scoreboards and tab lists.
Server placeholders
| Placeholder | Returns |
|---|---|
%chunkmanager_tps% |
Current TPS |
%chunkmanager_tps_color% |
TPS with a green/yellow/gold/red colour |
%chunkmanager_tick% |
Tick time in ms |
%chunkmanager_tick_p95% |
Tick time p95 over the last 5 minutes |
%chunkmanager_status% |
EXCELLENT, GOOD, MODERATE, POOR or CRITICAL |
%chunkmanager_platform% |
Folia, Paper, Spigot or Bukkit |
%chunkmanager_memory_used% |
Used memory in MB |
%chunkmanager_memory_max% |
Max memory in MB |
%chunkmanager_memory_percent% |
Memory usage in percent |
%chunkmanager_chunks% |
Loaded chunks across all worlds |
%chunkmanager_world_chunks_<world>% |
Loaded chunks in one world |
%chunkmanager_chunks_queue% |
Chunks waiting to load |
%chunkmanager_chunks_loading% |
Chunks loading right now |
%chunkmanager_loads_per_minute% |
Chunk loads in the last minute |
%chunkmanager_unloads_per_minute% |
Chunk unloads in the last minute |
%chunkmanager_culled% |
Entities removed by the limiter |
%chunkmanager_frozen% |
Frozen chunks |
%chunkmanager_radius% |
Current preload radius |
%chunkmanager_maintenance% |
yes/no |
%chunkmanager_afk_count% |
Players currently AFK |
%chunkmanager_worst_region% |
Slowest region in ms (Folia) |
%chunkmanager_pregen_active% |
yes/no |
%chunkmanager_pregen_percent% |
Pre-generation progress |
Player placeholders
| Placeholder | Returns |
|---|---|
%chunkmanager_afk% |
yes/no |
%chunkmanager_idle_seconds% |
Seconds since the player last moved |
%chunkmanager_player_radius% |
The player's preload radius |
%chunkmanager_bedrock% |
yes/no (Geyser) |
%chunkmanager_chunk_x% |
Chunk X the player stands in |
%chunkmanager_chunk_z% |
Chunk Z the player stands in |
%chunkmanager_chunk_heat% |
Heat of that chunk |
%chunkmanager_chunk_cost% |
Cost score of that chunk |
%chunkmanager_chunk_entities% |
Entities in that chunk |
%chunkmanager_chunk_tiles% |
Tile entities in that chunk |
%chunkmanager_chunk_frozen% |
yes/no |
Developer API
Setup
depend: [ChunkManager]
Get API
ChunkManagerAPI api = (ChunkManagerAPI) Bukkit.getPluginManager().getPlugin("ChunkManager");
Methods
// Basics
api.getCurrentRadius();
api.isMaintenanceMode();
api.setMaintenanceMode(true);
// Per-player
api.setPlayerRadius(player, 8);
api.getPlayerRadius(player);
// Stats
api.getAverageTickTime();
api.getMemoryUsagePercentage();
api.getLoadedChunksCount();
// Actions
api.forceChunkOptimization();
api.forceGarbageCollection();
api.reloadConfiguration();
// Async
api.getWorldStatistics(world); // returns CompletableFuture
// Extra
api.getCurrentTps();
api.isBedrockPlayer(player);
api.getQueuedChunksCount();
config.yml
chunk-loading-radius: 3
cache-expiration-time: 30000
max-chunks-to-load: 5
max-cache-size: 100
logging-level: INFO
language: en
afk:
enabled: true
idle-seconds: 300
radius: 1
view-distance: 0
entity-limiter:
enabled: false
total-limit: 100
spawn-chunks:
radius: -1
Updated Previews:

All Versions
+ Add Version
[1.4.0] ChunkManager 1.4.0
by TheeCobra on Oct 15, 2026
Download
- New dialog menus on 1.21.6+:
/cmnow opens clean screens for settings, features, pre-generation and top chunks - Bedrock and older clients still get the chest menu, and
/cm menualways opens it - Feature toggles now apply right away, no reload needed
- The Smart Unloading toggle now actually works
- Pre-generation can be started from the console, and big runs ask before starting
- Teleporting to a top chunk now lands you somewhere safe
/chunkanalyze <world>checks a whole world,/chunkanalyze herechecks your chunk- Help, status and analyzer messages are tidier and fully translated
- Floodgate players are now detected as Bedrock
- Tab completion only suggests what matches what you typed
[1.3.8] ChunkManager 1.3.8
by TheeCobra on Oct 15, 2026
Download
- Full Folia support, plus Paper, Spigot and Bukkit on 1.20.4 to 1.21.x
- Lighter on the server: no idle threads, capped background chunk loading
- Pre-generation skips chunks that already exist
- Entity limiter now catches busy chunks properly
- New AFK saver: idle players load fewer chunks until they move
- New
spawn-chunks.radiusoption (1.20.5+) - Every message is now translated, with one clean style and a
[CM]prefix - New
/cm helpcommand - Menus no longer flicker, and shift-click changes values by 5
- Smoother on Spigot: chunk preloads are spread across ticks instead of stalling
/chunkmetricsshows loads per minute, culled entities and tick p95- PlaceholderAPI support:
%chunkmanager_tps%,_chunks,_afk,_chunk_costand more
[1.3.7] ChunkManager 1.3.7
by TheeCobra on Oct 15, 2026
Download
### Performance
### Fixes
### Improvements
- Much lighter chunk cost tracking - scanning is now spread out instead of sweeping every loaded chunk at once
- Removed a per-tick scan that ran constantly and did nothing
- Chunk unloading no longer stalls the main thread
- Faster startup and shutdown, no more delay when stopping the server
- Chunk border particles are far cheaper on your client and network
- Lower memory use overall, especially on worlds with many loaded chunks
### Fixes
- Frozen chunks now genuinely stay loaded
- Entity limiter no longer removes tamed pets, villagers, leashed or named mobs, or item frames
- Portal preloading works on servers with custom world names
- Pre-generation saves progress as it runs, so a crash no longer loses your work
- Large pre-generation radii no longer spike memory on start
- Scheduled optimisation no longer skips its run time
- Menus open correctly on Folia
### Improvements
- The dynamic radius thresholds in config.yml now actually apply
- Entity limiter has new protected-types and protected-items lists
- Chunk tickets are now used to hold teleport destinations
- Messages support hex colours with &#RRGGBB
- The Nether and The End are no longer excluded by default
[1.3.6] ChunkManager 1.3.6
by TheeCobra on Oct 15, 2026
Download
- Fixed lag that slowly built up when players were online
- Fixed several memory leaks that dragged down performance on long uptimes
- Chunk pre-generation (
/cmpregen) now covers the whole area you ask for - Now reads TPS from [spark](https://modrinth.com/plugin/spark) when it's installed, for more accurate decisions
- Entity limiter no longer mixes up chunks between worlds
[1.3.5] ChunkManager 1.3.5
by TheeCobra on Oct 15, 2026
Download
- Fixes**
- Fixed a spam of errors in the console on Folia servers while smart unloading was running, and the same error when using **/cminspect**. The "is this chunk kept loaded" checks now run safely on Folia.
[1.3.4] ChunkManager 1.3.4
by TheeCobra on Oct 15, 2026
Download
- New**
- Plays nice with pre-generators** – ChunkManager no longer unloads chunks that Chunky, WorldBorder, /forceload or other plugins are keeping loaded, and it pauses its own unloading while a pre-gen is running so it doesn't undo the work.
- /cminspect** now also tells you when a chunk is held by another plugin or kept loaded because a pre-gen is running.
- Config**
- New **preloaded-chunks** section to fine-tune all of this (on by default).
[1.3.3] ChunkManager 1.3.3
by TheeCobra on Oct 15, 2026
Download
- New**
- Diagnostics menu** - see live TPS, memory, and your laggiest chunks and regions at a glance.
- Predictive Loading menu** - turn teleport and portal preloading on/off and change the radius, right in the GUI.
- Fixes**
- Fixed the chunk teleport menu messing with other menus - clicking around after a teleport no longer warps you.
- Fixed a slow memory leak from portal preloading.
- Feature toggles now take effect right away instead of needing a restart.
[1.3.2] ChunkManager 1.3.2
by TheeCobra on Oct 15, 2026
Download
- New**
- /cminspect** – tells you why the chunk you're standing in is staying loaded (frozen, ticket, WorldGuard, a nearby player, or /forceload).
- /cmpregen resume** – pre-generation now survives restarts. Pick up where it left off instead of starting from zero.
- The full GUI is now translated in all 11 languages (it was English-only before).
- Fixes**
- Fixed crashes and instability on Folia (smart unloading, region monitor, pre-gen).
- Fixed a chunk cache memory leak under heavy load.
- Fixed heatmap data being lost on restart in the Nether and End.
- Config**
- Thread count is now configurable (chunk-processor, 0 = auto).
- Added the missing region-tick-monitor and map-overlay options to config.yml.
[1.3.1] ChunkManager 1.3.1
by TheeCobra on Oct 15, 2026
Download
~ Added Folia Support
~ Neater Messages
~ Added Support for BlueMap and Dynmap
~ Neater Messages
~ Added Support for BlueMap and Dynmap
[1.3.0] ChunkManager 1.3.0
by TheeCobra on Oct 15, 2026
Download
# ChunkManager v1.3.0
## Compatibility
## New Features
## Improvements
## Compatibility
- Now fully supports Minecraft 1.21 - 1.21.11
- Updated WorldGuard integration for latest versions
- GeyserMC auto-detection for Bedrock players
## New Features
- Smart TPS throttling — automatically scales back operations when server is under load
- Entity limiter — keeps chunk entity counts in check to prevent lag
- Chunk load priority — players nearby get chunks loaded first
- Teleport & portal preloading — destination chunks load before you arrive
- Adaptive player loading — adjusts chunk radius based on player ping
- Chunk ticket system — keeps important chunks loaded efficiently
/cmtopcommand — see the top 10 most expensive chunks on your server- Features menu — toggle every new feature on/off in the GUI
## Improvements
- Improved message quality and color consistency across all commands
- 20+ command messages now fully translatable (11 languages supported)
- Arabic language support added
- Better region handling for negative coordinates
- Chunk visualizer updated for 1.21 particle changes
- Various thread safety and stability fixes
[1.2.1] ChunkManager 1.2.1
by TheeCobra on Oct 15, 2026
Download
### Added
### Improved
### Fixed
- Multiverse Support - Automatically detects Multiverse-Core and displays world aliases
- Per-World Settings - Configure each world independently with its own settings
- World Settings GUI - New menu to browse and configure all worlds
- World Edit Menu - Adjust radius, max chunks, safety radius, priority per world
- Heat Map Persistence - Chunk heat data now saves across restarts
### Improved
- Smart Unloading - Now respects per-world settings and priorities
- Maintenance Mode - Properly respects manual on/off state, won't auto-toggle when manually set
- Race Condition Fix - Chunk unloading now waits for completion before reporting count
- Memory Management - Better GC handling with configurable thresholds
- GUI Cooldown - Reduced click spam issues
### Fixed
- Maintenance mode staying off when manually disabled
- Duplicate chunk tracking causing memory bloat
- Smart unloader returning incorrect counts
- Memory threshold errors on some systems
[1.2.0] ChunkManager 1.2.0
by TheeCobra on Oct 15, 2026
Download
### Added
### Improved
- 1.20 to 1.21+ support
- Java 17
- Paper & Spigot compatible
- Faster async chunk loading on Paper
- GUI menu (/cm)
### Improved
- Memory management
- Chunk prediction
- Performance optimizations
- Updated dependencies
[1.1.7] ChunkManager v1.1.7 - Performance & Stability Update
by TheeCobra on Oct 15, 2026
Download
### Bug Fixes:
### Performance Improvements:
- Fixed:** Thread pool crash when adjusting core thread count
- Fixed:** Server freezes caused by indefinite chunk analysis operations
- Fixed:** NaN heat values breaking the smart chunk unloader
- Fixed:** Cache inconsistency preventing proper chunk cleanup
### Performance Improvements:
- Improved:** Memory leak from unused return values in batch operations
- Improved:** Overall plugin stability and resource management
[1.1.5] ChunkManager 1.1.5
by TheeCobra on Oct 15, 2026
Download
# Bug Fixes:
# Improvements:
- Fixed "Comparison method violates its general contract" error when players disconnect
- Improved chunk unloading stability
- Fixed ANSI color codes in console (reverted to avoid Bukkit warnings)
# Improvements:
- Better memory cleanup on player disconnect
[1.1.3] ChunkManager 1.1.4
by TheeCobra on Oct 15, 2026
Download
# Bug Fixes #
# Details #
- Fixed critical sorting issue that caused IllegalArgumentException: Comparison method violates its general contract! during chunk unloading operations
- The smart chunk unloader now captures heat values before sorting to ensure comparison consistency
- This prevents crashes that could occur when the server was processing chunk unload tasks
# Details #
- Resolved race condition in SmartChunkUnloader.identifyColdChunks() where volatile heat values could change during sort operations
- Improved stability of chunk management system under high load conditions
[1.1.3] ChunkManager 1.1.3
by TheeCobra on Oct 15, 2026
Download
Small Patch:
- Removed "Safe Teleporting" causing issues.
[1.1.2] ChunkManager 1.1.2
by TheeCobra on Oct 15, 2026
Download
✅ 1. Multi-threaded Chunk Processing
✅ 2. Chunk Teleportation Safety
✅ 3. Multi-language Support (10+ languages)
✅ 4. Smart Unloading Algorithm
Additional Improvements:
- Created ChunkProcessor with dynamic thread pool management
- Priority-based task queue (CRITICAL, HIGH, NORMAL, LOW)
- Automatic thread scaling based on workload
- Async chunk loading/unloading operations
✅ 2. Chunk Teleportation Safety
- Created TeleportationSafety component
- Pre-loads chunks before teleporting players
- Validates destination safety (no lava, fire, etc.)
- Fall damage protection after teleport
- Configurable timeout and radius
✅ 3. Multi-language Support (10+ languages)
- Created LanguageManager with 10 languages:
- English, Spanish, French, German, Portuguese
- Italian, Russian, Japanese, Korean, Chinese
- Added /chunklang command
- Auto-generates language files on first run
- Hot-swappable languages without restart
✅ 4. Smart Unloading Algorithm
- Created SmartChunkUnloader with heat map tracking
- Tracks player movement patterns and predicts chunk needs
- Heat decay system for intelligent unloading
- Protects important chunks (villagers, named entities)
- Priority-based unloading of "cold" chunks
Additional Improvements:
- Enhanced memory management with object pooling
- Added a API for plugin integration
- Enhanced config.yml with new feature settings (DELETE YOUR ON Config.yml)
[1.1.1] ChunkManager 1.1.1
by TheeCobra on Oct 15, 2026
Download
- Fixed maintenance mode toggle bug
- Improved config reload behavior
- Enhanced UI display
- Added auto-maintenance state persistence
- Fixed state restoration during server restarts
[1.1.0] ChunkManager 1.1.0
by TheeCobra on Oct 15, 2026
Download
# Changelog
### Enhancements
### Fixes & Improvements
### Enhancements
- Dynamic Radius Handling**: Improved and made configurable in the
config.ymlfile. - Maintenance Mode**: Automatically switches on/off based on performance thresholds.
### Fixes & Improvements
- Chunk Management**: Fully skips chunk management for blacklisted worlds, improving efficiency.
- Code Cleanup**: Reorganized and cleaned up the codebase for improved stability.
- Safety Checks**: Added new safeguards around chunk loading and unloading to prevent errors.
- Task Management**: Introduced graceful task cancellation during plugin shutdown.
[1.0.9] ChunkManager 1.0.9
by TheeCobra on Oct 15, 2026
Download
- [+]** Maintenance Mode: Introduced a new feature that lets you enable or disable a lower chunk loading radius for better performance.
- [/]** Made some side improvements for better functionality.
[1.0.8] ChunkManager 1.0.8
by TheeCobra on Oct 15, 2026
Download
- [+]** Enhanced /chunksummary command with detailed world info (total players, entities, etc.).
- [+]** Added support for 4 languages (English, Spanish, French, Chinese)
- [-]** Removed clearlag functionality. _(from version 1.0.7)
- [/]** Fixed asynchronous access issues by ensuring all Bukkit API calls run on the main thread.
[1.0.5] ChunkManager 1.0.5
by TheeCobra on Oct 15, 2026
Download
## Change Log for Version 1.0.5
- Added**
- New
/clearlagcommand to manually clear unnecessary entities. - Automatic entity clearing with customizable intervals.
- Countdown timer warnings before automatic clearing.
- Improved**
/optimizechunkslogic for more accurate chunk unloading.- Memory usage display to ensure accurate reporting.
- Message format for better clarity and professionalism.
[1.0.4] ChunkManager 1.0.4
by TheeCobra on Oct 15, 2026
Download
Release on modrinth, original post **[SpigtMC](https://www.spigotmc.org/resources/chunkmanager.118205/)**