LagDetector

# LagDetector **A professional server diagnostics plugin that scans your world for lag sources and displays them in a beautiful, interactive GUI with teleportation support.** ## Key Features * **Chunk Scanning:** Identifies chunks with high entity counts, tile entities, and redstone components. !(https://cdn.modrinth.com/data/cached_images/0c3a8bbad8ab19ad167c24983407f517d404a868.png) * **Interactive GUI:** Modern pastel-themed interface to browse and navigate to lag sources. !(https://cdn.modrinth.com/data/cached_images/3fb2149ee243ea7f82bfc25c63ce0ea9499d5d0a.png) * **Severity Levels:** Color-coded lag scores from low (green) to critical (red). !(https://cdn.modrinth.com/data/cached_images/53b6df3632b8ec0d4c202a40cc94a65f6bd41cf2.png) * **One-Click Teleport:** Instantly teleport to problematic chunks to investigate. * **Async Scanning:** Non-blocking scans that won't impact server performance. * **Multi-Language Support:** Fully translated in **English** and **German**. ## How It Works 1. Admin runs `/lagdetect scan` to scan all loaded chunks 2. Open the GUI with `/lagdetect gui` to view results 3. Browse by category: Entities, Tile Entities, or Redstone 4. Click on any chunk to teleport and investigate ## Commands & Permissions | Role | Command | Permission | | :--- | :--- | :--- | | Admin | `/lagdetect scan` | `lagdetector.scan` | | Admin | `/lagdetect gui` | `lagdetector.gui` | | Admin | `/lagdetect tp <chunk>` | `lagdetector.teleport` | | Admin | `/lagdetect report` | `lagdetector.report` | | Admin | `/lagdetect reload` | `lagdetector.reload` | | Admin | Receive notifications | `lagdetector.notify` | --- ## Detection Categories | Category | What It Detects | Default Warning | | :--- | :--- | :---: | | **Entities** | Mobs, items, armor stands, etc. | 50+ per chunk | | **Tile Entities** | Hoppers, furnaces, chests, etc. | 20+ per chunk | | **Redstone** | Repeaters, comparators, pistons | 30+ per chunk | ## Specific Entity Thresholds | Entity Type | Warning | Critical | | :--- | :---: | :---: | | Dropped Items | 30 | 60 | | TNT | 10 | 20 | | Minecarts | 15 | 30 | | Armor Stands | 25 | 50 | | Animals | 30 | 60 | | Monsters | 25 | 50 | --- ## Configuration Highlights ```yaml # Scan Settings scan: auto-scan-interval: 0 # seconds, 0 = disabled only-loaded-chunks: true async: true # Thresholds thresholds: entities: warning: 50 critical: 100 tile-entities: warning: 20 critical: 40 # Performance performance: chunks-per-tick: 50 cache-duration: 300 ``` --- ### Why Use This Plugin? 📊 **Identify Lag:** Find exactly which chunks are causing TPS drops 🎯 **Precise Location:** Get exact coordinates of problem areas 🚀 **Performance First:** Async scanning doesn't impact gameplay 🎨 **Beautiful GUI:** Modern, intuitive interface with severity colors --- ### Dependencies (optional) **We recommend installing LuckPerms** for a better permission management experience! ### Compatibility ✅ **Paper** 1.21.x ✅ **Folia** 1.21.x ✅ **Spigot** 1.21.x ### Support For bugs or support: https://discord.gg/Mkgz7YK7Y8