Void Cleaner

插件

· 作者 Dominos111G

VoidCleaner 会自动且智能地清理服务器中的掉落物、投射物、载具和生物,并将它们存储在一个特殊的“虚空”(存储空间)中。

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

最新 0.1.1 · 1.21.11 · Paper / Purpur

一键开服(送7天)

注意: 此描述完全由 AI 生成,欢迎提供您的建议!

? VoidCleaner

适用于 Paper Minecraft 1.20+ 服务器的智能物品管理插件

VoidCleaner 会自动且智能地清理服务器中掉落的物品、投射物、载具和生物,并将它们存储在一个特殊的“虚空”(储物空间)中,供玩家取回。该系统会根据服务器负载(TPS)自动调整清理的激进程度。

✨ 主要功能

? 基于 TPS 的智能清理

  • TPS 正常 → 常规清理(物品、投射物、空载具)
  • TPS 较低 → 激进清理(增加生物)
  • TPS 危急 → 全面清理(几乎所有实体)

? 多维世界虚空存储

  • 每个世界组拥有独立的虚空(主世界、下界+末地、自定义)
  • 物品自动路由至正确的虚空
  • 配置中支持灵活的世界到虚空的映射

⚡ 异步清理

  • /void worldclean — 清理未加载区块且不产生卡顿
  • 后台扫描,主线程移除
  • 所有操作均安全

? 实时玩家同步

  • 当玩家 A 取走物品时,玩家 B 会立即看到变化
  • GUI 对所有查看者自动更新
  • 无重复或幽灵物品

? 智能物品堆叠

  • 自动合并相同类型的物品
  • 尊重最大堆叠数量(船=1,铁锭=64)
  • 减少所需虚空槽位

?️ 高级过滤

  • 保护驯服动物(默认开启)
  • 保护命名实体(默认开启)
  • 每种清理模式均可设置黑名单
  • 支持高级条件(如 +empty, !tamed, +adult 等)

? 安装

  1. 从 GitHub 或 Modrinth 下载 .jar 文件
  2. 放入 plugins/ 文件夹
  3. 重启服务器
  4. 编辑 plugins/VoidCleaner/config.yml(自动生成)
  5. 再次重启服务器

详见 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 来清理未加载区域。

? 故障排除

插件无法加载

检查:

  1. 您是否使用的是 Paper 1.20+?(执行 /version)
  2. JAR 文件是否在 plugins/ 文件夹中?
  3. 您是否有 Java 17+?(执行 java -version)

找不到 /void 指令

检查:

  1. 插件是否加载成功?(在控制台中查找 "[VoidCleaner]")
  2. 您是否具有 voidcleaner.use 权限?
  3. 重启服务器

虚空无法打开

检查:

  1. 运行 /void fullclean 强制清理
  2. 检查配置文件中的 void-close-delay-seconds
  3. 确认 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 下降
  • 玩家同步:无影响

? 链接

  • GitHub:
  • Modrinth:
  • 问题反馈:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源