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 文件,并将新的默认配置与现有文件进行比较即可。
查看我的其他插件
ClearDrops+
ClearDrops+ is a Minecraft cleanup plugin.
It keeps your worlds clean by removing dropped items and limiting entity-heavy chunks in a controlled, predictable and TPS-safe way.
ClearDrops+ is not a simple “delete everything” cleaner. It separates item cleanup from entity cleanup, respects server performance, protects valuable content and gives admins full control over when and how cleanup should happen.
Perfect for survival, SMP and farm-heavy servers that want cleaner worlds, better performance and safer cleanup behavior.
✨ What is new in 1.3?
ClearDrops+ 1.3 expands the plugin from a dropped item cleaner into a smarter server hygiene tool.
This update adds:
- Smart entity cleanup for animals and mobs
- Separate global timed entity cleanup
- Optional chunk-load entity cleanup
- Per-group entity limits
- Separate limits for cows, pigs, chickens and sheep
- Protection for named, tamed, leashed and saddled entities
- Protection for villagers with professions
- Protection for named villagers and named iron golems
- Custom item protection for names, lore, CustomModelData and PersistentDataContainer items
- New admin commands for scanning and cleaning entity-heavy chunks
⚡ Core Features
- Automatic dropped item cleanup at configurable intervals
- Warning messages before item cleanup starts
- TPS protection to skip or stop cleanup when the server is under load
- Batch-based item removal to prevent lag spikes
- Minimum item age filter to protect freshly dropped items
- Material blacklist via
blacklist.yml
- Custom item protection via
config.yml
- Per-world control using
ALL or WHITELIST mode
- Optional chunk-based item cleanup
- Smart entity cleanup for crowded animal and mob chunks
- Separate timers for item cleanup and entity cleanup
? Global Item Cleanup
The classic item cleanup system removes dropped items from loaded worlds after a configurable interval.
Example use case:
- Remove dropped items every 60 minutes
- Warn players before cleanup
- Skip cleanup if TPS is too low
- Only remove items that are old enough
- Never remove blacklisted materials
- Protect custom items with name, lore, CustomModelData or PDC data
This system is designed to keep the ground clean without causing lag spikes.
?️ Item Chunk Cleanup Worker
ClearDrops+ includes an optional chunk-load based item cleanup system.
This system is useful for chunks that contain too many dropped items when they are loaded.
Features:
- Runs only on already loaded chunks
- Never force-loads chunks
- Uses a safe queue worker
- Supports per-tick processing limits
- Supports chunk cooldowns
- Supports dynamic TPS scaling
- Supports per-world overrides
- Can notify admins when cleanup happens
This makes it safe for larger servers and prevents heavy cleanup work from happening all at once.
? Smart Entity Cleanup
ClearDrops+ 1.3 introduces a new smart entity cleanup system.
This system can limit large animal and mob farms per chunk.
Instead of deleting all entities, it only removes extra, unprotected entities above the configured limit.
Example:
If chickens are limited to 20 per chunk and a chunk contains 100 chickens, ClearDrops+ will only remove the overflow slowly and safely, based on your configured remove-per-run value.
This helps against oversized farms that can hurt TPS, especially on low-end servers.
? Separate Animal Limits
Farm animals can be configured separately.
This means you can set limits like:
- 20 cows per chunk
- 20 pigs per chunk
- 20 chickens per chunk
- 20 sheep per chunk
This is more precise than one global animal limit.
Example:
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
? Global Timed Entity Cleanup
Entity cleanup can run on its own timer, separate from item cleanup.
Example:
- Item cleanup every 2 hours
- Animal and mob cleanup every 1 hour
The global entity cleanup only scans chunks that are already loaded by the server.
It does not force-load chunks.
This means it stays safe and predictable even on larger maps.
? Optional Chunk-Load Entity Cleanup
ClearDrops+ can also check entities when chunks naturally load.
This can be enabled or disabled separately.
Example:
entity-cleanup:
enabled: true
chunk-load:
enabled: false
global:
enabled: true
With this setup:
- Entity cleanup while players explore the map is disabled
- Global timed entity cleanup is still enabled
- Only already loaded chunks are scanned during the global cleanup
This gives server owners full control over how entity cleanup should behave.
?️ Entity Protection
ClearDrops+ does not blindly delete player-owned or valuable entities.
The protection system can protect:
- Named entities
- Tamed animals
- Leashed animals
- Saddled animals
- Villagers with professions
- Named villagers
- Named iron golems
Example:
If a player has a leashed sheep or a named animal inside a crowded farm chunk, ClearDrops+ will count it as protected and will not remove it.
This makes the cleanup safer and fairer for SMP servers.
? Custom Item Protection
ClearDrops+ can protect custom dropped items by checking their item metadata.
This is useful for servers using custom item systems such as:
- ItemCoreX
- Oraxen
- ItemsAdder
- MMOItems
- MythicMobs item drops
- Other custom item plugins
Protection options include:
- Custom display names
- Lore
- CustomModelData
- PersistentDataContainer keys
- Enchanted items, optional
Example:
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
The material blacklist still exists, but it only protects items by Bukkit material type.
Custom items should be protected through item-protection.
? Performance & Safety
ClearDrops+ is designed to be performance-friendly.
It includes:
- TPS checks before and during cleanup
- Batch-based removal
- Queue-based chunk processing
- Configurable chunks per tick
- Configurable items per tick
- Configurable entities removed per run
- Dynamic TPS-based scaling
- No async entity access
- No unsafe chunk loading
- No forced chunk loading
The plugin only works with chunks that are already loaded by the server.
? Admin Tools
ClearDrops+ includes useful admin commands for checking cleanup behavior.
/cd entityscan
Scans the current chunk and shows useful information about configured entity groups.
It displays:
- Entity groups found in the chunk
- Total entities per group
- Configured group limit
- Overflow amount
- Protected entities
- Removable entities
- Entity types found
This is useful when checking player farms.
/cd entityclear
Cleans the current chunk using the configured entity group limits.
It does not remove all entities.
It only removes extra, unprotected entities above the configured limit.
? Commands
| Command |
Description |
Permission |
/cd help |
Show command help |
Everyone |
/cd next |
Show time until the next item clear |
Everyone |
/cd clear |
Manually start global item cleanup |
cleardrops.admin |
/cd status |
Show plugin status |
cleardrops.admin |
/cd stats |
Show cleanup statistics |
cleardrops.admin |
/cd info |
Show plugin and config information |
cleardrops.admin |
/cd cleanhere |
Clean dropped items in the current chunk |
cleardrops.admin |
/cd entityscan |
Scan entity groups in the current chunk |
cleardrops.admin |
/cd entityclear |
Clean entity overflow in the current chunk |
cleardrops.admin |
/cd debug start |
Enable debug logging |
cleardrops.admin |
/cd debug stop |
Disable debug logging |
cleardrops.admin |
/cd reload |
Reload configuration files |
cleardrops.admin |
? Permissions
| Permission |
Description |
cleardrops.admin |
Grants access to all administrative commands |
⚙️ Configuration
ClearDrops+ provides a flexible configuration system.
You can configure:
- Global item cleanup interval
- Warning times
- Player and console notifications
- Minimum TPS
- Minimum item count
- Minimum item age
- Items removed per tick
- World whitelist mode
- Material blacklist
- Custom item protection
- Item chunk cleanup
- Entity cleanup master switch
- Chunk-load entity cleanup
- Global timed entity cleanup
- Entity group limits
- Entity protection rules
- Dynamic TPS scaling
- Debug logging
- Update checker
All configuration files are generated automatically on first startup.
? Configuration Example
Click to show 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
? Update-Friendly Configuration
ClearDrops+ is designed to be update-friendly.
- Missing keys in
config.yml, messages.yml, and blacklist.yml can be added automatically
- Existing settings are preserved where possible
- Config files use internal version numbers
- Built-in Modrinth update checker
- Optional console update notifications
- Optional admin join notifications
Server owners can usually replace the .jar file and compare the new default configuration with their existing files.
Check Out My Other Plugins
评论 0
登录后参与评分
还没有评论,来抢沙发吧