# LagSpike Guardian
### 您的全能服务器稳定性解决方案
---
作为一名开发者和服务器爱好者，我知道任何服务器所有者面临的最大挑战是卡顿。 它可能来自各种地方——被遗忘的生物农场，大量的物品溢出，或一个损坏的红石机器。 我创建了 **LagSpike Guardian** 为了成为一个更智能、全能的解决方案。 与仅仅盲目清除实体不同，此插件主动监控您的服务器健康状况，并为您提供工具来自动预防卡顿并自行诊断卡顿问题。 它功能强大、轻量级，并且旨在让您安心。
---
### ⭐ 功能
- ✅ **自动 TPS 监控：** 智能地仅当服务器的 TPS 低于配置的阈值时清除实体，从而在不影响游戏体验的情况下预防卡顿。
- ✅ **定时物品清理器：** 定期清理掉落的物品，带有可配置的警告和保护物品列表，确保宝贵的装备不会被删除。
- ✅ **智能红石限制器：** 检测并暂时禁用导致服务器卡顿的过度活跃的红石时钟，并对世界进行白名单设置以保护玩家建筑。
- ✅ **强大的诊断工具：** 使用 `/lagspike topchunks` 立即找到服务器上最卡顿的 5 个区块，帮助您快速找到基于实体的卡顿的确切来源。
- ✅ **完整的管理员控制：** 根据需要手动清除物品或生物，并使用 `/lagspike reload` 在不重启服务器的情况下重新加载整个插件配置。
- ✅ **100% 可配置：** `config.yml` 中可以更改每个消息、颜色、定时器和设置。
- ✅ **用户友好的命令：** 所有命令都具有完整的自动补全功能，使用起来非常方便。
---
### 📙 命令 & 权限
| 命令 | 权限 | 描述 |
| :--- | :--- | :--- |
| `/lagspike status` | *(无)* | 显示服务器当前的 TPS、实体和内存。 |
| `/lagspike reload` | `lagspike.admin` | 重新加载整个插件配置。 |
| `/lagspike clear ` | `lagspike.clear` | 手动清除所有物品或配置的生物。 |
| `/lagspike topchunks` | `lagspike.diagnostics` | 显示实体数量最多的 5 个区块。 |
*(所有权限默认为 OP)*
---
### ⚙️ 默认配置
此插件是完全可定制的。 查看默认 `config.yml` 以了解您有多少控制权。
点击查看默认 config.yml
```yaml
# LagSpike Guardian Configuration
tps-threshold: 18.5
entity-clearing:
mobs-to-clear:
- ZOMBIE
- SKELETON
- SPIDER
- CREEPER
- PHANTOM
- CHICKEN
- COW
item-clearing:
enabled: true
clear-interval-minutes: 15
warning-times-seconds:
- 60
- 30
- 10
dont-clear-items:
- DIAMOND
- DIAMOND_BLOCK
- NETHERITE_INGOT
- NETHERITE_BLOCK
- BEACON
- ELYTRA
redstone-limiter:
enabled: true
pulse-threshold-per-second: 15
disabled-worlds:
- "skyblock_world"
- "creative"
disable-duration-seconds: 30
messages:
prefix: "&8[&cGuardian&8] "
no-permission: "&c您没有使用此命令的权限。"
reload-success: "&aLagSpike Guardian 配置已重新加载!"
unknown-command: "&c未知子命令。 使用 /lagspike status, reload, clear 或 topchunks。"
status-header: "&8--- &6LagSpike Guardian 状态 &8---"
status-tps: "&eTPS: &a%tps%"
status-entities: "&e总实体数: &a%amount%"
status-memory: "&e内存使用情况: &a%used%MB / %max%MB"
entity-clear-broadcast: "&e清除 %amount% 个实体以改善服务器健康状况。"
item-clear-warning: "&e将在 %time% 秒内清理地面物品!"
item-clear-broadcast: "&a清理了 %amount% 个地面物品。"
topchunks-header: "&8--- &6最卡顿的 5 个区块 &8---"
topchunks-format: "&e%rank%. &b世界&f: %world% &bX&f: %x% &bZ&f: %z% &8- &a%amount% 个实体"
topchunks-calculating: "&e正在计算，请稍候..."
manual-clear-items: "&a已成功清除 %amount% 个物品。"
manual-clear-mobs: "&a已成功清除 %amount% 个生物。"
```
