# 🧭 LaggyChunkFinder
**查找并修复导致你的 TPS 下降的区块。**
---
## ✨ 特性
* 📊 **实时区块排名** – 通过实体、方块实体、红石显示最容易卡顿的区块
* 🎯 **点击传送** – 立即传送到游戏中的问题区域
* ⏱️ **自动扫描** – 定时运行,完全可配置
* 📈 **扫描进度显示** – 实时查看扫描状态
* 🧠 **智能评分系统** – 根据严重程度对卡顿区块进行排名
* 🔄 **兼容旧版本** – 自动迁移旧的配置/数据
* 📁 无需数据库 — 只需要一个小的 `data.yml` 文件
* ✅ 与 **Spigot、Paper、Purpur、Folia** (MC 1.8–1.21) 兼容
---
## 🔧 指令
```
/laggychunks → 显示最卡顿的区块
/laggychunks 3 redstone → 显示第三个最严重的红石区块
/laggychunks fresh → 重新扫描所有已加载的区块
/laggychunks entities zombie → 根据僵尸数量查找卡顿区块
/laggychunks status → 显示扫描进度 + 统计信息
/laggychunks reload → 重新加载配置
```
🧠 **指令格式**:
`/laggychunks [fresh] [rank] [entities|redstone|tiles|status] [entityType]`
---
## 🖱️ 点击传送
输出中的所有区块坐标都是可点击的:
* **悬停** 以查看传送提示
* **点击** 以直接传送
* 仅适用于玩家
---
## 🎨 颜色代码
**卡顿得分**
* 🟢 0–50
* 🟡 51–200
* 🟠 201–500
* 🔴 501–1000
* 🟥 1000+
---
## ⚙️ 配置
编辑 `config.yml` 以进行调整:
* 扫描间隔(秒)
* 每个类别的得分权重
* 要考虑的区块半径
* 标签颜色和传送输出
*默认设置适用于大多数环境。*
---
## 📦 安装
```text
1. 将 jar 文件放入你的 plugins/ 文件夹中
2. 重启或运行 /reload
3. 使用 /laggychunks 开始跟踪卡顿
```
---
## 🔐 权限
```yaml
laggychunkfinder.use: true # 使用分析命令
laggychunkfinder.reload: op # 重新加载配置
```
---
## ✅ 兼容性
* **Minecraft**: 1.8 – 1.21+
* **服务器**: Paper, Spigot, Purpur, Folia
* **Java**: 17+
---
**保持你的服务器清洁、快速、并处于控制之下。**
*专为注重性能的管理人员设计。*