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