ClearItem - Smart, Lightweight Item Cleanup
ClearItem is a clean, fast and multilingual item cleanup plugin for Bukkit/Spigot servers. It removes dropped ground items at a configurable interval, keeps chat messages modern, supports PlaceholderAPI and LuckPerms, and works with language-based subcommands while the main command always stays /clearitem.
Supported Versions
Minecraft 1.16.5 up to modern 1.21.x servers.
Main Features
- Lightweight dropped-item cleanup
- Correct stack counting: 64 items are counted as 64, not 1 stack
- Configurable cleanup interval
- Warning messages before cleanup
- 16 built-in languages
- Language-based subcommands
- Modern chat messages
- LuckPerms support
- Separate permission for every command
- PlaceholderAPI support
- World blacklist / whitelist system
- MIT license: can be used, edited and shared freely
Commands
/clearitem clear Manually starts item cleanup.
/clearitem reload Reloads config and language files.
/clearitem time Shows the next cleanup time.
/clearitem status Shows plugin status and LuckPerms hook status.
/clearitem help Shows the command help menu.
Important: The /clearitem part always stays the same. Subcommands change depending on the selected language.
Example Spanish Commands
/clearitem limpiar /clearitem recargar /clearitem tiempo /clearitem estado /clearitem ayuda
LuckPerms Permissions
clearitem.admin Gives access to every ClearItem command.
clearitem.command.clear Allows manual cleanup with /clearitem clear.
clearitem.command.reload Allows reloading config and language files.
clearitem.command.time Allows viewing the next cleanup time.
clearitem.command.status Allows viewing plugin status.
clearitem.command.help Allows viewing the help menu.
LuckPerms Examples
/lp group admin permission set clearitem.admin true /lp group moderator permission set clearitem.command.clear true /lp group helper permission set clearitem.command.time true /lp group helper permission set clearitem.command.status true
PlaceholderAPI Placeholders
%clearitem_next% Shows the next cleanup time in readable format. Example: 4 minutes 20 seconds
%clearitem_next_seconds% Shows the next cleanup time as raw seconds. Example: 260
%clearitem_running% Shows whether cleanup is currently running. Example: true or false
%clearitem_language% Shows the active language code. Example: en, tr, es
Config
Default language:
language: active: en
Cleanup interval:
cleanup: interval: 5m
Supported time formats:
30s 5m 1h 300
World filter:
worlds: mode: BLACKLIST list: []
BLACKLIST means listed worlds will not be cleaned. WHITELIST means only listed worlds will be cleaned.
Built-in Languages
English, Turkish, Spanish, German, French, Italian, Portuguese, Russian, Chinese, Japanese, Korean, Dutch, Polish, Arabic, Hindi, Indonesian.
Performance
ClearItem is designed to be lightweight. It does not scan the server every tick. It only runs when the cleanup timer reaches zero or when an authorized user manually starts cleanup.
The plugin only targets dropped item entities. It does not remove mobs, armor stands, XP orbs or other entities. This keeps cleanup focused and avoids unnecessary work.
Items are removed in the same cleanup operation, so players cannot easily abuse a delay between scanned items and removed items. Stack amounts are counted correctly, so the final message shows the real amount of removed items.
Short Description
ClearItem is a lightweight multilingual item cleanup plugin with modern messages, PlaceholderAPI support, LuckPerms permissions, world filters and optimized dropped-item removal.
Discord: PideMann If you find any bugs or need support, you can contact me here.
