Sweeper Maid: Paged Dustbin

An unofficial fork of Sweeper Maid by Liu Dongyu (Viola-Siemens), rebuilt around one idea: a dustbin that never fills up.

The original dustbin holds a fixed 54 slots and simply stops accepting drops once it is full — everything swept afterwards is gone for good. This fork replaces that with paging, huge stacks, automatic upkeep, and experience collection. Licensed AGPL-3.0, identical to upstream.

How it differs from the original

The dustbin pages instead of overflowing

The bottom row of the chest is now a control row: lime glass is previous page, light blue is next page, paper shows "page N / M", and everything turns grey when there is nowhere left to go. Pages are created only when the previous one fills, and empty pages are reclaimed automatically.

The paging buttons are server-synthesized items, not client-side drawing. A click arrives as an ordinary container click, so players who do not have the mod installed can page too.

Because the bottom row now holds buttons, each page carries 45 items instead of 54. Contents in slots 46–54 of an existing world are automatically re-packed into the new pages on load — nothing is discarded, and a migration test guards this.

One slot, a million of an item

A dustbin slot holds up to DUSTBIN_SLOT_CAPACITY of a single item type, default 1,000,000, instead of the vanilla 64. Modded clients see 1.2K / 4.6M; unmodded clients still see and take 64 at a time.

Swept experience is stored, not destroyed

Experience orbs are converted into items retrievable from the dustbin:

• without Create: enchanted bottles (XP_PER_BOTTLE, default 10 XP per bottle)
• with Create: create:experience_nugget, at 1 nugget = 3 XP
• XP_CONVERSION_MODE selects auto / bottle / nugget / discard

Conversion rounds down and throws the remainder away, so no experience is ever created out of nothing. Merged orbs are counted as value × count.

Dustbin upkeep on a timer

DUSTBIN_TRASH_MODE picks between emptying the bins outright (clear) and packing them first (pack). Packing compresses the contents into a gzip NBT file under the world save and clears the bins; imports go back with /sweepermaid unpack <file>. Trigger it on a schedule with DUSTBIN_TRASH_INTERVAL, or immediately with /sweepermaid trash / pack.

Contents sorted after every sweep

Dustbins are re-ordered largest-first after each sweep, then re-paged.

Overload detection can see experience orbs

GLOBAL_ITEM_COUNT_THRESHOLD used to count item entities only, so a floor covered in orbs never triggered a sweep. Dropped-item piles and experience orbs now share one definition, and all three counting paths use it.

The client really is optional

Upstream registered a custom menu type, so an unmodded client could not resolve it and was disconnected during the handshake — players with NeoForge but without the mod were hit hardest. The dustbin is now a plain vanilla chest menu with page state carried over an optional channel. Verified on a live server with three client types: modded, NeoForge-only, and fully vanilla.

Commands

Compatibility

• Minecraft 1.21.1, NeoForge 21.1.224 or newer, Java 21
• Server-side only. Nothing needs to be installed on the client. Single-player works too.
• Create is an optional soft dependency — used only to choose the experience item. Nothing breaks without it.

⚠️ Do not install this and the original Sweeper Maid together

Both use the mod id sweeper_maid. Minecraft will refuse to start if both jars are present. Pick one.

Notes

• Unofficial fork. Not affiliated with or endorsed by the original author.
• Please report bugs here, not to the upstream project.
• Forked from dev/NeoForge-1.21.1 at commit e3ea859; modifications begin July 2026 and continue.
• Full source, including the AGPL-3.0 text: https://github.com/yansunsky/Sweeper-Maid

中文说明

清洁女仆·翻页桶 是 Sweeper Maid （原作者 刘冬煜 / Viola-Siemens）的非官方分支。原版垃圾桶固定 54 格，装满后新清扫的物品就再也存不进去； 本分支围绕「垃圾桶永不装满」重建，改用翻页 + 超大堆叠 + 定时清理 + 经验回收。

• 翻页垃圾桶：底部一行是翻页按钮（绿＝上一页、淡蓝＝下一页、纸＝页码），按需生成页、取空后自动回收。 按钮由服务端合成物品实现，未装模组的玩家也能翻页。每页 45 格；老存档第 46~54 格内容会自动重排，不会丢失。
• 超大堆叠：单格上限默认 100 万（DUSTBIN_SLOT_CAPACITY），原版为 64。
• 经验回收：清扫到的经验球折算成可取回的物品——未装机械动力为附魔之瓶， 装了则为经验颗粒（1 颗 = 3 点经验）。折算向下取整，余数丢弃，不会刷经验。
• 定时清理：可配置定时「清空」或「打包」（打包为 gzip NBT 存盘，可用指令导回）。
• 客户端真正可选：原版因自定义菜单类型导致未装模组的玩家在握手时被踢；现已改为原版箱子菜单承载。

兼容性：Minecraft 1.21.1 · NeoForge 21.1.224+ · Java 21 · 纯服务端，客户端无需安装

⚠️ 请勿与原版 Sweeper Maid 同时安装——两者 mod id 相同，会无法启动。

非官方分支，与原作者无隶属关系；问题请反馈到本页，不要打扰原作者。