[Optimization - WorldListTrashCan

WorldListTrashCan 是一款为玩家家园世界设计的垃圾桶插件，它不仅能自动清理地面物品和实体，还能让玩家创建专属的家园垃圾桶来回收物品，完美替代传统扫地插件，并支持高度自定义与多语言。

💡核心特性

三种垃圾桶系统

• 家园垃圾桶：玩家在特定世界（如家园）创建的专属容器，清理时物品会存入其中。
• 个人垃圾桶：玩家独立的临时存储空间，用于处理误丢到仙人掌/岩浆的物品（可配置经济赎回）。
• 公共垃圾桶：全服共享的全局容器，当家园或个人垃圾桶满时，溢出的物品会进入此处。

清理与提示

• 定时清理地面掉落物，间隔可配置。
• 支持实体清理（怪物、动物），可设置黑白名单。
• 完全可定制的清理倒计时提示，支持 BossBar、ActionBar、Title、聊天栏同时提醒，并可每秒更改样式、颜色。
• 支持提示音效，可每秒切换不同音效、音量与音高。

管理与优化

• 玩家可为自己的家园垃圾桶设置物品黑名单。
• 密集实体检测与清理，可配置检测半径、数量上限。
• 防刷屏与指令频率限制。
• 多项性能优化：快速清理不可拾取的箭矢、防止踩踏农田等。
• 支持 Folia 服务器。

🎮指令列表

• /WorldListTrashCan GlobalTrash - 打开公共垃圾桶
• /WorldListTrashCan help - 查看帮助
• /WorldListTrashCan reload - 重载插件
• /WorldListTrashCan ban - 打开本世界垃圾桶黑名单 GUI
• /WorldListTrashCan Look - 右键实体查询其类型（用于配置）
• /WorldListTrashCan GlobalBan - 打开全局垃圾桶黑名单 GUI
• /WorldListTrashCan add [世界名] <数量> - 设置指定世界可创建的家园垃圾桶最大数量（不填则默认为脚下世界）
• /WorldListTrashCan PlayerTrash - 打开你的个人垃圾桶
• /WorldListTrashCan DropMode - 开启/关闭防丢弃模式

🔧权限节点

默认情况下玩家没有权限，需要手动授予。

• WorldListTrashCan.GlobalBan - 使用 /WorldListTrashCan GlobalBan 指令的权限
• WorldListTrashCan.Look - 使用 /WorldListTrashCan Look 指令的权限
• WorldListTrashCan.BanGui - 使用黑名单 GUI 的权限
• WorldListTrashCan.Main - 允许玩家创建家园垃圾桶的基础权限
• WorldListTrashCan.GlobalTrashOpen - 打开公共垃圾桶的权限
• WorldListTrashCan.help - 查看帮助的权限
• WorldListTrashCan.PlayerTrash - 打开个人垃圾桶的权限
• WorldListTrashCan.DropMode - 切换防丢弃模式的权限

✨创建家园垃圾桶

• 在地上放置一个普通箱子。
• 手持告示牌，右键点击该箱子。
• 在告示牌第一行输入配置文件中 Set.SighCheckName 设定的关键词（默认为 [世界垃圾桶]）。
• 文字转换后即创建成功。此后该世界的清理物品会自动存入此箱。

⭐配置概述

几乎所有功能都可在 config.yml 中调整，每个参数都有详细注释。主要配置区域包括：

• Set：基础设置，如语言文件、清理间隔、垃圾桶创建关键词。
• GlobalTrash：公共垃圾桶设置，如开关、最大页数、自动清理周期。
• ClearEntity：实体清理设置，可开关、选择清理怪物或动物、设置黑白名单。
• PersonalTrashCan：个人垃圾桶（误删物品保护）设置，提供三种处理模式。
• 提示信息：分别配置 BossBar、ActionBar、Title、Chat 的倒计时消息，支持 RGB 颜色（1.16.5+）。
• WorldEntityLimitCount：世界实体数量限制。
• GatherEntityLimitCount：密集实体清理设置。
• ChatSet：防刷屏与指令频率限制。
• DropItemCheck：防丢弃功能开关。
• SimpleOptimize：性能优化开关。

❓注意事项与提示

• 插件优化良好，黑名单检测仅为简单的类型检查，不会导致性能问题。
• 可在配置中禁止在特定世界（如主世界、下界、末地）创建家园垃圾桶。
• 家园垃圾桶本身不进行权限检查（因为玩家需有家园建造权限），但其黑名单 GUI 会验证权限（通过要求玩家在3秒内尝试放置或破坏方块）。
• 若服务器使用家园插件（如 PlayerWorldsPro），当玩家未进入家园时，其垃圾桶不会加载，这是正常现象。玩家进入后会自动加载。
• 支持通过 ItemsAdder 自定义公共垃圾桶材质。
• 历史版本可在 Modrinth 查看：https://modrinth.com/plugin/worldlisttrashcan/versions

🔧已实现更新计划

• 玩家可放置多个家园垃圾桶 ✔️
• 垃圾桶黑名单系统 ✔️
• VIP 与普通玩家可放置不同数量的垃圾桶（每世界）✔️
• 加入多种服务器性能优化 ✔️
• 增加实体清理系统，支持清理模组（如 SlashBlades）实体 ✔️

---

**联系与支持**

• QQ 群：923738709
• 邮箱：[email protected]

---

声明：本插件所有代码均为原创，严禁抄袭源码，违者必究。