LaggyChunkFinder

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.