XiaoNuoClean

XiaoNuoClean is a Minecraft Java Edition Fabric server-side mod for periodically clearing dropped items.

Features

• By default, clears dropped items every 15 minutes.
• By default, broadcasts warnings at 10, 5, 4, 3, 2, and 1 second(s) before clearing.
• Supports modifying the cleanup interval, warning seconds, and whitelist via config/xiaonuoclean.json.
• Whitelisted items will not be cleared, for example minecraft:diamond or the shorthand diamond.
• Supports viewing status, reloading configuration, immediate cleaning, and modifying configuration through the /xiaonuoclean command.

Default Configuration

{
  "intervalSeconds": 900,
  "warningSeconds": [10, 5, 4, 3, 2, 1],
  "whitelist": []
}

Commands

/xiaonuoclean status
/xiaonuoclean reload
/xiaonuoclean clean
/xiaonuoclean interval <seconds>
/xiaonuoclean warnings set <seconds...>
/xiaonuoclean whitelist set
/xiaonuoclean whitelist add <item>
/xiaonuoclean whitelist remove <item>
/xiaonuoclean whitelist list

Commands that modify settings require OP permission.

/xiaonuoclean whitelist set can only be executed by an in-game OP/admin. It reads the item ID from the executor's main hand and adds it to the whitelist; the console cannot use this command.

License

This project is open-sourced under the GNU General Public License v3.0.

See LICENSE for details.