To view the full changelog please click here

🛠️ Fixes & Refinements

• Enhanced Stacked Entity Protection: Refined and optimized the internal checks for custom naming and custom NBT tags on stacked entities. This ensures that unique, named, or custom-tagged entities are more accurately identified and protected from accidental merging or clearing.
• Folia Fixes Fixed the issue with folia not running on the correct thread for world entity checks. Please update to the newest version.

🚀 New Features

• FoliaUpdateNotifier: Added a dedicated update checker and logger for Folia server environments. The plugin will now automatically check for and log available updates directly in the console, ensuring your Folia server stays up-to-date with the latest performance and stability improvements.

⚡ Optimization & Fixes

• Faster Sweeps: Miscellaneous entity processing is now handled more efficiently by targeting and scheduling chunk processing at specific locations rather than sweeping blindly.
• Reliable Scheduling: Refactored internal timers to resolve some scheduling inconsistencies, ensuring automated tasks and performance gates trigger exactly when they are supposed to.

To view the full changelog please go to CLE Changelog

⚙️ Configuration & Features

• Mob Limiter Expansion: Added a new ignore-spawners option to the mob limiter configuration, giving server administrators finer control over which entities are targeted by clear cycles.

🛠️ Backend & Performance

• Internal Package Refactor: Updated internal package paths to net.busybee.clearlagenhanced for better consistency, improved project structure, and modernized build configurations.
• Dependency Updates: Updated internal project versions, compiler source/target compatibility, and shaded library paths to optimize overall resource usage.
• Metrics Integration: Integrated BStats and FastStats metrics frameworks to significantly enhance real-time performance monitoring, lag tracking, and server health analytics.

Updated for MC Version 26.x+

✨ FEATURES

• MythicMobs Support: Native integration ensuring Mythic entities are correctly identified and handled by protection systems.

🐛 FIXES

• Placeholders: Resolved an issue where certain PAPI expansion values were not displaying or updating correctly.

🔧 CHANGES

• Documentation: Refreshed the internal and external Wiki links to reflect new integration settings.

✨ FEATURES

• Citizens Integration: All Citizens NPCs are now officially recognized and protected from clearing cycles.
• Environmental Immunity: NPCs in protected zones are now immune to accidental player damage and environmental hazards.

🐛 FIXES

• Entity Logic: Refined clearing logic to ensure shopkeepers and custom NPCs are never accidentally deleted.

⚡ PERFORMANCE

• Stability: General internal optimizations regarding NPC-to-protection-module communication.

🔧 CHANGES

• Code Refactoring: Cleaned up several legacy manager classes to improve maintainability.
• Dependency Updates: Updated internal libraries to ensure compatibility with the latest Paper/Spigot builds.

🚀 Performance & Optimization Update

**Full Changelog: Click Here

🛡️ Smart Entity Management

• Adaptive Intervals: The plugin now dynamically adjusts clearing frequency based on server load.
• MSPT Performance Gate: Clearing tasks now wait for a healthy performance window before executing, preventing "lag-clearing-lag."
• Tag Protection: Added configuration to protect specific entities from clearing via entity tags.
• New Status Command: Monitor your adaptive intervals and performance gates in real-time.

⚡ Optimization & Fixes

• Mob Limiter Boost: Optimized protection checks to reduce CPU overhead during mob limiting.
• Faster Sweeps: Miscellaneous entity processing is now handled more efficiently across chunks.
• Reliable Reloads: Refactored the plugin reload process to ensure all listeners and services cycle correctly without memory leaks.
• Startup Stability: Fixed a critical crash during the protection settings initialization.

🎨 UI & Quality of Life

• FastInv Migration: Menus are now faster and more stable thanks to the FastInv framework.
• Improved GUIs: The entity management interface now supports and displays adaptive interval settings.
• Consistency: Standardized ChatColor usage and updated help entries for better clarity.

✨ FEATURES

• Database Overhaul: Full support for SQLite and MySQL with strict schema versioning.
• Protection Settings: Added the ProtectionSettings record for granular entity and area safeguards.
• ChatInputManager: Implemented for more robust player input handling in the Admin GUI.

🐛 FIXES

• Memory Leaks: Fixed a leak where database pools wouldn't close during plugin reloads.
• Logic Cycles: Improved clearing logic to prevent infinite loops and duplicate entity processing.
• Permissions: Standardized permission checks across all subcommands and tab-completion.

🔌 INTEGRATIONS

• WildStacker: Native API support for stacked entities and items.
• ModernShowcase: Optimized loading order for immediate protection of showcase items.

🔧 CHANGES

• Config Authority: The config.yml now overrides Admin GUI toggles to maintain a consistent "source of truth."
• Configuration: Complete refresh of config.yml with clearer headers and helpful comments.

Changelog - Version 2026.3.1

🛡️ Entity Protection & Management

• Armored Entity Safekeeping: Introduced the protect-armored-entities configuration option. When enabled, the clearing logic will now skip any entities equipped with armor (Armor Stands, Zombies, Skeletons, etc.).
• Logic Updates: * Refactored LagPreventionManager and EntityManager to respect protection flags.
  • Adjusted auto-clear routines to include armored entity detection during sweeps.

⚙️ System & Internal Improvements

• Smarter Config Migration: Refactored ConfigMigrator for a more maintainable and reliable YAML merging strategy during updates.
• Enhanced Debugging: Improved logging and internal timers for better task management and performance tracking.
• Refined Stability: Enhanced error handling for configuration reloads and minor internal improvements to the NotificationManager.

📦 Technical Changes

• Refactoring: Cleaned up core entity management classes to improve long-term maintainability.

ChangeLog

• Smart Config Migration: Introduced ConfigMigrator for intelligent YAML merging. It now preserves your custom comments while automatically injecting new keys and removing obsolete ones.
• Automatic Backups: The system now generates safety backups before performing configuration updates.
• Version Bump: Project version updated to 2026.3.0.

If you're upgrading from an older version, please check your plugins/CLE/backups folder for copies of your previous configurations.

🚀 Version 2026.2.2

🛠 Core Improvements & Cleanup

• General Refactor: Cleaned up multiple aspects of the codebase and removed several unused aspects to improve maintainability.
• Paper Optimization: Migrated chunk loading to utilize getChunkAtAsync for better server performance and reduced main-thread hitching.
• Configuration Logic: * Implemented "Smart Configuration" updates that preserve user comments during config merges.
  • Bumped internal config-version and messages-version.

🛡 Entity & Stacking Logic

• Stacking Fix: Prevented stacking logic from erroneously affecting players.
• Behavior Update: Adjusted default behavior for stacked entities (protect-stacked-entities now defaults to false).
• Entity Limits: Removed default chunk limits for ARMOR_STAND, ITEM_FRAME, and GLOW_ITEM_FRAME to prevent unintended despawning of decorative items.

Changelog

• Code clean-up and optimization

✨ FEATURES

• PlaceholderAPI Expansion: Added ClearLaggEnhancedExpansion for use in scoreboards and tab lists.
• bStats: Added metrics tracking to help visualize global performance trends.

⚡ PERFORMANCE

• Task Management: Replaced legacy scheduler methods with WrappedTask for more efficient task cancellation.

🔧 CHANGES

• Shutdown Logic: Centralized the cleanup process to ensure all managers shut down gracefully during reloads.

🚀 CLE Beta-v2.3

Config Version: 5

💡 Note: This update introduces a new config version (5).
Existing configurations will be automatically merged with new defaults.

Changes:

• Added more than one notification feature. (Can have all 3 notification methods enabled if you so wish.)
• Code cleanup
• Changed config version to #4 (Should auto update when you run the new update)

Updates:

• Removed Hopper Limiter due to high thread usage.
• Removed Redstone Limiter due to aggressive behavior.

Redstone Limiter will return after the rework is complete. No need to update the plugin, disable those two features.

Update 2.0 The Folia Update!

• Reworked redstone limiter
• 100% supports folia
• Updated README
• Optimized plugin performance (0.1% thread usage)
• Optimized SQLite Database

A helpful guide for the Redstone Limiter:

redstone-limiter:
  enabled: true              # Set to true to enable
  reset-period-ms: 4000      # Reset counters every 4 seconds

  blocks:
    enabled: true
    threshold:
      GLOBAL: 6              # Default limit for all redstone blocks
      PISTON: 6              # Pistons can activate 6 times per reset period
      OBSERVER: 12           # Observers can trigger 12 times per reset period
      DISPENSER: 6
      REPEATER: 10
      HOPPER: 12

  chunks:
    enabled: true
    threshold: 4000          # Maximum total redstone events per chunk

  max-piston-push: 12        # Maximum blocks a piston can push at once

redstone-limiter:
  enabled: true
  blocks:
    threshold:
      PISTON: 10           # Allow more complex contraptions
      OBSERVER: 20
      REPEATER: 15
  chunks:
    threshold: 8000        # Higher limit for creative builds

redstone-limiter:
  enabled: true
  blocks:
    threshold:
      PISTON: 6            # Standard settings work well
      OBSERVER: 12
  chunks:
    threshold: 4000

redstone-limiter:
  enabled: true
  blocks:
    threshold:
      PISTON: 4            # Stricter limits
      OBSERVER: 8
      REPEATER: 6
  chunks:
    threshold: 2000        # Lower chunk threshold
  max-piston-push: 8       # Reduce piston push limit

Special Thanks to R00tB33rMan for helping make this update possible. If you have any bugs please join the Discord and report them. <3

ClearLaggEnhanced Changelog

[1.4-Beta]

✨ Added

• Lombok Support - Added Lombok framework for cleaner code
• Database Indexes - Added 3 strategic indexes to laggy_chunks table for 10-100x faster queries
  • idx_laggy_chunks_world - Fast world filtering
  • idx_laggy_chunks_entity_count - Fast sorting by entity count
  • idx_laggy_chunks_composite - Fast chunk lookups by coordinates
• Auto-Update System - Config and messages files now automatically update while preserving user customizations
  • Automatic backups created (e.g., config.yml.backup-v1)
  • Smart merging of new values with user settings
  • Version tracking for both config.yml and messages.yml
• Professional Messages - Complete overhaul of messages.yml
  • Consistent color scheme with documentation
  • Added icons (✓, ✗, ⚠, ⏰, ⚡, etc.)
  • Better formatting with borders and bullets
  • All messages now properly colored
• Java Records - Converted data classes to use modern Java 17 records

🔧 Changed

• Entity Clearing Logic - Completely refactored for better UX
  • BREAKING: Removed confusing blacklist system
  • Now uses whitelist-only approach: "Clear everything EXCEPT whitelisted entities"
  • Items on ground (DROPPED_ITEM) now properly clear by default
  • Living entities clear by default unless whitelisted
  • Much more intuitive for server owners
• Database Schema - Changed world column from TEXT to VARCHAR(255)
  • 50-70% storage reduction for world names
  • Better indexing performance
• Config Defaults - Updated default world list
  • Changed from ["world_nether", "world_the_end"] to [] (all worlds)
  • More sensible defaults for new installations
• Whitelist - Refined default protected entities
  • Added: CAT, PARROT, GLOW_ITEM_FRAME, CHEST_MINECART, FURNACE_MINECART, HOPPER_MINECART, CHEST_BOAT
  • Removed: OAK_BOAT (consolidated to BOAT)

⚡ Performance

• Main Thread Optimization - Removed unnecessary runTask() calls
  • ClearCommand.java - Direct execution (saves ~1-2ms per operation)
  • MobLimiterListener.java - Direct execution in MONITOR event
  • Reduced main thread blocking and task queue overhead
• Database Performance - Query speed improvements with new indexes
  • ChunkFinder queries 10-100x faster as data grows
  • Efficient world-specific filtering
  • Optimized sorting by entity count

🐛 Fixed

• Entity Clearing Bug - Items on ground now properly clear
  • Previous logic only cleared items in blacklist
  • New logic clears all non-whitelisted entities
• Config Migration - Improved existing migration system
  • Better handling of deprecated keys
  • Clearer console output during migration
  • Fixed edge cases in setting preservation

🗑️ Removed

• Blacklist System - Removed from config.yml (36 lines)
  • Confusing two-list system replaced with simpler whitelist-only
  • Old blacklist entries automatically converted during migration

📝 Technical Details

• Lombok Dependency: 1.18.30
• Config Version: 1 → 2 (auto-migration implemented)
• Messages Version: 1 → 2 (auto-migration implemented)
• Java Version: 17 (using records and text blocks)
• Code Cleanup: Removed all inline comments per project style

Migration Guide

From 1.3 to 1.4

Automatic Migration

When you first start v1.4, the plugin will:

1. Detect outdated config (v1) and messages (v1)
2. Create backups: config.yml.backup-v1 and messages.yml.backup-v1
3. Merge your customizations with new defaults
4. Log all migrated settings to console

Manual Steps (Optional)

None required! Everything is automatic.

Breaking Changes

1. Blacklist Removed: If you relied on blacklist behavior, adjust your whitelist:
   • Old: Blacklist = entities to clear
   • New: Whitelist = entities to protect, everything else clears

Reverting

If you need to revert:

1. Stop server
2. Restore from backup: cp config.yml.backup-v1 config.yml
3. Edit config-version: 1 in config.yml
4. Start server with old plugin version

Performance Impact