ClearLag automatically removes dropped items at configurable intervals to prevent server lag, with customizable warnings, item whitelisting, and real-time memory tracking—all manageable in-game.
ClearLag is a powerful, intelligent item management plugin for Minecraft 1.21+ that automatically removes dropped items to prevent server lag while giving you complete control over what gets cleared and when.
Dropped items are one of the most common causes of server lag. Whether from mob farms, player deaths, or accidental drops, these entities accumulate quickly and can severely impact performance.
ClearLag solves this by running a configurable timer that automatically removes ground items at set intervals. The plugin tracks both the number of item entities (piles) and the total items including stack sizes, giving you accurate feedback. For example, clearing 5 stacks of 64 cobblestone will report "320 items (5 piles) cleared" rather than just "5 items."
Before each clear, players receive customizable warnings at intervals you define (default: 60s, 30s, 10s), giving them time to pick up important items. The whitelist system ensures valuable items are never accidentally removed.
The plugin is designed with zero server impact in mind. Item clearing happens instantly with no lag spikes, and the timer runs asynchronously without blocking the main thread. Memory tracking uses Java's native runtime monitoring to show exactly how much memory is freed, helping you optimize clearing intervals for your server's needs.
The warning system prevents spam by tracking which warnings have been sent, ensuring each warning time broadcasts only once per cycle.
The plugin works out of the box, but is fully customizable via plugins/ClearLag/config.yml or directly in-game.
/clearlag — Manually clear items immediately (clearlag.clear)/clearlag now — Force immediate clear without warnings (clearlag.clear)/clearlag toggle — Enable/disable auto-clearing (clearlag.toggle)/clearlag reload — Reload configuration from file (clearlag.reload)/clearlag info — Display current configuration and status (clearlag.clear)/clearlag set <setting> <value> — Change a setting in-game (clearlag.config)/clearlag add <list> <value> — Add to whitelist, world list, or warning times (clearlag.config)/clearlag remove <list> <value> — Remove from whitelist, world list, or warning times (clearlag.config)Aliases: /cl, /itemclear
ClearLag is a server-side plugin designed for Paper/Spigot 1.21+ (compatible with all modern versions). Simply drop the JAR into your plugins folder and restart your server. A plugins/ClearLag/config.yml file will be created automatically with sensible defaults.
Unlike most plugins, ClearLag lets you change every setting without editing files:
/clearlag set interval 120 # Change to 2 minutes
/clearlag set color AQUA # Change message color
/clearlag add whitelist DIAMOND # Protect diamonds
/clearlag add warning 5 # Add 5-second warning
/clearlag remove warning 30 # Remove 30-second warning
/clearlag set clear-xp-orbs true # Start clearing XP orbs
All changes take effect immediately and are saved to the config file automatically.