?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
LagDetector

LagDetector

a simple plugin that adds /lagdetect command to let you see lag sources in your server

0
0
0
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Tags

Creators

Details

Licensed CC-BY-NC-4.0
Published 4 days ago

🛑⚡ 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

Standard Lag Monitors LagDetector
Checks general TPS/MSPT only. Checks physical world bottlenecks and incoming raw network packet traffic simultaneously.
Vague; points to "entities." Scans every loaded chunk and every connected player pipeline for specific mathematical hotspots.
Cannot see desync/crash-exploits. Hooks directly into the Netty pipeline to find hidden packet-spam, offhand swaps, desync tools, and crash attempts based on actual network throughput.

🔍 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.