LagXpert v2.6.1 - Hotfix

🐛 Bug Fixes

Fixed: Limit messages showing raw YAML objects

Players were seeing MemorySection[path='limits.hopper', root='YamlConfiguration'] instead of actual alert messages when placing blocks near or at chunk limits.

What changed:

• 
  
• messages.yml now uses a structured format with full and short sub-keys per message.
• ActionBar restriction messages now properly use the short variant.

Action required: Delete your existing plugins/LagXpert/messages.yml and restart the server to regenerate it, or manually update the limits: section to use the new full/short structure.

Fixed: IllegalArgumentException: Specified map is empty in AsyncChunkAnalyzer

Server log was spamming this error when analyzing chunks with no tile entities (empty chunks, deserts, oceans, etc.).

Action required: None. Just update the JAR.

Fixed: Missing message: lagshield.activated in console

LagShield was looking for messages at the wrong path in messages.yml.

Action required: None. Just update the JAR.

✨ Improvements

Translatable block and entity names in statistics

All block and entity names shown in /chunkstatus, /lagxpert inspect, chunk scan alerts, and near-limit warnings are now fully customizable from messages.yml.

A new translations: section lets you rename items like "Hoppers", "Chests", "Mobs", etc. to match your server's language. The /chunkstatus display is also fully customizable with individual line formats.

Action required: Delete your existing plugins/LagXpert/messages.yml and restart the server to regenerate it with the new translations: and chunkstatus: sections. Then edit the names to your language.

Fixed: Chests and Trapped Chests duplicated in scan statistics

Chests and Trapped Chests were showing as two separate entries in chunk overload alerts, even though they share the same limit. They are now combined into a single "Chests" entry. Same fix applied to Pistons/Sticky Pistons.

Fixed: Entity cleanup message showing raw color codes

The entity cleanup broadcast message (&a, &e, etc.) was not being translated to actual colors, showing raw codes like &e18&a in chat.

📦 Upgrade

1. 
   
2. Replace LagXpert-2.6.jar with LagXpert-2.6.1.jar.
3. Delete plugins/LagXpert/messages.yml (will regenerate on startup with new translation options).
4. Restart the server.
5. Edit the translations: section in messages.yml to your language.

LagXpert v2.6 - Reactive Optimization & Modular Control

This update introduces advanced modules for proactive performance management, including AI optimization, lag shields, and specific controls for vehicles and explosions.

🚀 Highlights

• 
  
• MobAIOptimizer: Intelligent system that disables AI and pathfinding for mobs in loaded chunks to drastically reduce CPU usage.
• LagShield: Emergency monitor that automatically activates severe restrictions when TPS drops below 16.0 or RAM exceeds 90%.
• ExplosionController: Full control over TNT, Creeper, and Wither explosions. Includes radius limits and prevention of massive chain reactions.
• VehicleManager: Configurable per-chunk limits for minecarts and boats, with automatic cleanup of abandoned vehicles.
• AbilityLimiter & ConsoleFilter: Speed restrictions for Elytras, cooldowns for Tridents, and Regex-based console spam filtering.

⚙️ Configuration Examples

explosions.yml - Prevent massive TNT chain reactions:

settings:
  prevent-chain-reaction: true
  max-primed-tnt-per-chunk: 20
  disable-explosion-drops: false

vehicles.yml - Limit entities per chunk:

limits:
  minecarts:
    per-chunk: 8
  boats:
    per-chunk: 5

🐛 Bug Fixes & Technical Improvements

• 
  
• Modular Refactoring: Clean implementation of new systems (me.koyere.lagxpert.system.*) with independent configurations.
• Compilation Fixes: Resolved symbol error in VehicleManager and cleaned up imports in AbilityLimiter.
• Secure Integration: Verified build with Maven (BUILD SUCCESS) and ensured correct registration of listeners and commands.

📦 Installation & Compatibility

Installation

1. 
   
2. Stop your server.
3. Delete any previous LagXpert-*.jar versions.
4. Place the new LagXpert-2.6.jar in your /plugins/ folder.
5. Restart the server. This is required to automatically generate the new configuration files:
   
   • 
     
   • mobs.yml, lagshield.yml, explosions.yml, vehicles.yml, abilities.yml, console-filter.yml.
6. Note: While /lagxpert reload exists, a full restart is strongly recommended for this update to ensure all new modules initialize correctly.

Compatibility

• 
  
• Versions: Minecraft 1.16.x - 1.21.x
• Platforms: Spigot, Paper, Purpur, Folia (Experimental support).
• Java: Java 17 or higher recommended.

LagXpert v2.5 - World-Aware Enforcement & Activity Tracking

Highlights

• Per-world enforcement: Mob spawns, storage placement checks and automated scans now honour world-specific overrides, keeping creative hubs relaxed and survival worlds strict.
• Config-driven grace periods: The item cleaner reads broken-block-tracking (default + material overrides) directly from itemcleaner.yml, making temporary drop protection fully customisable.
• Chunk safeguards from config: Smart chunk management now loads the important-block list from chunks.yml, so mission-critical structures stay loaded without code changes.

⚙️ Technical Improvements

• Hooked chunk activity tracking into block/entity/player events and scheduled periodic cleanup to keep telemetry fresh.
• Added Folia/Bukkit-safe activity cleanup task and listener to populate ChunkManager’s analytics in real time.
• Introduced world-aware limit providers across listeners, smart mob manager and the auto chunk scanner.
• Implemented configurable alert skipping when no players are online, aligned with monitoring.yml.

Developer Notes

• ConfigManager exposes per-world getters and broken block tracking settings; RecentlyBrokenBlocksTracker.configure(...) keeps runtime state in sync.
• Added ChunkActivityListener and ChunkActivityCleanupTask to the lifecycle; ensure they remain registered when extending the chunk management module.

LagXpert v2.4 - Action Bar Notifications Update

New Features
Action Bar Messages

• Restriction messages now appear in the action bar instead of chat spam
• Clean, non-intrusive notifications when you try to place blocks above limits
• Messages automatically disappear after a few seconds

Enhanced User Experience

• Shorter cooldowns for action bar messages (5 seconds instead of 15)
• Compact message format optimized for action bar display
• Fallback system - if action bar fails, messages still appear in chat

⚙️ Configuration Options
New Settings in messages.yml

Available Methods:

• "chat" - Traditional chat messages (old behavior)
• "actionbar" - Action bar only (new default)
• "both" - Send to both chat and action bar

Message Customization

• All restriction messages now have short versions for action bar
• You can still customize both long and short message formats
• No configuration changes required - works with existing setups

What This Means for You
For Players

• Less chat spam when building near limits
• Cleaner interface with subtle notifications
• Same functionality - all limits work exactly the same

For Server Admins

• Reduced chat noise in logs and screenshots
• Better user experience for builders
• Fully configurable - switch back to chat if preferred

Bug Fixes
Block Limit Issues Resolved

• Fixed off-by-one error - Players can now place the full configured amount of blocks
  • Previously: Limit of 10 only allowed 9 blocks
  • Now: Limit of 10 correctly allows 10 blocks
• Fixed colored shulker boxes - All 16 colored shulker box variants are now properly limited
  • Previously: Only purple shulker boxes were detected
  • Now: All colored shulker boxes count toward the same limit

Affected Blocks

• TNT, Hoppers, Pistons - No longer stop 1 block short of limit
• All Shulker Boxes - White, Orange, Magenta, Light Blue, Yellow, Lime, Pink, Gray, Light Gray, Cyan, Purple, Blue, Brown, Green, Red, Black

Privacy & Permissions
Alert Privacy System

• Alert filtering by permissions - Only players with permission receive limit alerts
• No more base location reveals - Prevents accidental discovery of hidden builds
• Configurable alert access - Admins can control who sees what alerts

Custom Limit Permissions

• Per-player custom limits - Set different limits for different players/ranks
• Permission-based limits - Use permissions like lagxpert.limits.hoppers.25
• Priority system - Bypass > Custom limit > Default limit

New Permission Examples

️ Technical Notes

• Backward Compatible - All existing configurations work unchanged
• Automatic Migration - No manual config updates needed
• Spigot 1.16.5+ - Compatible with all supported Minecraft versions

This update improves the user experience while maintaining all existing functionality. Players will notice cleaner, less intrusive notifications when working with block limits, and limits now work exactly as configured.

LagXpert v2.3 - Performance & Reliability Update

🚀 What's New

Major Performance Improvements

• Atomic Counter System: Implemented high-performance atomic counters for TNT and block tracking, replacing expensive chunk scanning operations
• Pre-Placement Validation: Enhanced block placement validation to prevent race conditions and improve reliability
• Smart Alert System: Added intelligent alert filtering to reduce spam when no players are online

Enhanced Item Cleaner System

• Recently Broken Block Tracking: New system tracks when players break blocks and provides grace periods for dropped items
• Material-Specific Grace Periods: Configurable grace periods for valuable materials (diamonds, emeralds, spawners, etc.)
• Intelligent Item Protection: Prevents cleanup of items from recently broken blocks, solving the "mining diamonds but inventory full" scenario

Bug Fixes

• Fixed TNT Limit Bypass: Resolved critical race condition that allowed TNT placement after 3-4 attempts despite limits
• Improved Thread Safety: Enhanced concurrent access handling for block counters and cache operations
• Alert Frequency Fix: Resolved issue with alerts being sent every 2 minutes even when players are online

🔧 Technical Improvements

Performance Optimizations

• O(1) Block Counting: TNT and piston counting now uses atomic operations instead of O(n) chunk scanning
• Reduced Memory Usage: Optimized cache invalidation and cleanup processes
• Async Processing: Enhanced asynchronous chunk analysis with better error handling

Code Quality

• Better Error Handling: Improved exception handling throughout the codebase
• Enhanced Logging: Added detailed debug logging for troubleshooting
• Thread-Safe Operations: Strengthened concurrent access patterns

⚙️ Configuration Updates

New Configuration Options

itemcleaner.yml

broken-block-tracking:
  enabled: true
  default-grace-period-seconds: 180  # 3 minutes
  custom-grace-periods:
    DIAMOND_ORE: 300      # 5 minutes for valuable ores
    EMERALD_ORE: 300
    ANCIENT_DEBRIS: 300
    CHEST: 600           # 10 minutes for storage blocks
    SPAWNER: 900         # 15 minutes for spawners

monitoring.yml

alerts:
  delivery:
    skip-when-no-players-online: true  # Reduces alert spam

🎯 User Experience Improvements

For Server Administrators

• Reduced Log Spam: Fewer unnecessary alerts when server is empty
• Better Performance Monitoring: More accurate TPS and memory tracking
• Improved Debugging: Enhanced debug logs for troubleshooting

For Players

• Protected Valuable Items: Mining diamonds and other valuables is now safer
• Reduced Frustration: Items from recently broken blocks won't be cleaned immediately
• Better Performance: Smoother gameplay due to optimized block limit checking

🛡️ Compatibility & Requirements

Minecraft Compatibility

• Tested Versions: 1.16.5 - 1.21.7
• Newly Supported: 1.21.6, 1.21.7
• Server Software: Spigot, Paper, Purpur, and forks

Java Requirements

• Minimum: Java 11
• Recommended: Java 17 or newer

📋 Migration Notes

Automatic Configuration Migration

• Existing configurations will continue to work without changes
• New features are disabled by default to maintain current behavior
• Configuration files will be automatically updated with new options

Breaking Changes

• None - this update is fully backward compatible

🔍 Developer Notes

New API Features

• ChunkDataCache.getAtomicCounter() - High-performance block counting
• RecentlyBrokenBlocksTracker - Track recently broken blocks with grace periods
• Enhanced ChunkOverloadEvent with better context information

Internal Changes

• Refactored StorageListener for better performance and reliability
• Added ItemCleanerListener for broken block tracking
• Improved PerformanceTracker with smarter alert logic

🐛 Known Issues

Resolved

• ✅ TNT limit bypass exploit
• ✅ Alert spam when no players online
• ✅ Item cleaner removing freshly mined items
• ✅ Race conditions in block placement validation

Monitoring

• Performance impact of new tracking systems (expected to be minimal)
• Memory usage with large numbers of recent block breaks (automatic cleanup implemented)

🙏 Credits

Thanks to the community for reporting these issues and providing valuable feedback that made this update possible.

📚 Documentation

For detailed configuration and usage instructions, please refer to the main README.md file.

Download: Available on GitHub Releases
Support: Open an issue on GitHub for bug reports or feature requests
License: GPL-3.0

LagXpert v2.3 - Making Minecraft servers faster and more reliable, one optimization at a time.

📋 LagXpert Free - Changelog

[2.2] - 2025-01-19

🚀 Major Features Added

• Smart Mob Management System: Automatically removes excess mobs while protecting important entities
  • Protects named mobs, tamed animals, equipped entities, and plugin-created mobs
  • Intelligent priority system (farm animals removed before valuable entities)
  • Performance-optimized gradual removal (max 10 mobs per chunk per tick)
  • Chunk processing cooldowns to prevent lag spikes
  • Comprehensive notifications with detailed statistics

🌐 Multi-Platform Support

• Platform Detection: Automatically detects Folia, Paper, Spigot, or Bukkit
• Folia Compatibility: Native support with RegionScheduler and AsyncScheduler
• Cross-Platform Scheduling: Intelligent scheduler wrapper for optimal performance
• Backward Compatibility: Seamless fallback to Bukkit scheduler when needed

🎮 Bedrock Edition Support

• Player Detection: Automatic identification of Bedrock players via Geyser/Floodgate
• GUI Optimization: Bedrock-specific inventory layouts and material handling
• Cross-Platform GUIs: Separate templates for Java and Bedrock players
• Smart Fallbacks: Chat-based alternatives when GUIs aren't compatible

🔧 Performance Enhancements

• Zero-Lag Design: All new systems designed to improve performance, not hinder it
• Intelligent Caching: Platform detection and player type caching for optimal performance
• Batch Processing: Operations grouped to minimize server load
• Region-Based Processing: Folia optimization for distributed chunk processing

📊 Enhanced Monitoring

• Advanced Statistics: Detailed tracking of mob removals, protections, and performance
• Platform Reporting: Comprehensive platform detection and capability reporting
• Migration Tracking: Automatic configuration version tracking and migration status

⚙️ Configuration System Improvements

• Automatic Migration: Seamless upgrade from v2.1.x with automatic backup creation
• New Configuration Sections: Platform detection, Bedrock compatibility, smart mob management
• Enhanced Documentation: Comprehensive inline documentation for all new features
• Backward Compatibility: Preserves all existing settings during migration

🛡️ Entity Protection Enhancements

• Advanced Protection Logic: Multiple layers of entity protection with priority systems
• Plugin Integration: Detects and protects entities created by other plugins
• Metadata Awareness: Respects custom entity metadata and flags
• Configuration Flexibility: Granular control over protection rules

🎯 User Experience Improvements

• Intelligent Notifications: Detailed feedback about optimization actions taken
• Cross-Platform Commands: All commands work seamlessly across Java and Bedrock
• Enhanced Debugging: Comprehensive logging and debugging options for troubleshooting
• Progressive Enhancement: Features gracefully degrade based on available platform capabilities

🔄 API Enhancements

• New API Methods: SmartMobManager integration for external plugins
• Platform Detection API: Allows other plugins to detect server platform
• Bedrock Player API: Utilities for detecting and handling Bedrock players
• Enhanced Events: Additional context and information in existing events

📋 Migration & Compatibility

• Automatic Configuration Migration: Seamless upgrade from any v2.1.x version
• Backup Creation: Automatic backup of old configurations with timestamps
• Zero Downtime: Migration occurs during plugin startup with no service interruption
• Rollback Support: Easy restoration from automatically created backups

LagXpert v2.1.1 - Bug Fix Update

Bug Fixes

• Fixed configuration warnings on startup - Eliminated unnecessary "Could not save X.yml because X.yml already exists" warnings that appeared during plugin initialization
• Improved startup logging - Cleaner console output during plugin loading process

Technical Details

• Enhanced configuration file detection logic to prevent false warnings
• Optimized default configuration saving process
• No functional changes - all features work exactly the same

⚡ What's New
This is a minor maintenance update focused on improving user experience by removing confusing warning messages that appeared on plugin startup. The warnings were harmless but caused unnecessary concern for server administrators.

Compatibility

• Minecraft: 1.16.5 - 1.21+
• Java: 11+
• Update Process: Simply replace the JAR file - no configuration changes needed

Download LagXpert v2.1.1 and enjoy a cleaner startup experience!

LagXpert v2.1 - Bug Fixes & Improvements

Critical Bug Fixes

Item Cleaner System:
• Fixed excluded items being deleted despite being in the exclusion list
• Improved item type detection and comparison logic
• Added automatic protection for enchanted items, named items, and items with lore
• Better error handling to prevent crashes with corrupted items

Entity Cleanup System:
• Fixed named entities being removed incorrectly
• Fixed tamed animals being deleted despite protection settings
• Fixed leashed entities being removed when they shouldn't be
• Improved detection of custom names, taming status, and leash connections
• Better respect for all protection configuration options

Configuration System:
• Fixed configuration lists not loading properly from files
• Improved validation to prevent invalid settings
• Added automatic fallback values for missing or empty configurations
• Better error messages when configuration files are missing

Improvements

• Enhanced debug logging for better troubleshooting
• Improved performance with better error handling
• More reliable detection of important entities and items
• Better configuration validation on server startup

⚠️ Important Notes

• Your existing configurations will continue to work
• Excluded items in itemcleaner.yml will now be properly respected
• Protected entities in entitycleanup.yml will now be properly protected
• Enable debug mode in config.yml to see detailed logs if needed

This update focuses on fixing critical issues reported by users. No new features were added to ensure stability.

🚀 LagXpert v2.0 - Major Update

Release Date: June 2025
Compatibility: Minecraft 1.16.5+ (Spigot/Paper)

🌟 What's New in v2.0

LagXpert v2.0 is a complete rewrite that transforms your server's performance management. This isn't just an update - it's a revolution in how you handle server lag.

🎯 Smart Performance Monitoring

• Real-time TPS tracking - Know exactly when your server starts lagging
• Memory usage monitoring - Catch memory issues before they crash your server
• Automatic lag spike detection - Get instant alerts when performance drops
• Performance history - Track your server's health over time
• Daily and weekly reports - Understand your server's performance patterns

🧠 Intelligent Chunk Management

• Smart chunk unloading - Automatically removes inactive chunks to save memory
• Directional chunk preloading - Loads chunks ahead of moving players for smoother gameplay
• Activity tracking - Learns which areas are important to keep loaded
• Border optimization - Special handling for world border chunks
• Performance safeguards - Protects important blocks and redstone from accidental unloading

🎮 Interactive GUI Configuration

• No more YAML editing - Configure everything through an easy-to-use in-game menu
• Real-time previews - See changes before applying them
• Session management - Safe configuration editing with timeout protection
• Permission-based access - Control who can modify settings

🌍 Per-World Settings

• World-specific limits - Different rules for Nether, End, and custom worlds
• Inheritance system - Override only what you need, inherit the rest
• Dynamic configuration - Create new world configs without server restarts
• Automatic detection - New worlds get appropriate default settings

⚡ Enhanced Performance Engine

• Advanced caching system - Dramatically faster chunk analysis
• Asynchronous processing - Heavy operations won't freeze your server
• Circuit detection - Automatically identifies and manages redstone clocks
• Smart entity cleanup - Removes problematic entities without affecting gameplay

📊 Professional Monitoring Tools

• TPS Command - Detailed performance information at your fingertips
• Memory tracking - Monitor Java heap usage and garbage collection
• Chunk statistics - See exactly how many chunks are loaded
• Lag spike analysis - Identify patterns in server performance issues

🔧 Installation & Update Guide

📥 Fresh Installation

1. Download LagXpert v2.0
2. Place the .jar file in your plugins/ folder
3. Restart your server
4. LagXpert will automatically create all configuration files
5. Use /lagxpertgui to configure settings through the GUI

📈 Updating from v1.x

1. Stop your server
2. Backup your current LagXpert folder (important!)
3. Replace the old .jar file with LagXpert v2.0
4. Start your server
5. LagXpert will automatically migrate your old settings
6. Your existing limits and configurations will be preserved
7. New features will use default settings

⚠️ Your server will NOT be affected during the update. All your current limits and settings will continue working.

🎯 Why You Should Update

🚀 Massive Performance Improvements

• 70% faster chunk scanning - Operations that took seconds now take milliseconds
• Reduced memory usage - Smart caching reduces RAM consumption by up to 15%
• Better server stability - Advanced monitoring prevents crashes before they happen

🎮 Better Player Experience

• Smoother gameplay - Intelligent chunk preloading eliminates lag spikes
• Faster world loading - Players experience less waiting when exploring
• Consistent performance - Automatic optimization keeps your server running smoothly

👨‍💼 Easier Server Management

• No more config file editing - Everything can be done through the GUI
• Better monitoring - Know exactly what's happening on your server
• Automated optimization - Let LagXpert handle performance tuning for you
• Detailed insights - Understand your server's performance like never before

🛡️ Enterprise-Grade Features

• Predictive alerts - Get warned before problems become critical
• Historical analysis - Track performance trends over weeks and months
• Professional reporting - Generate performance reports for your team
• Scalable architecture - Supports servers with 1000+ concurrent players

📋 New Commands

🔑 New Permissions

⚙️ Configuration Highlights

🆕 New Configuration Files

• monitoring.yml - TPS and performance tracking settings
• chunks.yml - Smart chunk management configuration
• entitycleanup.yml - Advanced entity cleanup options
• config/worlds/ - Per-world override configurations

🔄 Enhanced Existing Files

• All existing configurations have been expanded with new options
• Backward compatibility maintained - your current settings still work
• New features use safe defaults

💡 Pro Tips for v2.0

1. Start with GUI - Use /lagxpertgui to familiarize yourself with new features
2. Check TPS regularly - Use /tps to monitor your server's health
3. Customize per world - Set different limits for Nether and End dimensions
4. Monitor alerts - Enable performance alerts to catch issues early
5. Review reports - Check daily performance summaries to optimize settings

🛠️ Technical Notes

• No breaking changes - All existing functionality is preserved
• New dependencies - None! Still only requires Spigot API
• Memory usage - Initial memory usage may be slightly higher due to monitoring features
• CPU impact - New async processing actually reduces CPU load
• Database - No database required, all data stored in lightweight files

🐛 Known Issues

• GUI sessions timeout after 5 minutes of inactivity (by design)
• Some advanced chunk management features may need fine-tuning for very large servers
• Performance monitoring generates more log entries (can be disabled)

🙏 Support & Feedback

Found a bug? Have a suggestion? Need help?

• SpigotMC: LagXpert Resource Page
• Discord: Join our community server
• Issues: Report bugs through our issue tracker

📈 Coming Next

LagXpert v2.0 sets the foundation for exciting future features:

• Discord integration for alerts
• Web-based dashboard
• Machine learning lag prediction
• Advanced analytics and reporting

Thank you for using LagXpert! Your server's performance journey just got a major upgrade. 🎉

LagXpert v1.3 - Changelog

We are excited to announce the release of LagXpert v1.3! This update brings a comprehensive overhaul of the plugin, focusing on drastically improved performance, enhanced stability, more intuitive configuration, and new alert control features for a smoother and less intrusive server administration experience.

✨ Key Improvements & New Features

• 
  
• 🚀 Massive Performance Overhaul:
  
  • 
    
  • Block and entity counting logic across all modules (listeners, scheduled tasks, and commands) has been completely rewritten. Highly efficient methods, such as specific Tile Entity scanning and single-pass full scans for other blocks, are now used. This significantly reduces the plugin's impact on server performance, especially during chunk scanning and command execution like /chunkstatus and /lagxpert inspect. LagXpert is now lighter than ever!
• 🛡️ New Alert Cooldown System:
  
  • 
    
  • To prevent chat spam, an intelligent alert cooldown system has been implemented. Players will no longer receive the same specific alert for the same condition/location repeatedly within a short, configurable timeframe (see alerts.yml).
• ⚙️ Granular Alert Configuration (New alerts.yml):
  
  • 
    
  • The alerts.yml file has been redesigned to offer much finer control over which specific types of alerts are active (e.g., limit-reached alerts vs. near-limit warnings, for each block/entity type). This allows server administrators to tailor notifications to their exact needs, complementing the master alert toggle in config.yml.
• 🔍 /lagxpert inspect <x> <z> [world] Command Now Functional:
  
  • 
    
  • The inspect subcommand has been fully implemented, allowing administrators with the lagxpert.admin permission to get a detailed and efficient breakdown of any loaded chunk's contents by specifying coordinates and an optional world.
• 🛠️ Enhanced Java 11 Compatibility:
  
  • 
    
  • The codebase has been refactored to ensure compatibility with Java 11. This broadens the range of server Java versions LagXpert can run on smoothly, which is especially important for servers still utilizing Minecraft 1.16.5.
• 🔌 Improved Event API:
  
  • 
    
  • The structure of custom events (LagEvent, ChunkOverloadEvent) has been corrected and improved, ensuring proper implementation of Bukkit's HandlerList for better integration with other plugins.

📈 General Optimizations & Fixes

• 
  
• Configuration Consistency:
  
  • 
    
  • config.yml now acts as the central control panel for enabling or disabling main plugin modules (mobs, storage, redstone, alerts, auto-chunk-scan, item-cleaner).
  • Individual YAML files (mobs.yml, storage.yml, redstone.yml, itemcleaner.yml, task.yml) now focus on the detailed settings for their respective modules.
  • All configuration keys and paths have been aligned between YAML files and ConfigManager.java for clarity and to prevent loading errors.
• Improved ItemCleanerTask:
  
  • 
    
  • The item cleaning task now handles its own warning cycle internally (if enabled), eliminating the need for a separate warning schedule and ensuring the warning always precedes the cleanup in each cycle.
  • It now consistently pulls all its settings from ConfigManager, responding correctly to reloads.
• Message System (MessageManager & messages.yml):
  
  • 
    
  • MessageManager is now correctly initialized by ConfigManager.
  • The messages.yml file has been thoroughly reviewed: all missing message keys have been added, discrepancies corrected, and placeholders standardized. All default messages are now in English and fully customizable.
• Polished Commands:
  
  • 
    
  • All commands (/lagxpert, /chunkstatus, /clearitems, /abyss) now consistently use MessageManager for all user-facing messages.
  • Improved TabCompleter for /lagxpert and /clearitems, offering more accurate and permission-based suggestions.
  • Corrected permission handling and argument parsing in various commands.
• Optimized Listeners:
  
  • 
    
  • EntityListener, StorageListener, and RedstoneListener now use optimized counting methods and the new granular alert and cooldown logic.
  • The limit logic in StorageListener has been reviewed for accuracy.
  • RedstoneListener now correctly implements persistent signal control with a delayed task.
• Updated plugin.yml:
  
  • 
    
  • Permission nodes have been expanded and detailed, especially for bypasses (lagxpert.bypass.*), covering all limitable elements.
  • Added permission-message and aliases to command definitions for better Bukkit integration.
• Various Bug Fixes:
  
  • 
    
  • Resolved multiple "Cannot resolve symbol" and "Cannot resolve method" errors that arose during refactoring.
  • Fixed the "Duplicate class" issue related to LagXpertCommand.java.
  • Ensured code compatibility with Java 11 by removing records and "pattern matching for instanceof" where necessary.

We hope you enjoy the stability, performance, and customization improvements in LagXpert v1.3. As always, your feedback and bug reports are welcome on our Discord or the plugin page!

🛠️ LagXpert v1.2 – Performance, Recovery & Professional UX!

LagXpert continues to evolve with new optimizations, enhanced features, and improved user experience. This update focuses on player clarity, admin control, and data persistence.

✅ What's New

🔹 Enhanced /chunkstatus Output

• 
  
• 
  

  Now displays all relevant blocks: hoppers, chests, furnaces, blast furnaces, barrels, shulker boxes, droppers, dispensers, observers, pistons, TNT and more.

  
  
• 
  

  Beautifully formatted with clear sections and color coding.

  
  
• 
  

  Automatically warns when chunk limits are exceeded.

  
  

🔹 Fully Persistent Abyss System

• 
  
• 
  

  Items removed via /clearitems or auto-cleanups are now saved per player in plugins/LagXpert/data/abyss/uuid.yml.

  
  
• 
  

  Players can safely recover items with /abyss even after a server restart.

  
  

🔹 New /clearitems Subcommands

• 
  
• 
  

  /clearitems all → removes ground items from all enabled worlds.

  
  
• 
  

  /clearitems <world> → cleans a specific world by name.

  
  
• 
  

  Granular permissions added:

  
  
  • 
    
  • 
    

    lagxpert.clearitems.all

    
    
  • 
    

    lagxpert.clearitems.world

    
    

🔹 Debug Mode

• 
  
• 
  

  Added debug: true in config.yml to output detailed logs in console.

  
  
• 
  

  Perfect for diagnostics, testing and reporting issues.

  
  

🔹 Extended bStats Metrics

• 
  
• 
  

  Plugin now tracks:

  
  
  • 
    
  • 
    

    Number of items removed via cleanup.

    
    
  • 
    

    Players recovering items via Abyss.

    
    
• 
  

  Helps us improve performance and feature planning.

  
  

🛡 Compatible With

• 
  
• 
  

  Minecraft 1.16.5 to 1.21.5

  
  
• 
  

  Paper, Purpur, Spigot, Pufferfish

  
  

💬 Need Help or Want to Share Feedback?

Join our support server: Discord: https://discord.gg/xKUjn3EJzR

⭐ Enjoying the Plugin?

Please consider leaving a ⭐ review to support continued development!

LagXpert Free - Update 1.1

✅ New Features

• Abyss Recovery System (Persistent):
  
  • Now players can recover their recently cleared items using /abyss.
    
    
  • Items are stored safely in YAML files per player inside plugins/LagXpert/data/abyss/.
    
    
  • Recovery is available within a configurable time limit and item cap.
    
    
  • Full compatibility with automatic and manual cleanups (/clearitems).

⚙ Improvements

• Improved Cleanup Logic:
  
  • /clearitems now associates items with the player who used the command.
    
    
  • Better item filtering and world configuration via itemcleaner.yml.
• Color Message Fix:
  
  • Recovery messages now display with proper color formatting (&a, &f, etc.).

Technical Changes

• Clean separation of temporary item storage from runtime memory.
  
  
• Uses ItemStack.serialize() and deserialize() to ensure compatibility across versions.
  
  
• Optimized file handling and error resilience in AbyssManager.

Notes

• If you already use LagXpert, the plugin will automatically create the new data/abyss/ folder on first use.
  
  
• No data is stored in RAM — the Abyss system is safe and lag-free even on large servers.

⭐ Enjoying LagXpert?

If this plugin is helping your server reduce lag and stay clean, please leave a 5-star review — it means a lot and helps the project grow!

Need help or want to suggest a feature?

Join our official support server:

https://discord.gg/xKUjn3EJzR

• 🕳 Abyss Recovery System (Persistent):
   
  • Now players can recover their recently cleared items using /abyss.
     
  • Items are stored safely in YAML files per player inside plugins/LagXpert/data/abyss/.
     
  • Recovery is available within a configurable time limit and item cap.
     
  • Full compatibility with automatic and manual cleanups (/clearitems).
     

• Improved Cleanup Logic:
   
  • /clearitems now associates items with the player who used the command.
     
  • Better item filtering and world configuration via itemcleaner.yml.
     
• Color Message Fix:
   
  • Recovery messages now display with proper color formatting (&a, &f, etc.).
     

• Clean separation of temporary item storage from runtime memory.
   
• Uses ItemStack.serialize() and deserialize() to ensure compatibility across versions.
   
• Optimized file handling and error resilience in AbyssManager.
   

• If you already use LagXpert, the plugin will automatically create the new data/abyss/ folder on first use.
   
• No data is stored in RAM — the Abyss system is safe and lag-free even on large servers.