Chunk Analyzer

!(https://cdn.modrinth.com/data/kJgPPmXk/images/e3b5326187178c7c7ec7a318dde55e12b245043b.png)

# ChunkAnalyzer

ChunkAnalyzer is a lightweight and efficient plugin for Minecraft servers running Spigot/Paper 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.

## ✨ Features

• ✅ Chunk Monitoring: Tracks entities, players, tile entities, armor stands, redstone components, hoppers, and more in loaded chunks.
• 🚨 Lag Machine Detection: Identifies problematic chunks with excessive entities (>500), armor stands (>50), redstone blocks (>100), or hoppers (>20).
• 📊 GUI Menu: Displays chunk data with load scores, world filters (Overworld, Nether, End), and clickable teleportation to inspect chunks.
• 🌍 Multi-Language Support: Includes English (`en`) and Russian (`ru`) translations, customizable via `config.yml`.
• 🔎 Deep Analysis Option: Scans for redstone, hoppers, updatable blocks, and light sources for detailed performance insights (toggleable).
• 💾 Data Caching: Persists chunk data in `cache.yml` for fast access and reduced server load.
• 🔄 Background Scanning: Scans chunks in batches of 5 every second, with a 30-second cooldown per chunk to minimize performance impact.
• 📡 Event Tracking: Monitors entity spawns, despawns, teleports, and chunk load/unload events for real-time accuracy.
• ⚙️ Configurable: Adjust scanning behavior, language, and display options in `config.yml`.

## 📜 Commands

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

## 🔍 Example Usage

• 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).
• Filter by World: Click the Overworld, Nether, or End buttons to focus on specific worlds.
• Inspect Details: Hover over a chunk item to see its entity count, player count, tile entities, and (if enabled) redstone/hopper details.
• Teleport: Click a chunk to teleport to its center (highest safe Y-level). Example message: Teleported to chunk .
• Identify Lag: Chunks flagged as lag machines show a warning: Warning: Possible lag machine at .

## ⚙️ Configuration

The plugin generates a `config.yml` file in `plugins/ChunkAnalyzer` with the following settings:

```yaml 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: "Нажмите для телепортации" ```

### Key Settings

• show-green-chunks: Set to `true` to display low-impact chunks (score ≤ 50). Default: `false` to focus on problematic chunks.
• deep-analyze: Enable (`true`) to scan for redstone, hoppers, updatable blocks, and light sourc