ChunkManager
Optimizes chunk loading to reduce server lag.
Автор: TheeCobra12,1 тыс.32обновлён 2 окт. 2026 г.
УправлениеОптимизацияУтилиты
Описание
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:
Последние версии
Все версии →release
ChunkManager 1.4.0
1.4.02 окт. 2026 г.1,1 тыс.Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
- New dialog menus on 1.21.6+: `/cm` now opens clean screens for settings, features, pre-generation and top chunks
- Bedrock and older clients still get the chest menu, and `/cm menu` always 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 here` checks 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
release
ChunkManager 1.3.8
1.3.85 сент. 2026 г.636Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, spigot
Что нового
- 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.radius` option (1.20.5+)
- Every message is now translated, with one clean style and a `[CM]` prefix
- New `/cm help` command
- Menus no longer flicker, and shift-click changes values by 5
- Smoother on Spigot: chunk preloads are spread across ticks instead of stalling
- `/chunkmetrics` shows loads per minute, culled entities and tick p95
- PlaceholderAPI support: `%chunkmanager_tps%`, `_chunks`, `_afk`, `_chunk_cost` and more
release
ChunkManager 1.3.7
1.3.722 авг. 2026 г.395Minecraft: 1.20, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, spigot
Что нового
### Performance
- 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
release
ChunkManager 1.3.6
1.3.620 июн. 2026 г.1,7 тыс.Minecraft: 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, spigot
Что нового
- 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
release
ChunkManager 1.3.5
1.3.514 июн. 2026 г.192Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, folia, paper, spigot
Что нового
**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.
release
ChunkManager 1.3.4
1.3.414 июн. 2026 г.19Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, folia, paper, spigot
Что нового
**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).
release
ChunkManager 1.3.3
1.3.313 июн. 2026 г.49Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, spigot
Что нового
**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.
release
ChunkManager 1.3.2
1.3.230 мая 2026 г.371Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, folia, paper, spigot
Что нового
**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.
release
ChunkManager 1.3.1
1.3.117 апр. 2026 г.664Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, spigot
Что нового
~ Added Folia Support
~ Neater Messages
~ Added Support for BlueMap and Dynmap
release
ChunkManager 1.3.0
1.3.01 апр. 2026 г.365Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, spigot
Что нового
# ChunkManager v1.3.0
## 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
- `/cmtop` command — 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