ChunkAnalyzer

A Paper, Spigot, and Bukkit plugin for Minecraft 1.21 - 26.3 that helps server administrators find and fix lag caused by loaded chunks.

What is it

ChunkAnalyzer scans loaded chunks and calculates a load score based on entities, tile entities, players, armor stands, redstone components, hoppers, updatable blocks, and light sources. It is built for server administrators who need to identify lag machines and heavy chunks without running a full profiler. The plugin works in the background, caches results, and exposes the data through an in-game GUI.

The main difference from generic server profilers is the chunk-level view. You can sort chunks by load, filter by world, see exact coordinates, and teleport directly to the chunk center. Lag machine detection uses explicit thresholds, so a chunk with more than 500 entities, more than 50 armor stands, more than 100 redstone blocks, or more than 20 hoppers is flagged.

Deep analysis is optional. When enabled, the plugin also scans for redstone blocks, hoppers, updatable blocks, and light sources. On servers with thousands of loaded chunks, disabling deep analysis reduces CPU usage. Data is stored in cache.yml, and background scanning runs in batches of 5 chunks per second with a 30-second cooldown per chunk.

Load scoring assigns 20 points per player, 1 point per non-player entity, 10 points per tile entity, and 2 points per armor stand. With deep analysis enabled, redstone blocks add 3 points, hoppers add 5 points, updatable blocks add 2 points, and light sources add 1 point.

Features

• Monitors loaded chunks for entities, players, tile entities, armor stands, redstone components, hoppers, updatable blocks, and light sources.
• Flags chunks as lag machines when thresholds are exceeded: >500 entities, >50 armor stands, >100 redstone blocks, or >20 hoppers.
• Provides a GUI menu with world filters for Overworld, Nether, and The End, pagination, load score colors, and click-to-teleport.
• Supports English and Russian translations out of the box. Additional languages can be added under messages in config.yml.
• Offers optional deep analysis for redstone, hoppers, updatable blocks, and light sources. Disable it for better performance on large servers.
• Caches chunk data in cache.yml to reduce redundant scans and keep the GUI responsive.
• Scans chunks in the background in batches of 5 per second, with a 30-second cooldown per chunk.
• Tracks entity spawns, despawns, teleports, and chunk load/unload events to keep data current.
• Allows configuration of scanning behavior, language, and display options.

Installation

1. Download the ChunkAnalyzer 1.0.0 JAR.
2. Place the JAR in your server's plugins folder.
3. Restart the server or load the plugin with a plugin manager.
4. Edit plugins/ChunkAnalyzer/config.yml to match your server.
5. Assign the chunkanalyzer.menu permission to administrators, for example through LuckPerms.

No additional dependencies are required.

Usage

Command	Permission	Description
/ca menu	chunkanalyzer.menu	Opens the chunk analysis GUI.

After opening the GUI, use the world filter buttons to focus on Overworld, Nether, or The End. Chunks are sorted by load score and color-coded: green for low, yellow or orange for medium, red for high, and magma for likely lag machines. Hover over a chunk item to see entity count, player count, tile entities, and, when deep analysis is enabled, redstone and hopper details. Click a chunk to teleport to its center at the highest safe Y level. A warning is shown for chunks flagged as lag machines.

Configuration

The plugin generates plugins/ChunkAnalyzer/config.yml. The most important settings are:

show-green-chunks: false
deep-analyze: true
language: en

messages:
  en:
    player_only: "This command is for players only!"
    usage: "Usage: /ca menu"
    teleport: "Teleported to chunk [%s, %s]"
    lag_machine_warning: "Warning: Possible lag machine at [%s, %s]"
    menu_title: "Chunk Analyzer - %d"
    world_overworld: "Overworld"
    world_nether: "Nether"
    world_the_end: "The End"
    button_previous: "Previous page"
    button_next: "Next page"
    button_current_world: "Current world"
    chunk_info: "Chunk [%s, %s]"
    world: "World: %s"
    coordinates: "Coordinates: %s, %s"
    entities: "Entities: %s"
    players: "Players: %s"
    tile_entities: "Tile Entities: %s"
    armor_stands: "Armor Stands: %s"
    redstone_blocks: "Redstone blocks: %s"
    hoppers: "Hoppers: %s"
    updatable_blocks: "Updatable blocks: %s"
    light_sources: "Light sources: %s"
    load_score: "Load score: %s"
    click_to_teleport: "Click to teleport"

  ru:
    player_only: "Эта команда только для игроков!"
    usage: "Использование: /ca menu"
    teleport: "Телепортирован в чанк [%s, %s]"
    lag_machine_warning: "Предупреждение: Возможная лаг-машина в [%s, %s]"
    menu_title: "Анализатор чанков - %d"
    world_overworld: "Верхний мир"
    world_nether: "Ад"
    world_the_end: "Энд"
    button_previous: "Предыдущая страница"
    button_next: "Следующая страница"
    button_current_world: "Текущий мир"
    chunk_info: "Чанк [%s, %s]"
    world: "Мир: %s"
    coordinates: "Координаты: %s, %s"
    entities: "Сущности: %s"
    players: "Игроки: %s"
    tile_entities: "Tile Entities: %s"
    armor_stands: "Armor Stands: %s"
    redstone_blocks: "Редстоун блоки: %s"
    hoppers: "Воронки: %s"
    updatable_blocks: "Обновляемые блоки: %s"
    light_sources: "Источники света: %s"
    load_score: "Оценка нагрузки: %s"
    click_to_teleport: "Нажмите для телепортации"

show-green-chunks controls whether low-impact chunks with a score of 50 or less are displayed. Default is false to focus on problematic chunks. deep-analyze enables scanning for redstone, hoppers, updatable blocks, and light sources. Disable it on servers with many loaded chunks. language selects the message set. Add new languages under messages and set language to the corresponding key.

Compatibility

• Minecraft: 1.21 - 26.3
• Platform: Paper, Spigot, Bukkit
• Java: any version supported by the server platform; no specific Java version is required

No known incompatibilities with other plugins or libraries.

Technologies

• Language: Java
• Platform API: Bukkit, Spigot, Paper
• Build: standard plugin JAR
• Key dependencies: none
• Storage: cache.yml for cached chunk data

License

This project is distributed under the GNU General Public License v3.0.