Lag Detective

LagDetective

**Lag Detective is a lightweight Fabric diagnostics mod for Minecraft that helps you quickly understand why your game or server is lagging — without installing heavy profilers or complex tools.

It provides real-time performance monitoring, clear lag classification, and easy-to-read reports through simple commands and an optional client dashboard.**

What Lag Detective Does:

Lag Detective helps answer questions like:

• Is the lag coming from the server TPS or the client FPS?
• Are you CPU/tick bound, GPU/render bound, or memory/GC stuttering?
• Are too many entities loaded in one chunk?
• Is chunk loading or world generation causing spikes?
• What are the most likely causes right now?

Key Features:

Server Performance Tools:

• TPS and MSPT monitoring
• Entity and chunk activity tracking
• Server-side lag diagnosis
• Support report generation

Client Diagnostics Dashboard

• FPS + frame time monitoring
• Client tick time measurement
• Memory + GC spike detection
• Server metrics shown when available

Commands:

/ld status — server performance summary

/ld fps — current client FPS

/ld mspt — server tick time

/ld tps — server TPS estimate

/ld clientinfo — full client debug info

/ld serverinfo — full server debug info

/ld entity — chunk-by-chunk entity scan

/ld report — generate support report

/ld ui — open the diagnostics dashboard

Support Reports

Lag Detective can generate a complete diagnostic report for debugging or support requests:

• System + mod info
• Current TPS/FPS/MSPT
• Top lag causes with confidence scores
• Recommended actions
• Saved automatically as: lagdetective-report.txt

Designed for Safety & Compatibility

• Works on client + dedicated server
• No mixins required
• Lightweight sampling (default once per second)
• Never modifies other mods or game settings
• Suggestions are informational only

Perfect For:

• Server owners tracking TPS drops
• Modpack developers diagnosing performance
• Players experiencing stutters or frame lag
• Debugging mob farms, chunk loaders, or heavy mods

Lag Detective: Find the cause. Fix the lag. Play smoothly.