🧭 LaggyChunkFinder

Find & fix the chunks that are killing your TPS.

---

✨ Features

• 📊 Live Chunk Ranking – Shows the most lag-prone chunks by entities, tile entities, redstone
• 🎯 Click-to-Teleport – Instantly jump to problem areas in-game
• ⏱️ Auto Scanning – Runs on a timer, fully configurable
• 📈 Scan Progress Display – See scan status in real time
• 🧠 Smart Scoring System – Ranks lag chunks by severity
• 🔄 Legacy-Friendly – Migrates old configs/data automatically
• 📁 No database needed — just a small data.yml
• ✅ Works with Spigot, Paper, Purpur, Folia (MC 1.8–1.21)

---

🔧 Commands

/laggychunks                  → Show most laggy chunk
/laggychunks 3 redstone       → Show 3rd worst redstone chunk
/laggychunks fresh            → Rescan all loaded chunks
/laggychunks entities zombie  → Find laggy chunk by zombie count
/laggychunks status           → Show scan progress + stats
/laggychunks reload           → Reload config

🧠 Command format: /laggychunks [fresh] [rank] [entities|redstone|tiles|status] [entityType]

---

🖱️ Click-to-Teleport

All chunk coordinates in output are clickable:

• Hover to see teleport hint
• Click to teleport directly
• Works for players only

---

🎨 Color Codes

Lag Score

• 🟢 0–50
• 🟡 51–200
• 🟠 201–500
• 🔴 501–1000
• 🟥 1000+

---

⚙️ Configuration

Edit config.yml to tweak:

• Scan interval (seconds)
• Score weights per category
• Chunk radius to consider
• Tag colors and teleport output

Defaults are fine for most setups.

---

📦 Installation

1. Drop the jar into your plugins/ folder  
2. Restart or run /reload  
3. Use /laggychunks to start tracking lag

---

🔐 Permissions

laggychunkfinder.use: true      # Use analysis commands
laggychunkfinder.reload: op     # Reload config

---

✅ Compatibility

• Minecraft: 1.8 – 1.21+
• Servers: Paper, Spigot, Purpur, Folia
• Java: 17+

---

Keep your server clean, fast, and under control. Built for performance-minded admins.