清晰度

🪴 此插件专为 Kweebec World 服务器开发 🪴
IP: world.kweebec.xyz

---

Clearify 是一个 Hytale 服务器管理插件，可自动移除掉落物以帮助维持服务器性能并减少卡顿。它提供了可配置的清理系统、可自定义消息和清晰的管理员操作控制。

主要功能

• 两种清理模式

  • GlobalTime（全局计时）：类似经典计时器。全局倒计时运行，会广播警告，当计时器归零时清除所有掉落物。
  • DroppedBased（基于掉落物）：根据每个物品在地面上的时间单独清理。物品只有在存在时间达到配置的 interval（间隔）后才会被移除。此模式静默运行（无全局广播）。

• 可配置间隔

  • 通过配置文件或命令设置清理间隔（支持灵活的时间格式）。

• 可配置倒计时警告（仅 GlobalTime 模式）

  • 在清理前的配置时间点广播警告。

• 权限控制

  • 管理命令受权限保护。

• 即时清理命令

  • /clearity now 总是立即清除所有掉落物，无论使用哪种清理模式。

命令

• /clearity - 显示清理信息（根据模式）
• /clearity info - 显示清理信息（根据模式）
  • 在 DroppedBased 模式下，显示物品在 interval 时间后会被单独移除。
  • 在 GlobalTime 模式下，显示距离下次全局清理的剩余时间。
• /clearity now - （仅 OP）立即清除所有掉落物
• /clearity timeout <duration> - （仅 OP）设置清理间隔（例如 /clearity timeout 1h）

时间格式示例

• 1h - 1 小时
• 30min - 30 分钟
• 2h15min - 2 小时 15 分钟
• 1d30min20sec - 1 天 30 分钟 20 秒

权限

• clearity.op - 授予管理命令（now 和 timeout）的访问权限

配置

Clearify 将其配置存储在 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 重置（重置颜色和格式）

技术细节

Clearify 使用 Hytale 的 ECS（实体组件系统）查询来高效识别和移除掉落物实体。调度在专用计时器线程上运行，所有世界修改都在世界执行上下文中安全执行。

Clearify 非常适合物品堆积可能降低性能的繁忙服务器，它在自动化维护、管理员控制和完全的消息自定义之间取得了平衡。