L-Clearlag - 服务器优化大师

L-Clearlag 是一款专为解决高版本 Minecraft 服务器实体卡顿问题而设计的插件。它通过智能管理实体的追踪状态，显著降低因大量实体导致的 TPS 下降，尤其适用于 1.14 至 1.19 版本且在线玩家较多的服务器。

💡核心功能

• 彻底解决 1.14、1.15、1.16、1.17、1.18、1.19 版本的实体卡顿问题。
• 智能解除玩家追踪范围外实体的追踪，并在玩家靠近时重新追踪，从而大幅减轻服务器负担。
• 提供按区块的实体数量限制功能，防止实体过度集中。
• 内置村民行为优化选项（实验性功能）。
• 截至目前，已成功清理超过 100,000,000 个实体。

❓工作原理

Minecraft 服务器会持续追踪大量实体，即使它们不在任何玩家的可视范围内。这种行为在 1.14.4 至 1.19 版本中，对于超过 30 名玩家的服务器而言，是导致 TPS 骤降的主要原因。

本插件通过以下方式工作

• 每隔预设的周期（ticks），检查并解除远离玩家的实体的追踪状态。
• 当玩家进入实体附近一定范围时，立即重新追踪该实体。
• 此机制有效减少了服务器每刻需要处理的实体数量，从而提升整体性能。

🎮要求与依赖

• 必需服务端： PaperMC （插件所有功能均基于 Paper 核心）
• 兼容版本： 1.14.4 至 1.19

🔧配置说明

以下是配置文件的核心选项详解

基本设置

• log-to-console: false
• 是否在控制台打印插件与实体交互的日志。
• tps-limit: 20.0
• 触发插件清理任务的服务器 TPS 阈值。设置为 20 以上将使任务持续运行。
• untrack-ticks: 1000
• 检查并解除“滞留”实体追踪的周期（单位：游戏刻）。
• tracking-range: 50
• 判断玩家是否“靠近”实体的距离（单位：方块）。

实体过滤

• ignore-entity-list
• 忽略处理的实体类型列表，默认包括：

- creeper

- villager

- ender_dragon

- armor_stand

• ignore-entity-name: true
• 是否忽略所有已命名的实体。

世界与追踪控制

• enable-on-all-worlds: true
• 是否在所有世界启用插件功能。若为 true，则 worlds 列表失效。
• worlds
• 指定启用插件功能的世界列表，默认包括：

- world

- world_nether

- world_the_end

• disable-tick-for-untracked-entities: true
• 仅限 1.16.1+ 服务器：是否停止对被解除追踪实体的刻更新。

实体数量限制（可选）

• chunk-entity-limit-enable: false
• 是否启用每个区块的实体数量上限。
• entity-limit
• 设置实体上限。例如：

- `all:70` 表示每个区块最多存在 70 个任意实体。

- 可指定特定实体，如 `pig:10`。

村民优化（实验性功能）

• villager-enable: false
• 是否启用村民 AI 优化（基于 Villager Optimiser 插件）。
• ticks-per-allow-search: 600
• 村民允许进行寻路等活动的间隔刻数。

⭐注意事项

• 本插件专为 PaperMC 核心设计，在其他服务端核心上可能无法工作。
• 配置中的 disable-tick-for-untracked-entities 选项仅对 1.16.1 及以上版本生效。
• 村民优化功能尚处于测试阶段，启用前请做好测试。
• 插件版本号记录于配置文件末尾：version: 1.7.1。

✨插件信息

• 开发者： MiniLuca#7822
• SpigotMC 资源页面： https://www.spigotmc.org/resources/l-clearlag.98464/
• 插件统计： https://bstats.org/plugin/bukkit/L-Clearlag/13638
• 问题反馈： 请在 Spigot 资源页面的讨论区报告任何 Bug。

> 提示：此插件整合并改进了 EntityTrackerFixer 和 Villager Optimiser 等插件的核心思路，旨在提供一体化的实体性能解决方案。