All Mods Resource Packs Data Packs Shaders Modpacks Plugins
ChunkManager

ChunkManager

by TheeCobra • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

Commands

Command Description
/cm Open GUI
/cm help List every command
/chunkstatus View performance stats
/chunkreload Reload config
/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
/cmtop Most expensive loaded chunks
/cminspect Why your current chunk is kept loaded
/cmfreeze <add\|remove\|list\|clear> Pin chunks so they never unload
/cmpregen <start\|stop\|status\|resume> [radius] Pre-generate chunks
/cmviz Chunk border particles coloured by heat
/cmrtps Per-region TPS (Folia)
/cmmap <refresh\|on\|off> Dynmap/BlueMap hot-chunk overlay

Permissions

Permission Description Default
chunkmanager.admin All commands op
chunkmanager.notify Performance notifications op
chunkmanager.bypass Never marked AFK, no loading limits false
chunkmanager.radius.1 to chunkmanager.radius.6 Per-rank preload radius false

Features

  • Heat-Based Unloading - Tracks activity, unloads cold chunks
  • Auto Performance Adjust - Adapts to TPS/RAM automatically
  • Chunk Prefetching - Predicts where players go, preloads chunks
  • Region Optimization - Optimizes areas based on activity
  • Smart Caching - Fast chunk reloading
  • Live Monitoring - TPS, memory, cache stats
  • Multi-Language - en, es, fr, de, pt, it, ru, ja, ko, zh, ar
  • Developer API - Hook into it from your plugins
  • World Blacklist - Exclude worlds you don't want managed
  • Folia Support - Runs on Folia, Paper, Spigot and Bukkit 1.20.4 - 1.21.x
  • AFK Saver - Idle players load fewer chunks, restored the moment they move
  • Entity Limiter - Per-chunk caps for mobs, animals and items, named and tamed always safe
  • Pre-Generation - TPS-aware, resumable, skips chunks that already exist
  • Frozen Chunks - Pin any chunk so it never unloads
  • Top Chunks & Analyzer - See which chunks cost the most and why
  • Region TPS - Per-region tick times on Folia
  • Map Overlay - Hot chunks drawn on Dynmap and BlueMap
  • Respects Other Plugins - Never unloads force-loaded chunks, plugin tickets, WorldGuard regions or a running Chunky
  • PlaceholderAPI - TPS, chunks, AFK and per-chunk values for scoreboards and tab lists

PlaceholderAPI

Values are cached once a second, so they are safe in scoreboards and tab lists.

Server placeholders
Placeholder Returns
%chunkmanager_tps% Current TPS
%chunkmanager_tps_color% TPS with a green/yellow/gold/red colour
%chunkmanager_tick% Tick time in ms
%chunkmanager_tick_p95% Tick time p95 over the last 5 minutes
%chunkmanager_status% EXCELLENT, GOOD, MODERATE, POOR or CRITICAL
%chunkmanager_platform% Folia, Paper, Spigot or Bukkit
%chunkmanager_memory_used% Used memory in MB
%chunkmanager_memory_max% Max memory in MB
%chunkmanager_memory_percent% Memory usage in percent
%chunkmanager_chunks% Loaded chunks across all worlds
%chunkmanager_world_chunks_<world>% Loaded chunks in one world
%chunkmanager_chunks_queue% Chunks waiting to load
%chunkmanager_chunks_loading% Chunks loading right now
%chunkmanager_loads_per_minute% Chunk loads in the last minute
%chunkmanager_unloads_per_minute% Chunk unloads in the last minute
%chunkmanager_culled% Entities removed by the limiter
%chunkmanager_frozen% Frozen chunks
%chunkmanager_radius% Current preload radius
%chunkmanager_maintenance% yes/no
%chunkmanager_afk_count% Players currently AFK
%chunkmanager_worst_region% Slowest region in ms (Folia)
%chunkmanager_pregen_active% yes/no
%chunkmanager_pregen_percent% Pre-generation progress
Player placeholders
Placeholder Returns
%chunkmanager_afk% yes/no
%chunkmanager_idle_seconds% Seconds since the player last moved
%chunkmanager_player_radius% The player's preload radius
%chunkmanager_bedrock% yes/no (Geyser)
%chunkmanager_chunk_x% Chunk X the player stands in
%chunkmanager_chunk_z% Chunk Z the player stands in
%chunkmanager_chunk_heat% Heat of that chunk
%chunkmanager_chunk_cost% Cost score of that chunk
%chunkmanager_chunk_entities% Entities in that chunk
%chunkmanager_chunk_tiles% Tile entities in that chunk
%chunkmanager_chunk_frozen% yes/no
Developer API

Setup

depend: [ChunkManager]

Get API

ChunkManagerAPI api = (ChunkManagerAPI) Bukkit.getPluginManager().getPlugin("ChunkManager");

Methods

// Basics
api.getCurrentRadius();
api.isMaintenanceMode();
api.setMaintenanceMode(true);

// Per-player
api.setPlayerRadius(player, 8);
api.getPlayerRadius(player);

// Stats
api.getAverageTickTime();
api.getMemoryUsagePercentage();
api.getLoadedChunksCount();

// Actions
api.forceChunkOptimization();
api.forceGarbageCollection();
api.reloadConfiguration();

// Async
api.getWorldStatistics(world); // returns CompletableFuture

// Extra
api.getCurrentTps();
api.isBedrockPlayer(player);
api.getQueuedChunksCount();
config.yml
chunk-loading-radius: 3
cache-expiration-time: 30000
max-chunks-to-load: 5
max-cache-size: 100
logging-level: INFO
language: en

afk:
  enabled: true
  idle-seconds: 300
  radius: 1
  view-distance: 0

entity-limiter:
  enabled: false
  total-limit: 100

spawn-chunks:
  radius: -1

Updated Previews:

Preview 1 Preview 2 Preview 3 Preview 4

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3 26.2 26.1.x +2
Bukkit Folia Paper Purpur Spigot
8h ago 1
26.2 26.1.x 1.21.x +1
Bukkit Folia Paper Spigot
8h ago 1
26.2 26.1.x 1.21.x +1
Bukkit Folia Paper Spigot
8h ago 1
26.2 26.1.x 1.21.x +1
Bukkit Folia Paper Spigot
8h ago 1
26.1.x 1.21.x 1.20.x
Bukkit Folia Paper Spigot
8h ago 1
26.1.x 1.21.x 1.20.x
Bukkit Folia Paper Spigot
8h ago 1
1.21.x 1.20.x
Bukkit Folia Paper Spigot
8h ago 1
26.1.x 1.21.x
Bukkit Folia Paper Spigot
8h ago 1
1.21.x
Bukkit Folia Paper Spigot
8h ago 1
1.21.x
Bukkit Folia Paper Spigot
8h ago 1
1.21.x 1.20.x
Bukkit Paper Spigot
8h ago 1
1.21.x 1.20.x
Bukkit Paper Spigot
8h ago 1
1.21.x 1.20.x
Bukkit Paper Spigot
8h ago 1
1.20.x
Bukkit Paper Spigot
8h ago 1
1.20.x
Bukkit Paper Spigot
8h ago 1
1.21 1.20.x
Bukkit Paper Spigot
8h ago 1
1.21 1.20.x
Bukkit Paper Purpur Spigot
8h ago 1
1.21 1.20.x
Paper Spigot
8h ago 1
1.20.x
Paper Purpur Spigot
8h ago 1
1.21 1.20.x
Bukkit Paper Spigot
8h ago 1
1.20.x
Bukkit Paper Spigot
8h ago 1
1.20.x
Bukkit Paper Spigot
8h ago 1
1.20.x
Bukkit Paper Spigot
8h ago 1
[1.4.0] ChunkManager 1.4.0 by TheeCobra on Oct 15, 2026
Download
  • New dialog menus on 1.21.6+: /cm now opens clean screens for settings, features, pre-generation and top chunks
  • Bedrock and older clients still get the chest menu, and /cm menu always opens it
  • Feature toggles now apply right away, no reload needed
  • The Smart Unloading toggle now actually works
  • Pre-generation can be started from the console, and big runs ask before starting
  • Teleporting to a top chunk now lands you somewhere safe
  • /chunkanalyze <world> checks a whole world, /chunkanalyze here checks your chunk
  • Help, status and analyzer messages are tidier and fully translated
  • Floodgate players are now detected as Bedrock
  • Tab completion only suggests what matches what you typed

[1.3.8] ChunkManager 1.3.8 by TheeCobra on Oct 15, 2026
Download
  • Full Folia support, plus Paper, Spigot and Bukkit on 1.20.4 to 1.21.x
  • Lighter on the server: no idle threads, capped background chunk loading
  • Pre-generation skips chunks that already exist
  • Entity limiter now catches busy chunks properly
  • New AFK saver: idle players load fewer chunks until they move
  • New spawn-chunks.radius option (1.20.5+)
  • Every message is now translated, with one clean style and a [CM] prefix
  • New /cm help command
  • Menus no longer flicker, and shift-click changes values by 5
  • Smoother on Spigot: chunk preloads are spread across ticks instead of stalling
  • /chunkmetrics shows loads per minute, culled entities and tick p95
  • PlaceholderAPI support: %chunkmanager_tps%, _chunks, _afk, _chunk_cost and more
[1.3.7] ChunkManager 1.3.7 by TheeCobra on Oct 15, 2026
Download
### 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] ChunkManager 1.3.6 by TheeCobra on Oct 15, 2026
Download
  • 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
[1.3.5] ChunkManager 1.3.5 by TheeCobra on Oct 15, 2026
Download
  • 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] ChunkManager 1.3.4 by TheeCobra on Oct 15, 2026
Download
  • 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] ChunkManager 1.3.3 by TheeCobra on Oct 15, 2026
Download
  • 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] ChunkManager 1.3.2 by TheeCobra on Oct 15, 2026
Download
  • 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] ChunkManager 1.3.1 by TheeCobra on Oct 15, 2026
Download
~ Added Folia Support
~ Neater Messages
~ Added Support for BlueMap and Dynmap
[1.3.0] ChunkManager 1.3.0 by TheeCobra on Oct 15, 2026
Download
# 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
[1.2.1] ChunkManager 1.2.1 by TheeCobra on Oct 15, 2026
Download
### 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
[1.2.0] ChunkManager 1.2.0 by TheeCobra on Oct 15, 2026
Download
### 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
[1.1.5] ChunkManager 1.1.5 by TheeCobra on Oct 15, 2026
Download
# 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
[1.1.3] ChunkManager 1.1.4 by TheeCobra on Oct 15, 2026
Download
# 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.1.3] ChunkManager 1.1.3 by TheeCobra on Oct 15, 2026
Download
Small Patch:
  • Removed "Safe Teleporting" causing issues.
[1.1.2] ChunkManager 1.1.2 by TheeCobra on Oct 15, 2026
Download
✅ 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)
[1.1.1] ChunkManager 1.1.1 by TheeCobra on Oct 15, 2026
Download
  • Fixed maintenance mode toggle bug
  • Improved config reload behavior
  • Enhanced UI display
  • Added auto-maintenance state persistence
  • Fixed state restoration during server restarts
[1.1.0] ChunkManager 1.1.0 by TheeCobra on Oct 15, 2026
Download
# 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.

[1.0.9] ChunkManager 1.0.9 by TheeCobra on Oct 15, 2026
Download
  • [+]** 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.
[1.0.8] ChunkManager 1.0.8 by TheeCobra on Oct 15, 2026
Download
  • [+]** 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.
[1.0.5] ChunkManager 1.0.5 by TheeCobra on Oct 15, 2026
Download
## 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.

[1.0.4] ChunkManager 1.0.4 by TheeCobra on Oct 15, 2026
Download
Release on modrinth, original post **[SpigtMC](https://www.spigotmc.org/resources/chunkmanager.118205/)**
ChunkManager Icon
Download ChunkManager
Select game version
Select platform