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 the GUI and place item types into the menu. When the menu is closed, ClearItem saves the selected item materials into items.yml.

This makes blacklist management much easier for server owners who do not want to manually type material names.

Player trash bin

ClearItem v1.2.0 adds a virtual player trash bin.

Commands:

/trash /cop /çöp

Permission:

clearitem.command.trash

Players can open a virtual trash inventory and place unwanted items inside it. Items placed in the trash bin are permanently deleted.

This helps reduce inventory clutter and can reduce the number of useless items players throw onto the ground.

The trash bin is especially useful for survival, skyblock, towny, economy and faction servers where players frequently collect unwanted blocks, mob drops or farm items.

TPS emergency cleanup

ClearItem includes a TPS trigger system. If enabled, the plugin can run an emergency cleanup when server TPS drops below a configured threshold.

Config options:

tps-trigger: enabled: true threshold: 16.0 check-interval-seconds: 30 cooldown-seconds: 180

This system helps servers react automatically when too many entities may be contributing to lag.

The cooldown prevents emergency cleanup from running too often.

Analytics and cleanup reports

ClearItem can write detailed cleanup reports to the console and to an analytics log file.

Analytics can include:

Cleanup mode Removed item amount Removed entity count Cleanup duration World-based removal counts Material-based removal counts Current TPS for emergency cleanups

Log file location:

plugins/ClearItem/logs/analytics.log

This is useful for server owners who want to understand how much cleanup is happening and which worlds generate the most removable items.

Update checker

ClearItem can check for official new versions and notify server staff.

Update notifications can be sent to:

Console Online admins OP players when they join Players with clearitem.admin when they join

If a new version is available, ClearItem sends a chat message to authorized staff after they enter the server.

Config options:

updates: enabled: true notify-admins: true notify-console: true join-delay-seconds: 3

This helps server owners notice new plugin versions without constantly checking the download page manually.

Multilingual system

ClearItem includes 16 built-in language files.

Built-in languages:

English Turkish Spanish German French Italian Portuguese Russian Chinese Japanese Korean Dutch Polish Arabic Hindi Indonesian

The active language can be changed in config.yml:

language: active: en

Language files are stored in:

plugins/ClearItem/language/

Server owners can edit messages directly from these files.

Language-based subcommands

The main command always stays the same:

/clearitem

Subcommands can change depending on the selected language.

English example:

/clearitem clear /clearitem reload /clearitem time /clearitem status /clearitem help /clearitem menu

Turkish example:

/clearitem temizle /clearitem yenile /clearitem süre /clearitem durum /clearitem yardım /clearitem menu

Spanish example:

/clearitem limpiar /clearitem recargar /clearitem tiempo /clearitem estado /clearitem ayuda /clearitem menu

This allows players and staff to use commands that match the server language while keeping /clearitem consistent.

LuckPerms support

ClearItem automatically detects LuckPerms if it is installed.

If LuckPerms is not installed, ClearItem uses the normal Bukkit permission system.

LuckPerms support is useful for assigning cleanup permissions to different staff ranks.

Config option:

luckperms: hook-check: true

Permissions

clearitem.admin

Gives access to every ClearItem admin command and admin feature.

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 and LuckPerms hook status.

clearitem.command.help

Allows viewing the help menu.

clearitem.command.trash

Allows using the virtual trash bin with /trash, /cop or /çöp.

LuckPerms examples

/lp group admin permission set clearitem.admin true

/lp group moderator permission set clearitem.command.clear true

/lp group moderator permission set clearitem.command.reload true

/lp group helper permission set clearitem.command.time true

/lp group helper permission set clearitem.command.status true

/lp group default permission set clearitem.command.trash true

PlaceholderAPI support

ClearItem automatically hooks into PlaceholderAPI if PlaceholderAPI is installed.

Available 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 false

%clearitem_language%

Shows the active language code.

Example:

en tr es

These placeholders can be used in scoreboards, tab lists, holograms, menus or any other plugin that supports PlaceholderAPI.

Commands

/clearitem clear

Manually starts cleanup.

/clearitem reload

Reloads config, language files and item filters.

/clearitem time

Shows the remaining time until the next automatic cleanup.

/clearitem status

Shows plugin status, next cleanup time and LuckPerms hook status.

/clearitem help

Shows the ClearItem command help menu.

/clearitem menu

Opens the graphical admin menu.

/trash

Opens the player trash bin.

/cop

Alternative trash command.

/çöp

Turkish trash command alias.

/ci

Alias for /clearitem.

Configuration overview

Default language:

language: active: en

Cleanup interval:

cleanup: interval: 5m

Warning times:

cleanup: warnings: - 60 - 30 - 10 - 5

Dropped-item only mode:

cleanup: only-ground-items: true

Extended cleanup:

cleanup: remove-xp-orbs: false remove-hostile-mobs: false remove-unowned-vehicles: false

World filter:

worlds: mode: BLACKLIST list: []

TPS trigger:

tps-trigger: enabled: true threshold: 16.0 check-interval-seconds: 30 cooldown-seconds: 180

Analytics:

analytics: enabled: true log-file: true

Update checker:

updates: enabled: true notify-admins: true notify-console: true join-delay-seconds: 3

Performance

ClearItem is designed to be lightweight. It does not scan the server every tick. The normal cleanup scan runs only when the cleanup timer reaches zero or when an authorized user manually starts cleanup.

The TPS trigger uses a configurable check interval and cooldown, so emergency cleanup does not constantly run.

By default, ClearItem only targets dropped item entities. XP orbs, hostile mobs and empty vehicles are only removed if the server owner explicitly enables extended cleanup.

Items are removed during the cleanup operation, and stack amounts are counted correctly. This keeps the final cleanup message accurate and prevents misleading reports.

Why use ClearItem?

ClearItem is useful for servers that want:

Cleaner worlds Fewer dropped item entities Configurable automatic cleanup Simple staff commands An easy GUI admin menu A player trash command World-specific cleanup control Protected valuable items Multilingual command support LuckPerms integration PlaceholderAPI integration Update notifications for staff Detailed analytics reports Java 8 compatibility Wide Minecraft version support

Short description

ClearItem is a lightweight multilingual cleanup plugin with automatic item cleanup, optional XP/mob/vehicle cleanup, GUI admin tools, a player trash bin, PlaceholderAPI support, LuckPerms permissions, world filters, item filters, TPS emergency cleanup, analytics and update notifications.

Discord

PideMann

If you find any bugs or need support, you can contact me here.