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

* Multiplayer Compatible: Automatically clears dropped items on the ground at customizable intervals. * Multiplayer Compatible: Sends chat warnings at 60s, 30s, and a final countdown before the sweep occurs. * Multiplayer Compatible: A shared trash can (up to 10 pages) accessible via an inventory button or commands, allowing players to retrieve cleared items. * Multiplayer Compatible: Open the cleanup blacklist through the command or control interface to record items that you do not want to be automatically cleaned up. * Multiplayer Compatible: Full support for in-game configuration via Multiplayer Compatible and Multiplayer Compatible. 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页的垃圾桶，玩家可以通过背包上方的快捷按钮或指令打开，拾取被清理的物品。 * 联机兼容：通过指令或控制界面打开清理黑名单，记录不希望被自动清理的物品。 * 联机兼容：通过对接 联机兼容 与 联机兼容 支持在游戏内直接进行模组全方位的配置，如：修改任何提示文本、清理间隔、UI按钮位置等，实时生效！ * 联机兼容：可独立运行在服务端上，并会自动向客户端同步相关的清理配置参数。

-----

Commands | 指令介绍

All commands start with `/sweeper`.

所有指令均以 `/sweeper` 开头。

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

* 可自定义权限等级: 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.