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:

| Field | Default Value | Description |
| :----------------------- | :---------------------------------------- | :----------------------------------------------------------- |
| sweepIntervalSeconds | 600 | Automated sweeping interval (seconds). Set to 0 to disable. |
| dustbinCount | 1 | Total number of dustbins (54 slots per bin). |
| dustbinName | "Dustbin " | The prefix for the dustbin UI title. The final name will appear as "Dustbin N". |
| itemWhitelist | [nether_star, heavy_core] | Items that will never be swept. |
| itemBlacklist | [cobblestone, sand, gravel] | Items that are cleared but will not be placed in dustbins. |
| matchWildcard | true | Enables support for the modid:* wildcard pattern. |
| itemOverloadThreshold | 640 | The item threshold per single chunk to trigger an OP warning. Set to 0 to disable. |
| extraEntityTypes | [arrow, spectral_arrow, experience_orb] | Additional entity types to be swept during cleanup. |
| permissionLevelDustbin | 0 | Minimum permission level required to open a dustbin. |
| permissionLevelClean | 2 | Minimum permission level required to trigger a manual sweep. |
| announcePointsLong | [120, 60, 30] | Timestamps (in seconds) to trigger long-form countdown warnings. |
| announceShortThreshold | 3 | Threshold for short countdowns (sends a warning every second when remaining time ≤ N). |
| announcementChannel | See Config | Configures whether the long, short, and complete announcements route to the actionbar or chat. |