<\/p>\n
# ChunkAnalyzer<\/p>\n
**ChunkAnalyzer** is a lightweight and efficient plugin for Minecraft servers running **Spigot\/Paper 1.16.x – 1.21.1**. It empowers server administrators to monitor and optimize server performance by analyzing loaded chunks for potential lag sources, such as high entity counts, redstone contraptions, or resource-intensive blocks. Featuring a user-friendly GUI, configurable settings, and multi-language support, ChunkAnalyzer is a must-have tool for maintaining a smooth and lag-free server experience.<\/p>\n
## \u2728 Features<\/p>\n
– \u2705 **Chunk Monitoring**: Tracks entities, players, tile entities, armor stands, redstone components, hoppers, and more in loaded chunks.
\n– \ud83d\udea8 **Lag Machine Detection**: Identifies problematic chunks with excessive entities (>500), armor stands (>50), redstone blocks (>100), or hoppers (>20).
\n– \ud83d\udcca **GUI Menu**: Displays chunk data with load scores, world filters (Overworld, Nether, End), and clickable teleportation to inspect chunks.
\n– \ud83c\udf0d **Multi-Language Support**: Includes English (`en`) and Russian (`ru`) translations, customizable via `config.yml`.
\n– \ud83d\udd0e **Deep Analysis Option**: Scans for redstone, hoppers, updatable blocks, and light sources for detailed performance insights (toggleable).
\n– \ud83d\udcbe **Data Caching**: Persists chunk data in `cache.yml` for fast access and reduced server load.
\n– \ud83d\udd04 **Background Scanning**: Scans chunks in batches of 5 every second, with a 30-second cooldown per chunk to minimize performance impact.
\n– \ud83d\udce1 **Event Tracking**: Monitors entity spawns, despawns, teleports, and chunk load\/unload events for real-time accuracy.
\n– \u2699\ufe0f **Configurable**: Adjust scanning behavior, language, and display options in `config.yml`.<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
| Command | Description | Permission |
\n|————–|—————————————|————————|
\n| `\/ca menu` | Opens the chunk analysis GUI. | `chunkanalyzer.menu` |<\/p>\n
## \ud83d\udd0d Example Usage<\/p>\n
– **Open the GUI**: Use `\/ca menu` to view a list of chunks, color-coded by load score (green for low, yellow\/orange\/red for medium\/high, magma for lag machines).
\n– **Filter by World**: Click the Overworld, Nether, or End buttons to focus on specific worlds.
\n– **Inspect Details**: Hover over a chunk item to see its entity count, player count, tile entities, and (if enabled) redstone\/hopper details.
\n– **Teleport**: Click a chunk to teleport to its center (highest safe Y-level). Example message: *Teleported to chunk [12, -34]*.
\n– **Identify Lag**: Chunks flagged as lag machines show a warning: *Warning: Possible lag machine at [12, -34]*.<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The plugin generates a `config.yml` file in `plugins\/ChunkAnalyzer` with the following settings:<\/p>\n
“`yaml
\nshow-green-chunks: false
\ndeep-analyze: true
\nlanguage: en<\/p>\n
messages:
\n en:
\n player_only: “This command is for players only!”
\n usage: “Usage: \/ca menu”
\n teleport: “Teleported to chunk [%s, %s]”
\n lag_machine_warning: “Warning: Possible lag machine at [%s, %s]”
\n menu_title: “Chunk Analyzer – %d”
\n world_overworld: “Overworld”
\n world_nether: “Nether”
\n world_the_end: “The End”
\n button_previous: “Previous page”
\n button_next: “Next page”
\n button_current_world: “Current world”
\n chunk_info: “Chunk [%s, %s]”
\n world: “World: %s”
\n coordinates: “Coordinates: %s, %s”
\n entities: “Entities: %s”
\n players: “Players: %s”
\n tile_entities: “Tile Entities: %s”
\n armor_stands: “Armor Stands: %s”
\n redstone_blocks: “Redstone blocks: %s”
\n hoppers: “Hoppers: %s”
\n updatable_blocks: “Updatable blocks: %s”
\n light_sources: “Light sources: %s”
\n load_score: “Load score: %s”
\n click_to_teleport: “Click to teleport”<\/p>\n
ru:
\n player_only: “\u042d\u0442\u0430 \u043a\u043e\u043c\u0430\u043d\u0434\u0430 \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u0438\u0433\u0440\u043e\u043a\u043e\u0432!”
\n usage: “\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435: \/ca menu”
\n teleport: “\u0422\u0435\u043b\u0435\u043f\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d \u0432 \u0447\u0430\u043d\u043a [%s, %s]”
\n lag_machine_warning: “\u041f\u0440\u0435\u0434\u0443\u043f\u0440\u0435\u0436\u0434\u0435\u043d\u0438\u0435: \u0412\u043e\u0437\u043c\u043e\u0436\u043d\u0430\u044f \u043b\u0430\u0433-\u043c\u0430\u0448\u0438\u043d\u0430 \u0432 [%s, %s]”
\n menu_title: “\u0410\u043d\u0430\u043b\u0438\u0437\u0430\u0442\u043e\u0440 \u0447\u0430\u043d\u043a\u043e\u0432 – %d”
\n world_overworld: “\u0412\u0435\u0440\u0445\u043d\u0438\u0439 \u043c\u0438\u0440”
\n world_nether: “\u0410\u0434”
\n world_the_end: “\u042d\u043d\u0434”
\n button_previous: “\u041f\u0440\u0435\u0434\u044b\u0434\u0443\u0449\u0430\u044f \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430”
\n button_next: “\u0421\u043b\u0435\u0434\u0443\u044e\u0449\u0430\u044f \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430”
\n button_current_world: “\u0422\u0435\u043a\u0443\u0449\u0438\u0439 \u043c\u0438\u0440”
\n chunk_info: “\u0427\u0430\u043d\u043a [%s, %s]”
\n world: “\u041c\u0438\u0440: %s”
\n coordinates: “\u041a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b: %s, %s”
\n entities: “\u0421\u0443\u0449\u043d\u043e\u0441\u0442\u0438: %s”
\n players: “\u0418\u0433\u0440\u043e\u043a\u0438: %s”
\n tile_entities: “Tile Entities: %s”
\n armor_stands: “Armor Stands: %s”
\n redstone_blocks: “\u0420\u0435\u0434\u0441\u0442\u043e\u0443\u043d \u0431\u043b\u043e\u043a\u0438: %s”
\n hoppers: “\u0412\u043e\u0440\u043e\u043d\u043a\u0438: %s”
\n updatable_blocks: “\u041e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u043c\u044b\u0435 \u0431\u043b\u043e\u043a\u0438: %s”
\n light_sources: “\u0418\u0441\u0442\u043e\u0447\u043d\u0438\u043a\u0438 \u0441\u0432\u0435\u0442\u0430: %s”
\n load_score: “\u041e\u0446\u0435\u043d\u043a\u0430 \u043d\u0430\u0433\u0440\u0443\u0437\u043a\u0438: %s”
\n click_to_teleport: “\u041d\u0430\u0436\u043c\u0438\u0442\u0435 \u0434\u043b\u044f \u0442\u0435\u043b\u0435\u043f\u043e\u0440\u0442\u0430\u0446\u0438\u0438”
\n“`<\/p>\n
### Key Settings<\/p>\n
– **show-green-chunks**: Set to `true` to display low-impact chunks (score \u2264 50). Default: `false` to focus on problematic chunks.
\n– **deep-analyze**: Enable (`true`) to scan for redstone, hoppers, updatable blocks, and light sources. Disable for better performance on large servers.
\n– **language**: Choose `en` (English), `ru` (Russian), or add custom languages under `messages`.<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the ChunkAnalyzer `.jar` from [SpigotMC\/Modrinth, if available].
\n2. Place the `.jar` in your server’s `plugins` folder.
\n3. Restart the server or load the plugin using a plugin manager.
\n4. Edit `config.yml` in `plugins\/ChunkAnalyzer` to customize settings.
\n5. Assign the `chunkanalyzer.menu` permission to admins (e.g., via LuckPerms).<\/p>\n
## \ud83d\udee0\ufe0f How It Works<\/p>\n
– **Background Scanner**: Scans 5 chunks per second, respecting a 30-second cooldown per chunk to avoid lag.
\n– **Load Scoring**:
\n – Players: 20 points each
\n – Non-player entities: 1 point each
\n – Tile entities: 10 points each
\n – Armor stands: 2 points each
\n – (With `deep-analyze`): Redstone blocks: 3 points, Hoppers: 5 points, Updatable blocks: 2 points, Light sources: 1 point
\n– **Lag Detection**: Flags chunks as lag machines if they exceed thresholds for entities, armor stands, redstone, or hoppers.
\n– **GUI**: Shows chunks sorted by score, with pagination and world filters. Chunks are color-coded (green\/yellow\/orange\/red\/magma) based on severity.
\n– **Caching**: Saves data to `cache.yml` to reduce redundant scans.<\/p>\n
## \ud83d\udca1 Admin Tips<\/p>\n
– Disable `deep-analyze` on servers with thousands of loaded chunks to reduce CPU usage.
\n– Prioritize magma-block chunks in the GUI, as they indicate severe lag risks.
\n– Use world filters to focus on high-traffic areas like the Overworld.
\n– Check the GUI during peak player times to catch lag sources early.<\/p>\n
## \ud83c\udf10 Adding Languages<\/p>\n
To add a new language (e.g., Spanish):
\n1. In `config.yml`, add a `messages.es` section.
\n2. Copy the `en` or `ru` messages and translate them.
\n3. Set `language: es`.<\/p>\n
Example:
\n“`yaml
\nmessages:
\n es:
\n player_only: “\u00a1Este comando es solo para jugadores!”
\n usage: “Uso: \/ca menu”
\n teleport: “Teletransportado al chunk [%s, %s]”
\n # … other translations
\n“`<\/p>\n
## \ud83d\udc1e Support & Issues<\/p>\n
If you have questions, bug reports, or feature requests, please contact: **mr_catcraft** on Discord. Please provide:
\n– Server version (e.g., Paper 1.20.4)
\n– Plugin version
\n– Description of the issue
\n– Relevant logs from `logs\/latest.log`<\/p>\n
## \u2699\ufe0f Technical Notes<\/p>\n
– **Dependencies**: None. Works with Spigot\/Paper 1.16.x – 1.21.1.
\n– **Performance**: Uses `ConcurrentHashMap` and `ConcurrentLinkedQueue` for thread safety. Batch scanning and cooldowns minimize impact.
\n– **Events**: Listens for entity spawns\/despawns, teleports, chunk load\/unload, and inventory clicks.
\n– **Storage**: Chunk data is cached in `cache.yml` for persistence.<\/p>\n","protected":false},"excerpt":{"rendered":"
See what chunk loads your server in one click!<\/p>\n","protected":false},"featured_media":40062,"template":"","meta":{"_minecraft_slug":"chunk-analyzer","_minecraft_project_id":"kJgPPmXk","_minecraft_author":"Mr_Catcraft","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":305,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chunk-analyzer.zip","_minecraft_size_bytes":25097,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:42:28.233930Z","_minecraft_date_created":"2025-06-18T11:33:40.374829Z","_minecraft_date_modified":"2025-06-15T22:56:39.612653Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chunk-analyzer","_minecraft_icon_attachment_id":40062,"_minecraft_imported_at":"2026-06-01T21:22:18+00:00","_minecraft_import_hash":"d742cc51451bcae5b30e2bded88ccc25","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,90,127,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[62,37],"class_list":["post-40061","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\n