ClearItem

ClearItem - Smart, Lightweight Item and Entity Cleanup ClearItem is a clean, fast and multilingual cleanup plugin for Bukkit, Spigot and Paper based Minecraft servers. It is designed to keep server worlds cleaner by removing dropped items automatically, while still giving server owners full control over what gets cleaned, when cleanup happens, which worlds are affected and who can use each command. ClearItem focuses on being lightweight, simple to configure and safe for everyday survival servers. It includes automatic cleanup, manual cleanup, warning messages, a graphical admin menu, a player trash bin, PlaceholderAPI support, LuckPerms support, update notifications and multilingual command support. Supported Versions ClearItem is built with Java 8 compatibility and uses the Bukkit/Spigot 1.16 API as its compatibility base. Supported Minecraft server range: Minecraft 1.16.5 up to modern 1.21.x servers. The plugin is intended for Bukkit, Spigot and Paper based servers. Main Features Lightweight dropped-item cleanup ClearItem automatically removes dropped ground item entities after a configurable interval. This helps reduce entity buildup, improves world cleanliness and can help reduce performance pressure caused by too many dropped items. Correct stack counting ClearItem counts actual item amounts, not just entity stacks. For example, a stack of 64 diamonds is counted as 64 removed items, not as 1 removed entity. Cleanup messages and analytics reports show more accurate numbers. Configurable cleanup interval Server owners can choose how often automatic cleanup runs. The interval supports simple time formats such as seconds, minutes, hours or raw seconds. Supported interval examples: 30s 5m 1h 300 Warning messages before cleanup ClearItem can broadcast warning messages before cleanup happens. Warning times are configurable, allowing players to pick up important items before the cleanup starts. Example warning times: 60 seconds 30 seconds 10 seconds 5 seconds Manual cleanup command Authorized staff members can manually start cleanup at any time with the clear command. This is useful when a world has too many dropped items or when staff want to clean the server immediately. World blacklist and whitelist system ClearItem can control which worlds are affected by cleanup. BLACKLIST mode: Listed worlds will not be cleaned. WHITELIST mode: Only listed worlds will be cleaned. This makes it possible to exclude event worlds, farm worlds, minigame worlds, admin test worlds or any other special world. Item blacklist and whitelist system ClearItem includes an items.yml filter file. Server owners can choose whether listed materials are protected or whether only listed materials should be cleaned. BLACKLIST mode: Items listed in items.yml are protected and will not be removed. WHITELIST mode: Only items listed in items.yml will be removed. This is useful for protecting valuable items such as diamonds, netherite tools, rare drops or custom economy items. New in ClearItem v1.2.0 Advanced entity cleanup ClearItem is no longer limited to dropped item cleanup only. Server owners can optionally enable extended cleanup for additional entity types. Optional XP orb cleanup ClearItem can remove XP orb entities when enabled in config.yml. This can help servers where XP farms or player deaths create too many XP orbs. Optional hostile mob cleanup ClearItem can remove hostile mobs when enabled in config.yml. This can help reduce entity pressure in worlds where hostile mobs build up. Optional unowned vehicle cleanup ClearItem can remove empty and unoccupied vehicles when enabled in config.yml. This includes unused boats and minecarts that are not carrying passengers. Safe default behavior By default, ClearItem keeps the old focused behavior and only removes dropped ground items. Extended cleanup must be enabled manually in config.yml. Extended cleanup config options: cleanup: only-ground-items: true remove-xp-orbs: false remove-hostile-mobs: false remove-unowned-vehicles: false Important: If cleanup.only-ground-items is true, ClearItem only removes dropped item entities. If cleanup.only-ground-items is false, the extra cleanup switches can be used. Graphical admin menu ClearItem v1.2.0 adds an in-game graphical admin menu. Staff can open it with: /clearitem menu Permission: clearitem.admin The admin menu includes: Live next-cleanup timer One-click manual cleanup button Item blacklist editor Simple chest-style interface The menu is designed for staff members who prefer managing cleanup from inside the game instead of editing files manually. Live cleanup timer in GUI The admin menu shows the remaining time until the next automatic cleanup. The timer refreshes while the menu is open. One-click cleanup Admins can start cleanup directly from the GUI without typing the clear command. Drag-and-drop item blacklist editor Admins can open the item blacklist editor from th