
ChunkManager
Optimizes chunk loading to reduce server lag.
- Загрузки
- 10K
- Подписчики
- 28
- Обновлён
- 22 августа 2026 г.
- Лицензия
- MIT
Опубликован 24 июля 2024 г.
Description:
ChunkManager helps reduce lag by optimizing chunk loading and unloading. It dynamically adjusts the chunk loading radius, caches recently unloaded chunks, and monitors server performance to ensure smooth gameplay. Additionally, it offers advanced commands for chunk optimization and garbage collection to help maintain server performance.
Commands:
| Command | Description |
|---|---|
/cm |
Open GUI. |
/chunkstatus |
View performance stats. |
/chunkreload |
Reload the plugin configuration. |
/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. |
Permissions:
| Permission | Description |
|---|---|
chunkmanager.admin |
Allows access to all ChunkManager commands. |
How It Works:
- Dynamic Chunk Loading Radius: Adjusts based on server load to minimize unnecessary resource usage.
- Advanced Chunk Caching: Temporarily caches recently unloaded chunks for quick reloading, reducing memory churn.
- Performance Monitoring: Continuously monitors server performance and adjusts settings in real-time to maintain optimal TPS and memory usage.
- Chunk Optimization: Unloads chunks farthest from players to optimize performance.
- Garbage Collection: Triggers garbage collection to free up memory.
- Chunk Summary: Provides a detailed summary of loaded chunks, entities, and tile entities for each world.
- Configurable Settings: Easily adjust plugin settings via the config.yml file for tailored performance management.
Config.yml
# ChunkManager Configuration
# Radius of chunks around the player to preload
chunk-loading-radius: 3
# Cache expiration time in milliseconds
cache-expiration-time: 30000
# Maximum number of chunks to load per tick
max-chunks-to-load: 5
# Maximum size of the chunk cache
max-cache-size: 100
# Logging level
logging-level: INFO
Previews
Ченджлог
1.3.7Релиз26.1.1, 26.1.2, 26.2 · 22 августа 2026 г.
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
1.3.6Релиз26.1.1, 26.1.2, 26.2 · 20 июня 2026 г.
- 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 when it's installed, for more accurate decisions
- Entity limiter no longer mixes up chunks between worlds
1.3.5Релиз26.1, 26.1.1, 26.1.2 · 14 июня 2026 г.
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Релиз26.1, 26.1.1, 26.1.2 · 14 июня 2026 г.
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Релиз1.21.9, 1.21.10, 1.21.11 · 13 июня 2026 г.
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Релиз26.1, 26.1.1, 26.1.2 · 30 мая 2026 г.
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Релиз1.21.9, 1.21.10, 1.21.11 · 17 апреля 2026 г.
~ Added Folia Support ~ Neater Messages ~ Added Support for BlueMap and Dynmap
1.3.0Релиз1.21.9, 1.21.10, 1.21.11 · 1 апреля 2026 г.
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
/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
Комментарии
Загружаем…