# **Tracer** - _Chunk Lag 可视化插件_
Tracer 帮助服务器管理员通过粒子效果、动作栏消息和详细分析报告来可视化区块滞后，从而识别性能瓶颈。
## 它能做什么
这个插件扫描你的服务器区块，以查找导致滞后的区域。当它检测到问题时，它会使用彩色粒子和有用的消息准确地告诉你问题的所在。然后，你可以直接传送到这些问题区域进行修复。
## 主要功能
视觉反馈
- 粒子效果用不同的颜色突出显示滞后区块
- 动作栏显示实时性能数据
- 问题区域周围的区块边界会变得可见
- 悬浮文本显示详细的滞后信息
智能分析
- 统计实体、瓦片实体和红石组件
- 将滞后分为低、中、高和严重级别
- 缓存结果以避免重复扫描
- 以异步方式运行以防止服务器冻结
灵活的扫描
- 扫描你周围的特定半径（1-20 个区块）
- 运行服务器范围内的扫描以检查所有内容
- 设置自动后台扫描
- 需要时进行手动扫描
轻松导航
- 点击传送到任何滞后区块
- 分页浏览结果
- 如果你知道坐标，直接跳转到坐标
## 命令 基本命令：
- /tracer scan - 扫描你周围的区块
- /tracer scan 10 - 以每个方向 10 个区块为单位进行扫描
- /tracer scan server - 扫描整个服务器
- /tracer toggle - 开启/关闭可视化
- /tracer teleport - 浏览并传送到滞后区块
- /tracer info - 显示插件状态
- /tracer stats - 显示扫描统计信息
自动扫描：
- /tracer autoscan enable - 启动自动扫描
- /tracer autoscan disable - 停止自动扫描
- /tracer autoscan interval 60 - 设置扫描间隔（30, 60, 120, 300 或 600 秒）
- /tracer autoscan server enable - 启用服务器范围内的自动扫描
- /tracer autoscan server interval 30 - 设置服务器扫描间隔（5-120 分钟）
实用命令：
- /tracer clear cache - 清除分析缓存
- /tracer clear stats - 清除统计信息
- /tracer clear all - 清除所有内容
- /tracer reload - 重新加载配置
- /tracer debug on - 启用调试模式
- /tracer help - 显示命令帮助
## 要求
- PaperMC 1.21 或更高版本
- Java 21
## 快速开始
1. 将插件放入你的 plugins 文件夹
2. 重启你的服务器
3. 给予自己权限: tracer.scan , tracer.toggle , tracer.teleport (或 simplement 操作员)
4. 运行 /tracer scan 5 来测试一下
5. 使用 /tracer toggle 查看视觉效果
6. 使用 /tracer teleport 导航到问题区域
该插件包含智能默认设置，并且不会影响你的服务器性能。所有扫描都在后台进行，你可以根据需要调整其运行频率。
_服务器范围内的自动扫描默认禁用，可以通过 /tracer autoscan server enable 启用。_