ChunkManager icon

ChunkManager -----

Optimizes chunk loading to reduce server lag.



Description:
ChunkManager is an advanced performance optimization plugin that manages chunk loading to reduce lag. It features smart heat-based chunk unloading, dynamic radius adjustment, chunk prefetching, region optimization, and real-time performance monitoring. With multi language support and a developer API, it's the complete solution for chunk management.​

Commands:
/chunkstatus - Display current chunk management status and performance metrics
/chunkreload - Reload the plugin configuration
/optimizechunks - Force optimize loaded chunks
/chunkgc - Trigger garbage collection to free memory
/chunksummary - Generate detailed world analysis
/maintenance <on|off|auto|status> - Manage maintenance mode
/chunklang <language> - Change plugin language
/chunkanalyze [world] - Analyze chunk complexity and performance impact
/chunkregions - Display region optimization statistics
/chunkmetrics - View advanced performance metrics

Permissions:
chunkmanager.admin - Access to all ChunkManager commands

Key Features:
  • Smart Heat-Based Unloading: Tracks chunk activity and intelligently unloads cold chunks
  • Dynamic Performance Adjustment: Auto-adjusts radius and enters maintenance mode based on TPS/RAM
  • Chunk Prefetching: Predicts and preloads chunks based on player movement patterns
  • Region Optimization: Optimizes entire regions based on activity patterns
  • Advanced Caching: Multi-tier cache system for instant chunk reloading
  • Real-Time Monitoring: Tracks TPS, memory, cache hits/misses, and chunk metrics
  • Multi-Language Support: Supports multiple languages (configurable)
  • Developer API: Full API for integration with other plugins
  • World Blacklist: Exclude specific worlds from chunk management
Using ChunkManager API

Add ChunkManager as a dependency in your plugin.yml:
Code (Text):

  depend: [ChunkManager]
  # or
  softdepend: [ChunkManager]
 
Getting the API instance:
Code (Java):

  import cm.chunkManager.api.ChunkManagerAPI ;

  ChunkManagerAPI chunkAPI = (ChunkManagerAPI ) Bukkit. getPluginManager ( ). getPlugin ( "ChunkManager" ) ;
  if (chunkAPI != null ) {
      // Use the API
  }
 
Available Methods:
Code (Java):

  // Check if a world is blacklisted
  boolean isBlacklisted = chunkAPI. isWorldBlacklisted (world ) ;

  // Get current chunk loading radius
  int radius = chunkAPI. getCurrentRadius ( ) ;

  // Check/set maintenance mode
  boolean maintenance = chunkAPI. isMaintenanceMode ( ) ;
  chunkAPI. setMaintenanceMode ( true ) ;

  // Set custom radius for specific player
  chunkAPI. setPlayerRadius (player, 8 ) ;
  int playerRadius = chunkAPI. getPlayerRadius (player ) ;

  // Get performance metrics
  Map < String, String > perfInfo = chunkAPI. getPerformanceInfo ( ) ;
  double tickTime = chunkAPI. getAverageTickTime ( ) ;
  double memoryUsage = chunkAPI. getMemoryUsagePercentage ( ) ;

  // Get chunk statistics
  int loadedChunks = chunkAPI. getLoadedChunksCount ( ) ;
  int queuedChunks = chunkAPI. getQueuedChunksCount ( ) ;

  // Force optimizations
  chunkAPI. forceChunkOptimization ( ) ;
  chunkAPI. forceGarbageCollection ( ) ;

  // Get world statistics (async)
  CompletableFuture <WorldStatistics > stats = chunkAPI. getWorldStatistics (world ) ;

  // Reload configuration
  chunkAPI. reloadConfiguration ( ) ;
 

Code (YAML):

# 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

# Language setting
language
: en # Supported languages: en, es, fr, zh
 

Updated Previews:
[​IMG]
[​IMG]
[​IMG]
[​IMG]
Resource Information
Author:
----------
Total Downloads: 1,544
First Release: Jul 20, 2024
Last Update: Sep 13, 2025
Category: ---------------
All-Time Rating:
7 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings