# MCBenchmark
**MCBenchmark** 是一个先进的 Minecraft 服务器基准测试插件，旨在帮助服务器管理员分析和优化性能。它提供了一套可配置的、自适应的基准测试工具，用于实时诊断关键服务器系统——包括区块加载、实体、方块、瓦片实体、延迟和 TPS。
无论您是在调试卡顿、测试服务器在负载下的性能，还是分析系统行为以进行优化，MCBenchmark 都能为您提供所需的工具，并提供详细的指标和智能节流。
---
## 🔧 它能做什么
- ✅ **自适应区块基准测试：** 测量区块加载的速度，而不会使服务器超载，并根据当前的 TPS 动态调整。
- ✅ **实体基准测试：** 在受控环境中生成并处理实体，以识别性能限制和瓶颈。
- ✅ **方块基准测试：** 随机采样区域内的方块，以通过材料、半径和样本大小来测试方块交互性能。
- ✅ **瓦片实体基准测试：** 评估服务器在负载下处理瓦片实体（例如，箱子、漏斗）的方式。
- ✅ **延迟基准测试：** 反复 ping 服务器以生成延迟指标，包括平均值和变化。
- ✅ **TPS 监控：** 持续跟踪服务器的 TPS，采用自适应采样进行准确的基准测试。
- ✅ **基准测试控制：** 通过单个命令立即停止所有正在运行的基准测试，以确保安全性和控制力。
---
## 📋 命令
### `/chunkbenchmark [半径] [最大 CPS]`
- 基于 TPS 的自适应区块加载基准测试
- **别名:** `cbench`, `chunkbench`
- **权限:** `mcbenchmark.chunk`
### `/entitybenchmark [迭代次数]`
- 通过高迭代次数的实体生成来压力测试服务器
- **别名:** `ebench`, `entitybench`
- **权限:** `mcbenchmark.entity`
### `/blockbenchmark [材料] [半径] [样本数]`
- 具有自定义参数的随机方块采样基准测试
- **别名:** `bbench`, `blockbench`
- **权限:** `mcbenchmark.block`
### `/tilebenchmark [迭代次数]`
- 瓦片实体（例如，箱子、漏斗）的密集基准测试
- **别名:** `tbench`, `tilebench`
- **权限:** `mcbenchmark.tile`
### `/pingbenchmark [迭代次数]`
- 向服务器发送多次 ping，并提供详细的统计信息
- **别名:** `pbench`, `pingbench`
- **权限:** `mcbenchmark.ping`
### `/tpsbenchmark [迭代次数]`
- 具有可调节采样率的连续 TPS 跟踪
- **别名:** `tpsbench`, `tps`
- **权限:** `mcbenchmark.tps`
### `/stopbenchmark`
- 立即停止所有当前正在运行的基准测试
- **别名:** `stopbench`, `sbench`, `stop`
- **权限:** `mcbenchmark.stop`
---
## 🔐 权限
- `mcbenchmark.*` — 访问所有命令（默认为 OP）
- 单个命令权限：
- `mcbenchmark.chunk`
- `mcbenchmark.entity`
- `mcbenchmark.block`
- `mcbenchmark.tile`
- `mcbenchmark.ping`
- `mcbenchmark.tps`
- `mcbenchmark.stop`
每个权限默认为 OP，可以通过权限插件（例如 LuckPerms）进行自定义。
---