DropSweeper

An intelligent item-drop sweeper for Minecraft servers.

With the friendly "Sweeper Maid" (扫地姬) by your side, say goodbye to piles of cobblestone, sand, and arrows. ฅ^•ﻌ•^ฅ

What is this?

DropSweeper is a Fabric server-side mod that automatically collects dropped items on the ground into dustbins (virtual large chests with 54 slots each), giving you:

• 🧹 Auto sweep — runs on a configurable interval (default: every 10 minutes)
• 📦 Multiple dustbins — defaults to 1, configurable up to N; FIFO eviction across bins
• 🚫 White/Black lists — whitelist items are never touched; blacklist items are removed but not stored
• 🎯 Extra entity cleanup — arrows, experience orbs, etc.
• ⚠️ Overload warning — alerts OP when a chunk has too many items piling up
• 💬 Friendly announcements — countdown before sweep (ActionBar/Chat), clickable dustbin links on completion
• 🔧 Hot-reload config — no server restart needed
• 🔐 Granular permissions — control who can open dustbins vs. who can trigger sweeps

Commands

All commands are prefixed with /dropsweeper.

Sweep

Open dustbin

After a sweep completes, the result message lists all non-empty dustbins as clickable links.

White/Black list management

/dropsweeper whitelist add <item_id>     # Add to whitelist (never swept)
/dropsweeper whitelist remove <item_id>  # Remove from whitelist
/dropsweeper whitelist list              # Show whitelist

/dropsweeper blacklist add <item_id>     # Add to blacklist (swept but not stored)
/dropsweeper blacklist remove <item_id>  # Remove from blacklist
/dropsweeper blacklist list              # Show blacklist

Wildcard modid:* is supported, e.g. minecraft:* matches all vanilla items.

Config

/dropsweeper config reload    # Hot-reload config/dropsweeper.json

Configuration

Location: config/dropsweeper.json (auto-generated on first run).

Common fields

{
  "sweepIntervalSeconds": 600,           // Auto-sweep interval in seconds (0 = disabled)
  "dustbinCount": 1,                     // Number of dustbins (54 slots each)
  "itemWhitelist": [                     // Whitelist: never swept
    "minecraft:nether_star",
    "minecraft:heavy_core"
  ],
  "itemBlacklist": [                     // Blacklist: swept but not stored
    "minecraft:cobblestone",
    "minecraft:sand",
    "minecraft:gravel"
  ],
  "extraEntityTypes": [                  // Extra entities to clean up
    "minecraft:arrow",
    "minecraft:spectral_arrow",
    "minecraft:experience_orb"
  ],
  "itemOverloadThreshold": 640,          // Per-chunk item count to trigger warning (0 = disabled)
  "permissionLevelDustbin": 0,           // Min. permission to open dustbin (0 = any player)
  "permissionLevelClean": 2,             // Min. permission to manually sweep
  "announcementChannel": {               // Announcement channels
    "long": "actionbar",                 // Long countdown (default 120/60/30s)
    "short": "chat",                     // Short countdown (≤3s)
    "complete": "chat"                   // Sweep completion
  }
}

Announcement channels

• ActionBar — small text above the hotbar, auto-fades after 60 ticks (3 seconds), doesn't spam
• Chat — bold message in chat, doesn't auto-fade

Default: long countdown uses ActionBar (unobtrusive), short countdown and completion use Chat (visible).

How much can dustbins hold?

• Each dustbin has 54 slots (6 rows × 9 columns, equivalent to a large chest)
• Default 1 → 54 slots
• Set dustbinCount: 8 → 8 × 54 = 432 slots
• When full, the oldest item is replaced by the new one (FIFO)

Data storage

• Dustbin contents are stored in the world save: world/data/dimensions/minecraft/overworld/data/dropsweeper/dustbin.dat
• Auto-saved, no manual action needed
• Decreasing the number of dustbins will truncate the extras and may discard items in non-empty dustbins
• Increasing the number preserves existing data

FAQ

Q: Where is the dustbin? How do I open it?
A: Run /dropsweeper dustbin (any player by default), or click the links in the sweep-completion message.

Q: How do I add custom items to the white/black list?
A: Use /dropsweeper whitelist add <item_id> (e.g. minecraft:diamond). You can also edit config/dropsweeper.json directly, then run /dropsweeper config reload.

Q: Do I have to restart the server after changing the config?
A: No. Run /dropsweeper config reload to apply changes immediately.

Q: Do clients need to install the mod?
A: On a multiplayer server, no — all sweep/command/storage logic runs server-side. Clients that install it just get a stub entrypoint.
For single-player or LAN play, you can install it on the client as well without affecting gameplay.

Q: Will it conflict with other sweep mods?
A: Yes. If two mods try to clean the same drops, you may get duplicate removals. Use one or the other.

DropSweeper 🧹

Introduction

Tired of items piling up like mountains in your server but hate clearing them manually? Worried about accidentally wiping out valuable resources?

Introducing dropsweeper, a smart item-sweeping mod custom-built for Minecraft 26.1.2 (Fabric)!

It automatically sweeps up dropped items in your world at set intervals, using a friendly "Maid / Sweeper-chan" persona to broadcast tips. It keeps your server clean and lag-free without losing any of your important gear.

This mod is fully implemented using the native Fabric API. It requires no server plugins or dependency mods—just plug and play.

Commands

All commands start with the base node /dropsweeper:

• /dropsweeper items – Sweeps all dropped items in the current world.
• /dropsweeper items all – Sweeps dropped items across all worlds.
• /dropsweeper items <world> – Sweeps dropped items in a specified world (supports Tab completion).
• /dropsweeper dustbin – Opens the default dustbin (Index 0).
• /dropsweeper dustbin <index> – Opens the dustbin with the specified index.
• /dropsweeper whitelist add <item> – Adds an item to the whitelist (never swept).
• /dropsweeper whitelist remove <item> – Removes an item from the whitelist.
• /dropsweeper whitelist list – Lists all whitelisted items.
• /dropsweeper blacklist add <item> – Adds an item to the blacklist (swept but destroyed instead of sent to dustbins).
• /dropsweeper blacklist remove <item> – Removes an item from the blacklist.
• /dropsweeper blacklist list – Lists all blacklisted items.
• /dropsweeper config reload – Hot-reloads the configuration file for immediate effect.

Features

• Smart Sweeping: Automatically runs at set intervals (default: 600 seconds) or can be manually triggered instantly via commands.
• White & Blacklists: Supports a Whitelist (never cleared; safeguards Nether Star and Heavy Core by default) and a Blacklist (cleared but destroyed; targets Cobblestone, Sand, and Gravel by default).
• Wildcard Matching: Supports modid:* wildcards for easy bulk management (can be disabled).
• Multi-Dustbin Storage: Features 1 large 54-slot chest by default, expandable to N bins in the config. Uses a FIFO (First-In, First-Out) system to automatically eject the oldest items when full.
• Persistent Data: Dustbin data is persisted via NBT and survives server restarts. Backwards compatible with older single-bin save data.
• Extra Entity Sweeping: Supports clearing additional entities like arrows, spectral arrows, and experience orbs (entity types are fully configurable).
• Lag Prevention Alerts: Automatically alerts OPs when item accumulation in a single chunk exceeds a threshold (default: 640) to prevent server lag. Warnings are throttled to once every 10 minutes per chunk.
• Polished Broadcasts: Long countdowns (default: 60/30/15s) display on the ActionBar to avoid chat spam, while short countdowns (default: ≤3s) pop up directly in chat for high visibility.
• Interactive Completion: Displays non-empty dustbin numbers right after a sweep; click the number to instantly open that specific chest.
• Custom Persona: Features a friendly "Sweeper-chan" persona for localized broadcast text, which is fully customizable.
• Configurable Permissions: Permission levels (0-4) map directly to MC 26.1.2's Permissions system.
• Hot-reloading: Configuration changes reload instantly. Automatically syncs when changing the dustbin count (triggers a warning if truncating a non-empty bin).

Configuration File

The configuration file is located at config/dropsweeper.json and is automatically generated on the first startup. Below are the key fields: