ClearLaggEnhanced

A modern, high-performance lag prevention plugin for Minecraft servers running Paper, Spigot, and Folia. Designed to help server owners maintain optimal server performance through intelligent entity management, advanced lag prevention systems, and real-time performance monitoring.

✨ Special Thanks: To bob7l, the original developer of ClearLagg, whose pioneering work inspired this enhanced version.

📚 Documentation

Full documentation is available in the Wiki.

✨ Key Features

• Automatic Entity Clearing - Smart entity removal with comprehensive protection systems
• Advanced Lag Prevention - Three specialized modules (Mob Limiter, Spawner Limiter, Misc Entity Limiter)
• Real-Time Monitoring - Live TPS and memory tracking with color-coded indicators
• Interactive Admin GUI - Graphical interface for easy configuration and monitoring
• Folia Support - Full compatibility with Folia's regionized threading system
• Performance Database - Optimized SQLite/MySQL storage with HikariCP connection pooling
• Smart Configuration - Automatic updates while preserving your changes and comments
• Plugin Integrations - Full support for ModernShowcase, RoseStacker, WildStacker, and GriefPrevention3D
• PlaceholderAPI - Rich placeholder support for other plugins

📦 Quick Start

Requirements

• Minecraft: 1.20+
• Server: Paper, Spigot, or Folia
• Java: 21 or higher

Installation

1. Download from Modrinth
2. Place in your plugins folder
3. Restart your server
4. Configure in plugins/ClearLaggEnhanced/config.yml
5. Reload with /lagg reload

🎮 Basic Commands

Command	Description	Permission
/lagg help	Display the help menu	CLE.help
/lagg clear	Manually clear entities now	CLE.clear
/lagg clearstatus	View detailed entity clearing module status	CLE.clearstatus
/lagg next	Show time until next automatic clear	CLE.next
/lagg tps	Display current server TPS	CLE.tps
/lagg ram	Display detailed server memory usage statistics	CLE.ram
/lagg chunkfinder	Locate laggy chunks with high entity counts	CLE.chunkfinder
/lagg admin	Open the admin GUI	CLE.admin
/lagg reload	Reload plugin configuration	CLE.reload

Aliases:/clearlagg, /clearlag, /cl, /cle

🔧 Modules

Entity Clearing Module

Automatically clears entities at configurable intervals with smart protection for named, tamed, stacked, and custom-tagged entities.

• Intelligent Protection: Support for peaceful mobs (Animals, Villagers, Golems, etc.) in claims, mobs in boats, bred mobs, plugin-managed entities, and scoreboard tags.
• Adaptive Scheduling: Dynamically adjust clear intervals based on entity or player count.
• Performance Gates: Defer clears while server MSPT is healthy (excludes Folia).
• Integration Support: Built-in protection for GriefPrevention (standard & 3D), ModernShowcase, RoseStacker, and WildStacker.

Mob Limiter Module

Controls entity spawning per chunk with global and per-type limits. Prevents excessive mob spawning that causes lag.

Spawner Limiter Module

Controls spawner activation rates with configurable delay multipliers and mob cap integration.

Misc Entity Limiter Module

Manages non-mob entities like armor stands, boats, item frames, and paintings with per-chunk limits and protection options.

Chunk Finder Module

Locate laggy chunks with high entity counts. Helps identify problem areas quickly.

Performance Module

Real-time TPS and memory monitoring with color-coded indicators and detailed statistics.

📊 PlaceholderAPI Support

If PlaceholderAPI is installed, use these placeholders in other plugins:

• %clearlaggenhanced_tps% - Current server TPS
• %clearlaggenhanced_memory_used% - Used memory in MB
• %clearlaggenhanced_memory_max% - Maximum memory in MB
• %clearlaggenhanced_memory_percentage% - Memory usage percentage
• %clearlaggenhanced_entities_total% - Total entities on server
• %clearlaggenhanced_next_clear% - Seconds until next clear
• %clearlaggenhanced_next_clear_formatted% - Human-readable time until next clear (e.g., "5m 20s")

🤝 Support

• GitHub Issues:Report bugs or request features
• Documentation:Full documentation
• Discord: Join the community on Discord for support and to suggest new ideas.

🙏 Credits

• bob7l - Original ClearLagg developer
• djtmk - ClearLaggEnhanced developer and maintainer
• BusyBee Development - Development team
• R00tB33rMan – Folia support and contributor
• MrTroxy – Help with modular support in version 2026.4.0
• All contributors and community members

📄 License

ClearLaggEnhanced is licensed under the BusyBee AAR License.