? CleanerPlugin
在可配置的时间后自动清理掉落的物品。完全自定义,零延迟。
概述
CleanerPlugin 会自动移除在地面上停留过久的物品,保持服务器整洁且无延迟。非常适合生存服务器、小游戏或任何需要物品管理的世界。
✨ 功能
- 自动清理 — 物品在可配置的时间后消失(默认:10 分钟)
- 手动清理 — 使用
/cleaner clean 命令立即清理
- 智能黑名单 — 保护贵重物品(钻石、绿宝石、下界合金等)
- 按世界过滤 — 仅清理特定世界中的物品
- ELY 日志记录 — 结构化的清理日志,便于高级监控
- 运行时控制 — 无需重载即可启用/禁用
- 零依赖 — 纯 Bukkit API,无冗余代码
- Folia 支持 — 适用于异步线程服务器
? 命令
| 命令 |
权限 |
作用 |
/cleaner clean |
cleaner.admin |
立即清理所有掉落物品 |
/cleaner reload |
cleaner.admin |
从磁盘重新加载配置 |
/cleaner status |
任意 |
显示当前设置 |
/cleaner enable/disable |
cleaner.admin |
切换清理功能(运行时) |
? 配置
默认 config.yml:
enabled: true
cleanup-interval-ticks: 12000 # 10 分钟
item-lifespan-ticks: 12000 # 物品保留时间
log-cleanup: false
blacklist-items:
- DIAMOND
- EMERALD
- NETHERITE_INGOT
# 添加更多要保护的物品
自定义所有内容:
- 清理间隔(20 秒到 1 小时以上)
- 物品寿命(独立于清理间隔)
- 黑名单保护(保留贵重物品)
- 按世界设置
- 每秒最大处理物品数(防止延迟尖峰)
- 自定义消息
? 平台支持
✅ Bukkit 1.8+
✅ Spigot(所有版本)
✅ Paper(1.8.8+)
✅ Purpur(所有版本)
✅ Folia(1.20.1+)
? 权限
cleaner.admin — 访问所有命令
cleaner.bypass — 物品不会被清理(未来功能)
? 安装
- 下载 JAR 文件
- 放入
plugins/ 文件夹
- 重启服务器
- 根据需要编辑
config.yml
- 完成!
? 用例
- 生存服务器 — 玩家死亡后自动清理
- 小游戏 — 回合之间清理竞技场物品
- 创造服务器 — 无需手动干预即可清除杂物
- 经济服务器 — 保护贵重物品,清理垃圾
? 配置示例
快速清理(30 秒):
cleanup-interval-ticks: 600
item-lifespan-ticks: 600
慢速清理(30 分钟):
cleanup-interval-ticks: 36000
item-lifespan-ticks: 36000
仅保留贵重物品:
blacklist-items:
- DIAMOND
- DIAMOND_BLOCK
- EMERALD
- NETHERITE_INGOT
- ENCHANTED_BOOK
❓ 常见问题
Q: 它会拖慢我的服务器吗?
A: 不会。清理操作在异步线程中运行,并且每个间隔只检查一次(默认 10 分钟)。每秒最大处理物品数设置可防止延迟尖峰。
Q: 我可以保护某些物品吗?
A: 可以!将它们添加到 config.yml 的黑名单中。
Q: 它在 Folia 上有效吗?
A: 是的!完全支持 Folia 异步线程服务器。
Q: 我可以手动运行清理吗?
A: 可以!/cleaner clean 会立即清理所有物品。
专为 Bukkit/Spigot/Paper/Purpur/Folia 生态系统打造。
简单。整洁。高效。
? CleanerPlugin
Auto-cleans dropped items after a configurable time. Full customization, zero lag.
Overview
CleanerPlugin automatically removes items that sit on the ground for too long, keeping your server clean and lag-free. Perfect for survival servers, mini-games, or any world that needs item management.
✨ Features
- Auto-cleanup — Items vanish after configurable time (default: 10 mins)
- Manual cleanup —
/cleaner clean command for instant cleanup
- Smart blacklist — Protect valuable items (diamonds, emeralds, netherite, etc.)
- Per-world filtering — Only clean specific worlds
- ELY logging — Structured cleanup logs for advanced monitoring
- Runtime control — Enable/disable without reloading
- Zero dependencies — Pure Bukkit API, no bloat
- Folia support — Works on async-threaded servers
? Commands
| Command |
Permission |
What it does |
/cleaner clean |
cleaner.admin |
Instantly clean all dropped items |
/cleaner reload |
cleaner.admin |
Reload config from disk |
/cleaner status |
Any |
Show current settings |
/cleaner enable/disable |
cleaner.admin |
Toggle cleanup (runtime) |
? Configuration
Default config.yml:
enabled: true
cleanup-interval-ticks: 12000 # 10 minutes
item-lifespan-ticks: 12000 # How long items stay
log-cleanup: false
blacklist-items:
- DIAMOND
- EMERALD
- NETHERITE_INGOT
# Add more items to protect
Customize everything:
- Cleanup interval (20 secs to 1 hour+)
- Item lifespan (independent from cleanup)
- Blacklist protection (keep valuables)
- Per-world settings
- Max items per tick (prevent lag spikes)
- Custom messages
? Platform Support
✅ Bukkit 1.8+
✅ Spigot (all versions)
✅ Paper (1.8.8+)
✅ Purpur (all versions)
✅ Folia (1.20.1+)
? Permissions
cleaner.admin — Access all commands
cleaner.bypass — Items won't be cleaned (future feature)
? Installation
- Download JAR
- Drop into
plugins/ folder
- Restart server
- Edit
config.yml as needed
- Done!
? Use Cases
- Survival servers — Auto-clean after players die
- Mini-games — Clean up arena items between rounds
- Creative servers — Remove clutter without manual intervention
- Economy servers — Protect valuable items, clean junk
? Configuration Examples
Fast cleanup (30 secs):
cleanup-interval-ticks: 600
item-lifespan-ticks: 600
Lazy cleanup (30 mins):
cleanup-interval-ticks: 36000
item-lifespan-ticks: 36000
Keep only valuables:
blacklist-items:
- DIAMOND
- DIAMOND_BLOCK
- EMERALD
- NETHERITE_INGOT
- ENCHANTED_BOOK
❓ FAQ
Q: Will it lag my server?
A: No. Cleanup runs async and checks only once per interval (default 10 mins). Max items per tick setting prevents spikes.
Q: Can I protect certain items?
A: Yes! Add them to the blacklist in config.yml.
Q: Does it work on Folia?
A: Yes! Full Folia support for async-threaded servers.
Q: Can I run cleanup manually?
A: Yes! /cleaner clean instantly cleans all items.
Made for Bukkit/Spigot/Paper/Purpur/Folia ecosystems.
Simple. Clean. Effective.
评论 0
登录后参与评分
还没有评论,来抢沙发吧