ChunkManager

Name: ChunkManager
Availability: InStock
Author: Sueta

1.3.8

Optimizes chunk loading to reduce server lag.

·Plugin

Description Updates21 Version history21 Addons Discussion Reviews

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