ClearLagV2

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.

Key Features

• Configurable Auto-Clear: Set intervals from 1 second to 24 hours for automatic item removal
• Memory Tracking: Displays exactly how much memory (in MB) is freed after each clear
• Item Whitelist: Protect valuable items like netherite, elytras, and totems from being cleared
• Warning System: Customizable countdown warnings before items are removed (no spam)
• In-Game Configuration: Change every setting without touching the config file
• World-Specific Clearing: Choose which worlds to clear items in
• XP Orb Support: Optionally clear experience orbs to reduce entity lag

Functionality

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.

Safety & Performance

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.

Configuration

The plugin works out of the box, but is fully customizable via plugins/ClearLag/config.yml or directly in-game.

• Interval: Set clearing interval in seconds (1–86400, Default: 300)
• Warnings: Define when to warn players before clearing (Default: 60, 30, 10 seconds)
• Whitelist: Specify items that should never be cleared (Default: netherite, elytra, totems)
• Worlds: Choose specific worlds to clear, or leave empty for all worlds
• XP Orbs: Toggle whether to clear experience orbs (Default: false)
• Messages: Customize warning and clear messages with placeholders ({time}, {count}, {entities}, {memory})
• Color: Set message color (Default: GREEN)

Commands & Permissions

• /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

Installation

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.

In-Game Management

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.