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
~ Made Messages more neat
~ Added Heat mapping for BlueMap and Dynmap

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

Small Patch:

- Removed "safe teleporting" causing issues.

Might need to delete old config or update it!

Massive Changes Made:

# 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 OLD 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

[+] Added checks to fully skip chunk management for blacklisted worlds.
[+] Added new safety checks around chunk loading and unloading to prevent errors.
[/] Improved dynamic radius handling and made it configurable in the config file.
[/] Enhanced maintenance mode to automatically switch on and off based on performance thresholds.

[+] 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.
[/] Fixed asynchronous access issues by ensuring all Bukkit API calls run on the main thread.

Ensure to update your config file!

[+] Added /clearlag toggle command to enable or disable automatic clear lag.
[+] Added /clearlag history command to view a history of recent clear lag.
[+] Added /clearlag status command to display current clear lag settings and next scheduled clear time.
[/] Added auto-complete functionality for /clearlag command.
[/] Improved clear lag to be smoother by processing entities in smaller batches if necessary.

** Update your Config.yml **

[+] Added Configuration option to enable or disable informational messages.
[\] Improved Countdown timer warnings for clear lag to reduce spam.
[ \ ] Fixed Countdown timer to correctly display the next clear time in minutes and seconds.

[+] Added new /clearlag command to manually clear unnecessary entities.
[+] Implemented automatic entity clearing with customizable intervals.
[+] Added countdown timer warnings before automatic clearing.
[\] Enhanced memory usage display to ensure accurate reporting.
[\] Improved message format for better clarity and professionalism.

** Important update your config.yml **

[+] Added thread safety for shared resources
[\] Enhanced error handling and logging
[\] Improved asynchronous chunk operations
[\] Optimized caching logic
[\] Refined chunk loader and unloader tasks
[\] Enhanced dynamic radius adjustment
[\] Improved chunk summary layout for readability

[+] Added data collection /chunksummary
[\] Improved /optimizechunks logic for more accurate chunk unloading
[\] Enhanced memory usage display to ensure accurate reporting

[+] Added more detailed memory usage reporting in /chunkstatus command
[\] Enhanced /optimizechunks command for improved chunk optimization
[\] Improved /chunkgc command for accurate garbage collection
[\] Enhanced error handling in chunk load/unload tasks
[\] Improved performance monitoring and dynamic radius adjustment

[+] Added /optimizechunks command for chunk optimization
[+] Added /chunkgc command for garbage collection
[\] Enhanced chunk loading/unloading logic
[\] Improved cache management