LaggyChunkFinder

🧭 LaggyChunkFinder

Find & fix the chunks that are killing your TPS.

---

✨ Features

* 📊 Spigot, Paper, Purpur, Folia – Shows the most lag-prone chunks by entities, tile entities, redstone * 🎯 Spigot, Paper, Purpur, Folia – Instantly jump to problem areas in-game * ⏱️ Spigot, Paper, Purpur, Folia – Runs on a timer, fully configurable * 📈 Spigot, Paper, Purpur, Folia – See scan status in real time * 🧠 Spigot, Paper, Purpur, Folia – Ranks lag chunks by severity * 🔄 Spigot, Paper, Purpur, Folia – 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:

* Click 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

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

---

🔐 Permissions

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

---

✅ Compatibility

* Java: 1.8 – 1.21+ * Java: Paper, Spigot, Purpur, Folia * Java: 17+

---

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