Sweeper Can

Sweeper Can / 垃圾桶

Sweeper Can is a 1.20.1 Fabric port inspired by the Sweeper Maid mod. It periodically clears dropped items to reduce lag and features a global trash can, allowing players to retrieve items that have been swept away.

垃圾桶 (Sweeper Can) 参考了Sweeper Maid模组，进行了1.20.1的Fabric移植，可以定期清理掉落物，内置了一个全局垃圾桶，方便玩家拿取被清理的掉落物。

Features | 功能特性

English

• Periodic Item Sweeping: Automatically clears dropped items on the ground at customizable intervals.
• Cleanup Countdown Broadcasts: Sends chat warnings at 60s, 30s, and a final countdown before the sweep occurs.
• Global Trash Can: A shared trash can (up to 10 pages) accessible via an inventory button or commands, allowing players to retrieve cleared items.
• Item Blacklist: Open the cleanup blacklist through the command or control interface to record items that you do not want to be automatically cleaned up.
• In-Game Configuration: Full support for in-game configuration via Cloth Config and Mod Menu. Modify notification text, intervals, UI button positions, and more in real-time.
• Multiplayer Compatible: Runs on dedicated servers and automatically syncs configuration parameters with clients.

中文

• 定时清理掉落物：按自定义的时间间隔，自动清理地面上的掉落物。
• 清理倒计时播报：在清理前60秒、30秒以及最后倒计时进行提示。
• 全局垃圾桶：包含一个最高支持10页的垃圾桶，玩家可以通过背包上方的快捷按钮或指令打开，拾取被清理的物品。
• 物品黑名单：通过指令或控制界面打开清理黑名单，记录不希望被自动清理的物品。
• 游戏内配置菜单：通过对接 Cloth Config 与 Mod Menu 支持在游戏内直接进行模组全方位的配置，如：修改任何提示文本、清理间隔、UI按钮位置等，实时生效！
• 联机兼容：可独立运行在服务端上，并会自动向客户端同步相关的清理配置参数。

Commands | 指令介绍

All commands start with /sweeper.

所有指令均以 /sweeper 开头。

| Command / 指令 | Permission / 权限需求 | Description / 说明 |
| :— |:—————————————:|:—————————————————————————————————————|
| /sweeper open [page] | None 所有人
(All Players) | EN: Open the trash can GUI to discard or retrieve items.
ZH: 打开垃圾桶界面丢弃或拾取物品。 |
| /sweeper blacklist | Configurable
(Default: OP-Level 2) | EN: Open the ghost blacklist inventory to register ignored items.
ZH: 打开“清理黑名单”虚拟背包，登记不想被清理掉落物的物品。 |
| /sweeper config | Configurable
(Default: OP-Level 2) | EN: Open the mod settings GUI to change configurations.
ZH: 呼出模组配置界面以更改模组设定。 |
| /sweeper clean [seconds] | Configurable
(Default: OP-Level 2) | EN: Schedule a clearing event after seconds (defaults to immediately).
ZH: 安排在 seconds 秒后执行清理（不带参数则代表立刻清理）。 |
| /sweeper amount <1-10> | Configurable
(Default: OP-Level 2) | EN: Quickly set the maximum number of pages for the trash can (1-10).
ZH: 快速调整并设定垃圾桶的最大可翻页数 (1到10页)。 |

• Configurable Permissions: Set the required OP level for administrative commands from the config file (sweeper_can.json).
• 可自定义权限等级：允许在配置文件（sweeper_can.json）内设定执行管理指令所需的OP权限等级（0-4）。

Dependencies | 依赖与前置

• Fabric Loader & Fabric API (Required / 必须装载)
• Cloth Config API (Required / 必须，用于渲染配置界面)
• Mod Menu (Optional / 可选：安装后即可在模组列表直接点击配置本模组)

License

This mod is available under the CC0-1.0 license. Feel free to learn from it and incorporate it into your own projects.