
ChunkManager
Optimizes chunk loading to reduce server lag.
- Загрузки
- 9K
- Подписчики
- 27
- Обновлён
- 20 июня 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.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
1.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 25 января 2026 г.
Added
- 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
Комментарии
Загружаем…