Compatibility
Minecraft: Java Edition
1.21.x
Platforms
Links
Creators
Details
Licensed Apache-2.0
Published 2 weeks ago
Updated 2 weeks ago
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.

- Interactive GUI: Modern pastel-themed interface to browse and navigate to lag sources.

- Severity Levels: Color-coded lag scores from low (green) to critical (red).

- 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
- Admin runs
/lagdetect scanto scan all loaded chunks - Open the GUI with
/lagdetect guito view results - Browse by category: Entities, Tile Entities, or Redstone
- 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
# 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



