ClearDrops+

插件

· 作者 Fedex1991

代码和项目文本的相当一部分使用了 AI 辅助。功能设计、需求分析、配置、测试、验证、发布决策以及持续维护均由项目作者完成。

0 本站下载 0 关注 更新于 5 个月前

最新 1.3.5 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

ClearDrops+

ClearDrops+ 是一款 Minecraft 清理插件。

它通过以可控、可预测且对 TPS 安全的方式移除掉落物并限制实体密集的区块,来保持你的世界整洁。

ClearDrops+ 并非简单的“删除一切”清理工具。它将物品清理与实体清理分开,尊重服务器性能,保护有价值的内容,并给予管理员完全的控制权,决定何时以及如何执行清理。

非常适合希望获得更整洁的世界、更好的性能以及更安全的清理行为的生存服、SMP 服和农场密集型服务器。


✨ 1.3 版本新增内容

ClearDrops+ 1.3 将该插件从单纯的掉落物清理工具扩展为更智能的服务器卫生管理工具。

此更新添加了:

  • 针对动物和怪物的智能实体清理
  • 独立的定时全局实体清理
  • 可选的区块加载时实体清理
  • 按组设置的实体数量上限
  • 奶牛、猪、鸡和羊的独立上限
  • 命名实体、已驯服实体、拴绳实体和马具实体的保护
  • 拥有职业的村民的保护
  • 命名村民和命名铁傀儡的保护
  • 基于名称、描述(Lore)、CustomModelData 和 PersistentDataContainer 的自定义物品保护
  • 用于扫描和清理实体密集区块的新管理员命令

⚡ 核心功能

  • 在可配置的间隔内自动清理掉落物
  • 物品清理开始前的警告消息
  • TPS 保护:当服务器负载过高时跳过或停止清理
  • 基于批次的物品移除,防止卡顿
  • 最小物品年龄过滤器,以保护刚掉落的物品
  • 通过 blacklist.yml 设置材质黑名单
  • 通过 config.yml 保护自定义物品
  • 使用 ALL 或 WHITELIST 模式进行世界级控制
  • 可选的基于区块的物品清理
  • 针对拥挤的动物和怪物区块的智能实体清理
  • 物品清理和实体清理使用独立的计时器

? 全局物品清理

经典的物品清理系统会在可配置的时间间隔后移除已加载世界中的掉落物。

用例示例:

  • 每 60 分钟移除一次掉落物
  • 清理前警告玩家
  • 如果 TPS 过低则跳过清理
  • 仅移除达到一定年龄的物品
  • 永不移除黑名单中的材质
  • 保护带有名称、描述、CustomModelData 或 PDC 数据的自定义物品

该系统旨在保持地面整洁,同时避免造成卡顿。


?️ 物品区块清理工作线程

ClearDrops+ 包含一个可选的基于区块加载的物品清理系统。

该系统适用于那些在加载时包含过多掉落物的区块。

功能特性:

  • 仅在已加载的区块上运行
  • 从不强制加载区块
  • 使用安全的工作队列
  • 支持每秒处理tick数的限制
  • 支持区块冷却时间
  • 支持动态 TPS 缩放
  • 支持按世界覆盖设置
  • 可在清理发生时通知管理员

这使得它在大型服务器上更加安全,并防止大量清理工作一次性发生。


? 智能实体清理

ClearDrops+ 1.3 引入了新的智能实体清理系统。

该系统可以限制每个区块中大型动物和怪物农场的规模。

与删除所有实体不同,它仅移除超出配置上限的额外且未受保护的实体。

示例:

如果将每个区块的鸡限制为 20 只,而某个区块中有 100 只鸡,ClearDrops+ 将根据你配置的 remove-per-run 值,缓慢且安全地移除溢出的部分。

这有助于防止因农场过大而影响 TPS,尤其是在低配服务器上。


? 独立的动物上限

农场动物可以单独配置上限。

这意味着你可以设置如下限制:

  • 每个区块最多 20 头奶牛
  • 每个区块最多 20 头猪
  • 每个区块最多 20 只鸡
  • 每个区块最多 20 只绵羊

这比单一的全局动物上限更为精确。

示例:

entity-cleanup:
  groups:
    cows:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - COW

    chickens:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - CHICKEN

? 全局定时实体清理

实体清理可以运行在其自身的计时器上,与物品清理分离。

示例:

  • 物品清理每 2 小时一次
  • 动物和怪物清理每 1 小时一次

全局实体清理仅扫描服务器已经加载的区块。

它不会强制加载区块。

这意味着即使在更大的地图上,它也保持安全和可预测。


? 可选的区块加载实体清理

ClearDrops+ 还可以在区块自然加载时检查实体。

此功能可以单独启用或禁用。

示例:

entity-cleanup:
  enabled: true

  chunk-load:
    enabled: false

  global:
    enabled: true

在此设置下:

  • 禁用玩家在探索地图时的实体清理
  • 全局定时实体清理仍然启用
  • 在全局清理期间仅扫描已加载的区块

这给予服务器所有者对实体清理行为方式的完全控制权。


?️ 实体保护

ClearDrops+ 不会盲目删除玩家拥有的或有价值的实体。

保护系统可以保护以下实体:

  • 命名实体
  • 已驯服的动物
  • 拴绳的动物
  • 佩戴马具的动物
  • 拥有职业的村民
  • 命名的村民
  • 命名的铁傀儡

示例:

如果玩家在拥挤的农场区块中有一只拴着的绵羊或一只命名的动物,ClearDrops+ 会将其计为受保护状态,不会将其移除。

这使得清理过程对 SMP 服务器来说更安全、更公平。


? 自定义物品保护

ClearDrops+ 可以通过检查物品元数据来保护自定义掉落物。

这对于使用自定义物品系统的服务器非常有用,例如:

  • ItemCoreX
  • Oraxen
  • ItemsAdder
  • MMOItems
  • MythicMobs 物品掉落
  • 其他自定义物品插件

保护选项包括:

  • 自定义显示名称
  • 描述(Lore)
  • CustomModelData
  • PersistentDataContainer 键
  • 附魔物品(可选)

示例:

item-protection:
  enabled: true
  protect-named-items: true
  protect-lore-items: true
  protect-custom-model-data: true
  protect-persistent-data-items: true
  protect-enchanted-items: false

黑名单仍然存在,但它仅通过 Bukkit 材质类型来保护物品。

自定义物品应通过 item-protection(物品保护)进行保护。


? 性能与安全

ClearDrops+ 旨在对性能友好。

它包括:

  • 清理前和清理期间的 TPS 检查
  • 基于批次的移除
  • 基于队列的区块处理
  • 可配置的每秒处理区块数
  • 可配置的每秒处理物品数
  • 可配置的每次运行移除实体数
  • 基于动态 TPS 的缩放
  • 无异步实体访问
  • 无不安全区块加载
  • 无强制区块加载

该插件仅与服务器已加载的区块配合工作。


? 管理员工具

ClearDrops+ 包含用于检查清理行为的管理员命令。

/cd entityscan

扫描当前区块并显示有关配置实体组的有用信息。

它将显示:

  • 区块中找到的实体组
  • 每组的实体总数
  • 配置的组上限
  • 溢出数量
  • 受保护的实体
  • 可移除的实体
  • 找到的实体类型

这在检查玩家农场时非常有用。

/cd entityclear

使用配置的实体组限制清理当前区块。

它不会移除所有实体。

它仅移除超出配置限制的额外、不受保护的实体。


? 命令

命令 描述 权限
/cd help 显示命令帮助 所有人
/cd next 显示距离下次物品清理的时间 所有人
/cd clear 手动启动全局物品清理 cleardrops.admin
/cd status 显示插件状态 cleardrops.admin
/cd stats 显示清理统计信息 cleardrops.admin
/cd info 显示插件和配置信息 cleardrops.admin
/cd cleanhere 清理当前区块中的掉落物品 cleardrops.admin
/cd entityscan 扫描当前区块中的实体组 cleardrops.admin
/cd entityclear 清理当前区块中的实体溢出 cleardrops.admin
/cd debug start 启用调试日志记录 cleardrops.admin
/cd debug stop 禁用调试日志记录 cleardrops.admin
/cd reload 重新加载配置文件 cleardrops.admin

? 权限

权限 描述
cleardrops.admin 授予对所有管理命令的访问权限

⚙️ 配置

ClearDrops+ 提供灵活的配置系统。

您可以配置:

  • 全局物品清理间隔
  • 警告时间
  • 玩家和控制台通知
  • 最低 TPS
  • 最低物品数量
  • 最低物品年龄
  • 每秒移除的物品数
  • 世界白名单模式
  • 材质黑名单
  • 自定义物品保护
  • 物品区块清理
  • 实体清理主开关
  • 区块加载时的实体清理
  • 全局定时实体清理
  • 实体组限制
  • 实体保护规则
  • 动态 TPS 缩放
  • 调试日志记录
  • 更新检查器

所有配置文件会在首次启动时自动生成。


? 配置示例

点击显示 example config.yml
clear:
  interval-seconds: 3600

safety:
  min-tps: 14.0
  min-items-to-clear: 10

filters:
  minAgeSeconds: 60

performance:
  items-per-tick: 200

item-protection:
  enabled: true
  protect-named-items: true
  protect-lore-items: true
  protect-custom-model-data: true
  protect-persistent-data-items: true
  protect-enchanted-items: false

chunk-cleanup:
  enabled: true
  min-items: 20
  max-chunks-per-tick: 1
  max-remove-per-chunk: 800
  chunk-cooldown-seconds: 60
  only-existing-chunks: true
  notify-admins: true

entity-cleanup:
  enabled: true

  chunk-load:
    enabled: false
    max-chunks-per-tick: 1
    chunk-cooldown-seconds: 120

  notify-admins: true

  global:
    enabled: true
    interval-seconds: 3600
    min-tps: 14.0
    chunks-per-tick: 1

  protection:
    protect-named-entities: true
    protect-tamed-animals: true
    protect-leashed-entities: true
    protect-saddled-entities: true
    protect-villagers-with-profession: true
    protect-villagers-with-custom-name: true
    protect-iron-golems-with-custom-name: true

  groups:
    cows:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - COW

    pigs:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - PIG

    chickens:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - CHICKEN

    sheep:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - SHEEP

    monsters:
      enabled: true
      max-per-chunk: 60
      remove-per-run: 20
      types:
        - ZOMBIE
        - CREEPER
        - SKELETON
        - SLIME

    villagers:
      enabled: false
      max-per-chunk: 30
      remove-per-run: 5
      types:
        - VILLAGER

    iron-golems:
      enabled: false
      max-per-chunk: 20
      remove-per-run: 3
      types:
        - IRON_GOLEM

? 便于更新的配置

ClearDrops+ 旨在便于更新。

  • config.yml、messages.yml 和 blacklist.yml 中缺失的键可以自动添加
  • 尽可能保留现有设置
  • 配置文件使用内部版本号
  • 内置 Modrinth 更新检查器
  • 可选的控制台更新通知
  • 可选的管理员加入通知

服务器所有者通常只需替换 .jar 文件,并将新的默认配置与现有文件进行比较即可。

查看我的其他插件

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源