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

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

# 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