注意: 此描述完全由 AI 生成,欢迎提供您的建议!
? VoidCleaner
适用于 Paper Minecraft 1.20+ 服务器的智能物品管理插件
VoidCleaner 会自动且智能地清理服务器中掉落的物品、投射物、载具和生物,并将它们存储在一个特殊的“虚空”(储物空间)中,供玩家取回。该系统会根据服务器负载(TPS)自动调整清理的激进程度。
✨ 主要功能
? 基于 TPS 的智能清理
- TPS 正常 → 常规清理(物品、投射物、空载具)
- TPS 较低 → 激进清理(增加生物)
- TPS 危急 → 全面清理(几乎所有实体)
? 多维世界虚空存储
- 每个世界组拥有独立的虚空(主世界、下界+末地、自定义)
- 物品自动路由至正确的虚空
- 配置中支持灵活的世界到虚空的映射
⚡ 异步清理
/void worldclean — 清理未加载区块且不产生卡顿
- 后台扫描,主线程移除
- 所有操作均安全
? 实时玩家同步
- 当玩家 A 取走物品时,玩家 B 会立即看到变化
- GUI 对所有查看者自动更新
- 无重复或幽灵物品
? 智能物品堆叠
- 自动合并相同类型的物品
- 尊重最大堆叠数量(船=1,铁锭=64)
- 减少所需虚空槽位
?️ 高级过滤
- 保护驯服动物(默认开启)
- 保护命名实体(默认开启)
- 每种清理模式均可设置黑名单
- 支持高级条件(如
+empty, !tamed, +adult 等)
? 安装
- 从 GitHub 或 Modrinth 下载
.jar 文件
- 放入
plugins/ 文件夹
- 重启服务器
- 编辑
plugins/VoidCleaner/config.yml(自动生成)
- 再次重启服务器
详见 INSTALLATION.md 获取详细指南。
? 玩家指令
/void
打开虚空 GUI 以取回物品(如果虚空已开放)。
? 管理员指令
/void open # 手动打开虚空
/void close # 手动关闭虚空
/void clean # 常规清理
/void fullclean # 激进清理(移除生物)
/void worldclean # 异步世界清理(未加载区块)
? 权限
| 权限节点 |
默认值 |
描述 |
voidcleaner.use |
true |
访问 /void GUI |
voidcleaner.admin |
op |
所有管理员指令 |
voidcleaner.open |
op |
/void open |
voidcleaner.close |
op |
/void close |
voidcleaner.clean |
op |
/void clean |
voidcleaner.fullclean |
op |
/void fullclean |
voidcleaner.worldclean |
op |
/void worldclean |
示例:LuckPerms
/lp user <player> permission set voidcleaner.use true
/lp group admin permission set voidcleaner.admin true
⚙️ 配置
世界映射
world-voids:
overworld:
- world
nether-end:
- world_nether
- world_the_end
default-void: overworld
来自各个世界的物品将进入其映射的虚空。
存储上限
max-void-storage: 10000 # 每个虚空的物品上限 (0 = 无限)
自动清理
cleanup-interval-seconds: 600 # 每 10 分钟清理一次
enable-auto-cleanup: true
建议:
- 小型服务器(2-4 名玩家):300秒(5分钟)
- 中型服务器(5-20 名玩家):600秒(10分钟)
- 大型服务器(20+ 名玩家):1200秒(20分钟)
基于 TPS 的清理
low-tps-threshold: 12.0 # 触发激进清理
critical-tps-threshold: 8.0 # 触发全面清理
tps-check-interval-seconds: 30
工作原理:
- TPS > 12.0 → 常规模式
- TPS 8.0-12.0 → 同时移除生物
- TPS < 8.0 → 全面清理
虚空持续时间
void-close-delay-seconds: 120 # 虚空在 2 分钟后关闭
在此时间过后,虚空将关闭,剩余物品将被永久删除。
清理规则
default-clean: # 常规清理
- minecraft:item
- minecraft:arrow
- minecraft:oak_boat +empty
high-clean: # 激进清理
- minecraft:zombie
- minecraft:skeleton
# ... 更多生物
规则格式
"minecraft:item" # 所有物品
"minecraft:oak_boat +empty" # 仅空船
"minecraft:minecart" # 所有矿车
"minecraft:wolf !tamed" # 仅野生狼
"minecraft:zombie +adult" # 仅成年僵尸
条件
| 条件 |
含义 |
+empty |
无乘客的载具 |
!empty |
有乘客的载具 |
+tamed |
驯服的动物 |
!tamed |
野生动物 |
+named |
拥有名牌 |
!named |
无名牌 |
+adult |
成年 |
+baby |
幼年/幼崽 |
+hostile |
敌对生物 |
!hostile / +passive |
和平生物 |
+on_ground |
站立在地面上 |
黑名单
default-blacklist: [] # 免受常规清理保护
fullclean-blacklist:
- minecraft:villager # 永不移除
- minecraft:iron_golem
查看所有选项请参阅完整的 config.yml。
? 使用场景
小型 SMP 服务器
world-voids:
all:
- world
- world_nether
- world_the_end
max-void-storage: 5000
cleanup-interval-seconds: 300
大型生存服务器
world-voids:
main:
- world
- world_nether
- world_the_end
creative:
- creative_world
max-void-storage: 20000
cleanup-interval-seconds: 600
low-tps-threshold: 12.0
防卡顿机器设置
enable-auto-cleanup: false
protect-tamed: true
protect-named: true
然后手动运行 /void worldclean 来清理未加载区域。
? 故障排除
插件无法加载
检查:
- 您是否使用的是 Paper 1.20+?(执行
/version)
- JAR 文件是否在
plugins/ 文件夹中?
- 您是否有 Java 17+?(执行
java -version)
找不到 /void 指令
检查:
- 插件是否加载成功?(在控制台中查找 "[VoidCleaner]")
- 您是否具有
voidcleaner.use 权限?
- 重启服务器
虚空无法打开
检查:
- 运行
/void fullclean 强制清理
- 检查配置文件中的
void-close-delay-seconds
- 确认
enable-auto-cleanup: true 是否开启?
CPU 占用过高
解决方案:
- 增加
cleanup-interval-seconds(例如 1200)
- 增加
tps-check-interval-seconds(例如 60)
- 减少
default-clean 中的规则数量
更多解决方案请参阅 INSTALLATION.md。
? 性能
VoidCleaner 经过性能优化:
- ✅ 异步世界扫描(无卡顿)
- ✅ 高效的实体过滤
- ✅ 内存优化存储
- ✅ 智能堆叠减少槽位占用
- ✅ 主线程安全操作
TPS 影响:
- 常规清理:< 0.1 TPS 下降
- 虚空打开/关闭:< 0.01 TPS 下降
- 玩家同步:无影响
? 链接
NOTE: I generated ONLY this description with AI and I'm open for your ideas!
? VoidCleaner
Intelligent item management plugin for Paper Minecraft 1.20+ servers
VoidCleaner automatically and intelligently cleans up dropped items, projectiles, vehicles, and mobs from your server, storing them in a special "void" (storage) where players can retrieve them. The system automatically adjusts cleanup aggression based on server load (TPS).
✨ Key Features
? Intelligent TPS-Based Cleanup
- Healthy TPS → Normal cleanup (items, projectiles, empty vehicles)
- Low TPS → Aggressive cleanup (+ mobs)
- Critical TPS → Full cleanup (almost everything)
? Multi-World Void Storage
- Separate void for each world group (Overworld, Nether+End, Custom)
- Items automatically route to the correct void
- Flexible world-to-void mapping in config
⚡ Asynchronous Cleanup
/void worldclean — Cleans unloaded chunks without lag
- Background scanning, main-thread removal
- Safe for all operations
? Real-Time Player Synchronization
- When player A takes an item, player B sees it instantly
- GUI automatically updates for all viewers
- No duplicate or ghost items
? Smart Item Stacking
- Automatically merges items of the same type
- Respects max stack size (boats=1, iron=64)
- Reduces void slots needed
?️ Advanced Filtering
- Protects tamed animals (default)
- Protects named entities (default)
- Blacklists for each cleanup mode
- Advanced conditions (+empty, !tamed, +adult, etc.)
? Installation
- Download
.jar from GitHub or Modrinth
- Place in
plugins/ folder
- Restart server
- Edit
plugins/VoidCleaner/config.yml (auto-generated)
- Restart server again
See INSTALLATION.md for detailed instructions.
? Player Commands
/void
Opens the void GUI to retrieve items (if void is open).
? Admin Commands
/void open # Manually open void
/void close # Manually close void
/void clean # Normal cleanup
/void fullclean # Aggressive cleanup (removes mobs)
/void worldclean # Async world cleanup (unloaded chunks)
? Permissions
| Permission |
Default |
Description |
voidcleaner.use |
true |
Access to /void GUI |
voidcleaner.admin |
op |
All admin commands |
voidcleaner.open |
op |
/void open |
voidcleaner.close |
op |
/void close |
voidcleaner.clean |
op |
/void clean |
voidcleaner.fullclean |
op |
/void fullclean |
voidcleaner.worldclean |
op |
/void worldclean |
Example: LuckPerms
/lp user <player> permission set voidcleaner.use true
/lp group admin permission set voidcleaner.admin true
⚙️ Configuration
World Mapping
world-voids:
overworld:
- world
nether-end:
- world_nether
- world_the_end
default-void: overworld
Items from each world go to their mapped void.
Storage Limit
max-void-storage: 10000 # Max items per void (0 = unlimited)
Auto Cleanup
cleanup-interval-seconds: 600 # Cleanup every 10 minutes
enable-auto-cleanup: true
Recommendations:
- Small server (2-4 players): 300s (5 min)
- Medium server (5-20 players): 600s (10 min)
- Large server (20+ players): 1200s (20 min)
TPS-Based Cleanup
low-tps-threshold: 12.0 # Trigger aggressive cleanup
critical-tps-threshold: 8.0 # Trigger full cleanup
tps-check-interval-seconds: 30
How it works:
- TPS > 12.0 → Normal mode
- TPS 8.0-12.0 → Remove mobs too
- TPS < 8.0 → Full cleanup
Void Duration
void-close-delay-seconds: 120 # Void closes after 2 minutes
After this time, the void closes and remaining items are deleted forever.
Cleanup Rules
default-clean: # Regular cleanup
- minecraft:item
- minecraft:arrow
- minecraft:oak_boat +empty
high-clean: # Aggressive cleanup
- minecraft:zombie
- minecraft:skeleton
# ... more mobs
Rule Format
"minecraft:item" # All items
"minecraft:oak_boat +empty" # Empty boats only
"minecraft:minecart" # All minecarts
"minecraft:wolf !tamed" # Wild wolves only
"minecraft:zombie +adult" # Adult zombies only
Conditions
| Condition |
Meaning |
+empty |
Vehicle without passenger |
!empty |
Vehicle with passenger |
+tamed |
Tamed animal |
!tamed |
Wild animal |
+named |
Has nametag |
!named |
No nametag |
+adult |
Adult |
+baby |
Baby/young |
+hostile |
Hostile mob |
!hostile / +passive |
Peaceful |
+on_ground |
Standing on ground |
Blacklists
default-blacklist: [] # Protected from default cleanup
fullclean-blacklist:
- minecraft:villager # Never removed
- minecraft:iron_golem
See full config.yml for all options.
? Use Cases
Small SMP Server
world-voids:
all:
- world
- world_nether
- world_the_end
max-void-storage: 5000
cleanup-interval-seconds: 300
Large Survival Server
world-voids:
main:
- world
- world_nether
- world_the_end
creative:
- creative_world
max-void-storage: 20000
cleanup-interval-seconds: 600
low-tps-threshold: 12.0
Anti-Lag Machine Setup
enable-auto-cleanup: false
protect-tamed: true
protect-named: true
Then manually run /void worldclean to clean unloaded areas.
? Troubleshooting
Plugin won't load
Check:
- Are you using Paper 1.20+? (
/version)
- Is the JAR in the
plugins/ folder?
- Do you have Java 17+? (
java -version)
/void command not found
Check:
- Did the plugin load? (Check console for "[VoidCleaner]")
- Do you have
voidcleaner.use permission?
- Restart the server
Void won't open
Check:
- Run
/void fullclean to force cleanup
- Check
void-close-delay-seconds in config
- Is
enable-auto-cleanup: true?
High CPU usage
Solutions:
- Increase
cleanup-interval-seconds (e.g., 1200)
- Increase
tps-check-interval-seconds (e.g., 60)
- Reduce rules in
default-clean
See INSTALLATION.md for more solutions.
? Performance
VoidCleaner is optimized for performance:
- ✅ Async world scanning (no lag)
- ✅ Efficient entity filtering
- ✅ Memory-optimized storage
- ✅ Smart stacking reduces slots
- ✅ Main-thread safe operations
TPS Impact:
- Regular cleanup: < 0.1 TPS drop
- Void open/close: < 0.01 TPS drop
- Player sync: No impact
? Links
- GitHub:
- Modrinth:
- Issues:
评论 0
登录后参与评分
还没有评论,来抢沙发吧