⚙️ Installation

• 1. Download the plugin .jar file
• 2. Place it into your /plugins folder
• 3. Start or restart your server
• 4. Edit the config file if needed: /plugins/ClearQuick/config.yml

✔ Done! The plugin will start cleaning automatically.


Basic Usage

ClearQuick works automatically after installation.

• Removes dropped items and XP orbs
• Runs cleanup based on configured interval
• Prevents lag caused by entity buildup
• Can trigger emergency cleanup if too many items exist

⌨️ Commands

Command	Description
/clearquick reload	Reload configuration
/clearquick interval <seconds>	Change cleanup interval
/clearquick clear	Run cleanup instantly
/clearquick toggle	Enable/disable auto cleanup
/clearquick status	View plugin status
/cq	Short alias
/lagg	Alternative alias

Permissions

Permission	Description
clearquick.admin	Access to all commands
clearquick.notify	Receive cleanup notifications

⚙️ Configuration Guide

File: /plugins/ClearQuick/config.yml

Important settings:

• interval → Time between cleanups (seconds)
• auto-cleanup-enabled → Enables emergency cleanup
• auto-cleanup-threshold → Max items before emergency trigger
• clean-items → Enable item cleanup
• clean-xp-orbs → Enable XP cleanup
• excluded-worlds → Worlds that won't be cleaned
• items-whitelist → Items that will never be removed

⚡ Performance Tips

• Use chunks-per-tick to control performance impact
• Lower values = safer for big servers
• Higher values = faster cleanup
• Recommended:
  • Small servers → 50
  • Large servers → 25

Emergency Cleanup System

ClearQuick includes a smart emergency system:

• Detects item spawn in real time
• Triggers cleanup instantly when threshold is reached
• No constant loops or lag checks
• Prevents massive lag spikes (TNT, farms, etc.)

❓ FAQ

Does it cause lag?
No. It is optimized to reduce lag using batch processing and event-based logic.

Can I disable XP cleanup?
Yes, in the config.yml file.

Can I protect items?
Yes, using the whitelist system.

Does it work on all versions?
Yes, from 1.12.2+ on Spigot and Paper.