✈ LagWatch

LagWatch runs silently in the background recording your server health every second. When lag happens it alerts you automatically — no need to manually start a profiler while lag is already happening.

---

🔍 What it detects

• TPS drops — flags when your server drops below your threshold
• Lag machines — detects redstone clocks, hopper chains and entity farms causing lag
• Entity spikes — flags when entity counts suddenly jump
• Chunk hotspots — finds which chunks have the most entities

---

⚡ Features

• Always recording — 10 minute rolling buffer of server health
• Automatic incident detection — no need to be online when lag happens
• Lag machine detection — counts redstone signals, active blocks and entities per chunk
• Discord webhook alerts — instant notifications in your Discord when lag is detected
• Teleport to lag source — /blackbox tp <id> takes you directly to the lag machine
• Incident history — saves reports to disk so you can review them later
• Plugin task breakdown — see which plugins have the most background tasks
• In game alerts — warns all ops in chat when lag is detected
• Zero setup — works out of the box with sensible defaults

---

📋 Commands

Command	Description
/blackbox stats	Current server health
/blackbox incidents	List past lag incidents
/blackbox replay <id>	View snapshots from a lag event
/blackbox tp <id>	Teleport to the lag machine location
/blackbox hotspots	Chunks with most entities
/blackbox plugins	Plugin task breakdown
/blackbox alerts	Toggle in game alerts on or off
/blackbox reload	Reload config without restarting

---

⚙ Config

thresholds:
  min-tps: 14.0
  max-mspt: 100.0
  entity-spike-percent: 50

lagmachine:
  min-redstone-signals: 50
  min-active-blocks: 15
  min-entities: 30
  tps-threshold: 18.0

discord:
  enabled: false
  webhook-url: "YOUR_WEBHOOK_URL_HERE"
  notify-incidents: true
  notify-lagmachines: true

---

🖥 Requirements

• Paper 1.21.x
• Java 21

---

❓ Why not just use Spark?

Spark requires you to manually start a profiler while lag is happening. LagWatch is always recording so it captures what happened before, during and after a lag event automatically. Use both together for the best results.

---

💬 Support and suggestions

Join our Discord for support, bug reports and feature suggestions