LagDetector

🛑⚡ LagDetector: Comprehensive Performance Profiling & Packet Analysis for Paper 1.21.1

LagDetector is a lightweight, low-level, high-impact performance toolkit designed for Paper Minecraft server administrators struggling to pinpoint the exact source of server degradation. While standard performance tools provide general overhead, LagDetector specializes in two distinct, real-time vectors of disruption: physical lag machines (redstone, entities, world bottlenecks) and malicious network packet-level exploits.

With a single command, LagDetector simultaneously generates two real-time diagnostic scores, instantly revealing precisely what is causing lag and where it is located.

🛡️ Core Dual-Layer Intelligence

🔍 Real-Time Diagnostics

LagDetector's unified /lagdetect command instantly analyzes and ranks the top bottlenecks across your entire server:

Vector A: World & Physical Bottlenecks (Lag Machines)

The plugin performs a deep vertical scan on every loaded chunk. It uses a heavily weighted scoring system (Projectiles > TNT > Hoppers/Pistons > Entities) to find hidden or optimized lag machine clusters:

• Redstone Clocks & Un-ticked Components (Dust, Repeaters, Comparators, Observers).
• Piston & Sticky Piston Automation.
• Item Drops, Mobs, Mobs, Projectiles (Snowball/Egg farms).

Vector B: Network & Packet Bottlenecks (Exploits)

LagDetector low-level intercepts the Netty channel adapter for every connection. When diagnostic mode is activated, it calculates the raw incoming data throughput rates. This instantly highlights users running exploit clients or macros designed to spam data to trigger server-wide desync, TPS drops, or client crashes:

• High-frequency offhand swapping.
• Data payload exploits (book exploits, complex map exploits).
• Packet flood/DDoS style macro-clicking.

⚡ Feature Summary

• Unified Diagnostics Command: One /lagdetect runs both scans instantly.
• Dual Weighted Scoring: Independent scoring for World Hotspots and Network rates.
• Real-time Throughput (p/s): View live packets-per-second per player.
• Click-to-Teleport: Hotspot coordinates in the chat report are interactive.
• Zero Dependencies: Designed for pure Paper 1.21.1. No external libraries, no heavy shading.

🚀 Getting Started

1. Installation: Place LagDetector-1.0.jar into your server's plugins/ directory.
2. Restart: (Self-injected packet hooks require a full restart or dynamic load).
3. Permission: Ensure you or your staff group have lagdetector.use.
4. Use: Run /lagdetect in-game when experiencing TPS degradation or desync to view the results.