ChunkManager

Quick rating

Community listing page, reviews here may not be monitored by the author.

How listings work Are you the author?

ChunkManager

By TheeCobraOwner

No reviews yet

Optimizes chunk loading to reduce server lag.

Mod Loaders
Minecraft
26.2
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

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