Clearity 是一款为 Hytale 服务器设计的插件，可自动清除掉落物品，以帮助维持服务器性能并减少延迟。它提供可配置的清理系统、可自定义的消息以及管理员可清晰操作的控件。
主要字段：
非常适合繁忙的服务器，其中物品积累可能会导致性能下降，Clearity 在自动化维护、管理员控制和完整消息自定义之间取得平衡。
主要功能
- 两种清理模式
- GlobalTime: 像经典计时器一样工作。一个全局倒计时运行，发出警告，当计时器达到 0 时，所有掉落的物品都会被清除。
- DroppedBased: 根据每个物品在地上的持续时间单独清理物品。物品只有在存在至少配置的 interval 后才会被移除。这种模式静默运行（不进行全局广播）。
- 可配置间隔
- 通过配置或命令设置清理间隔（支持灵活的持续时间格式）。
- 可配置的倒计时警告（仅限全局时间）
- 在清理前按配置时间广播警告。
- 基于权限的控制
- 管理命令受权限保护。
- 即时清理命令
- /clearity now 总是立即清除所有掉落物品，无论清理模式如何。
命令
- /clearity - 显示清理信息（模式感知）
- /clearity info - 显示清理信息（模式感知）
- 在 DroppedBased 中，显示物品会在 interval 后逐个被移除
- 在 GlobalTime 中，显示距离下次全局清理剩余的时间
- /clearity now - (仅管理员) 立即清除所有掉落物品
- /clearity timeout <duration> - (仅管理员) 设置清理间隔（例如 /clearity timeout 1h）
时间格式示例
- 1h - 1 小时
- 30min - 30 分钟
- 2h15min - 2 小时和 15 分钟
- 1d30min20sec - 1 天，30 分钟和 20 秒
权限
- clearity.op - 授予访问管理命令（now 和 timeout）的权限
配置
Clearity 将其配置存储在 mods/Clearity/config.json。主要字段：
- interval：两种模式都使用的清理时间设置
- 在 GlobalTime：全局倒计时持续时间
- 在 DroppedBased：每个物品的移除前生命周期阈值
- cleanupMode："GlobalTime" 或 "DroppedBased"
- notifyDelays（仅 GlobalTime 使用）：警告延迟列表（例如 ["30min","10min","1min","10sec","5sec"] ）
- messages: 所有消息都是可配置的，并支持占位符：
- {delay} - 格式化的延迟标签（用于警告/超时设置）
- {count} - 移除的项目数量（用于全局清除后）
消息中的颜色和格式代码
所有可配置的消息都支持 Minecraft 风格的 & 代码：- 颜色 : &0-&9, &a-&f
- 格式化 :
- &l 粗体
- &n 下划线
- &o 斜体
- &m 删除线
- &k 模糊
- &r 重置（重置颜色和格式）
技术细节
Clearity 使用 Hytale 的 ECS（实体组件系统）查询来高效地识别和移除掉落物品实体。调度在专门的计时器线程上运行，所有世界修改都在世界执行上下文中安全地执行。非常适合繁忙的服务器，其中物品积累可能会导致性能下降，Clearity 在自动化维护、管理员控制和完整消息自定义之间取得平衡。
