ChunkManager

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

- 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

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.

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).

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.

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.

~ Added Folia Support ~ Neater Messages ~ Added Support for BlueMap and Dynmap

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

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

Added

- 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

### Bug Fixes: - 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

Bug Fixes:

- 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

Bug Fixes #

- 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. Multi-threaded Chunk Processing - 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)

- Fixed maintenance mode toggle bug - Improved config reload behavior - Enhanced UI display - Added auto-maintenance state persistence - Fixed state restoration during server restarts

Changelog

Enhancements

- Dynamic Radius Handling: Improved and made configurable in the config.yml file. - 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.

[+] 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.

[+] 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.

Change Log for Version 1.0.5

Added - New /clearlag command to manually clear unnecessary entities. - Automatic entity clearing with customizable intervals. - Countdown timer warnings before automatic clearing. Improved - /optimizechunks logic for more accurate chunk unloading. - Memory usage display to ensure accurate reporting. - Message format for better clarity and professionalism.

Release on modrinth, original post [SpigtMC](https://www.spigotmc.org/resources/chunkmanager.118205/)