Updated for 26.x+

Changelog

• Added support to Mythic Mobs
• Updated CLE Wiki
• Fixed placeholders

This update focuses on better integration for our Citizens NPCs, ensuring they stay safe, protected, and permanent!

CHangelog

• Protected NPCs: All Citizens NPCs are now officially recognized by our protection systems. They are now immune to accidental player damage and environmental hazards in protected zones.
• No More "Disappearing" Shopkeepers: We’ve updated our entity-clearing logic. While we still clear out lag-causing mobs, the system now skips over NPCs entirely so they won't accidentally be deleted during server cleanups.
• Improved Stability: General behind-the-scenes tweaks to make sure NPCs and protection settings play nice together.

🚀 Performance & Optimization Update

🛡️ 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.

Complete Rework Update

We have spent a long time reworking this plugin. We have done the following.

• Not only that, but we also made a Wiki as well. Click Here for WIki
• Check the full Changelog On Modrinth

🚀 Features & Core Enhancements

• Database Overhaul: Full support for both SQLite and MySQL. Includes strict configuration parsing and schema versioning to ensure your data stays safe and migrations happen smoothly.
• Cleaner Reloads: Centralized the core shutdown process. This fixes a technical "leak" where the database pool wouldn't close properly during a reload, making the plugin much more stable during configuration changes.
• Authoritative Configuration: The config.yml is now the definitive source of truth for all module toggles. Toggling modules via the Admin GUI now syncs perfectly with your config file.
• Protection Settings: Added a new ProtectionSettings record to better manage how your entities and areas are guarded.

🛡️ Logic & Safety Fixes

• Smart Spawner Limiter: Fixed a potential crash (NullPointerException) that occurred when the Spawner Limiter was active while the Mob Limiter was disabled.
• Enhanced Command Security: All /lagg subcommands are now gated through a central permission checker. This ensures that permissions are enforced consistently across the board, including within Tab-Completion.
• Cycle Safeguards: Improved logic for clearing entities to prevent infinite loops and duplicate processing.

🔌 Compatibility & Integrations

• WildStacker Support: Fully implemented the WildStacker API integration. The plugin now correctly detects and handles stacked entities and items managed by WildStacker.
• ModernShowcase Integration: Improved the loading order for ModernShowcase. The plugin now detects it dynamically, ensuring showcase items are protected immediately without requiring a manual reload.
• Improved Documentation: Refreshed the config.yml with clearer headers and descriptive comments to make manual editing easier.

🛠️ Technical Changes

• Added ChatInputManager for more robust handling of player inputs.
• Standardized module configuration saving logic.
• Bumped project version to 2026.4.1.

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.