EpicClearLag – Documentation
Overview
EpicClearLag is a Minecraft server plugin designed to reduce lag by automatically clearing dropped items and unnecessary entities. It includes configurable clearing intervals, player notifications, entity protection, and TPS-based performance monitoring.

Features

• Automatic Item Clearing
  • Removes dropped items at configurable intervals.
    
    
  • Sends warning messages to players before clearing.
• Entity Clearing
  • Removes unnecessary mobs and entities.
    
    
  • Protects specified mobs and blocks from being removed.
• TPS Monitoring
  • Continuously monitors server TPS.
    
    
  • Can trigger additional clearing when TPS falls below a threshold.
• Custom Messaging
  • Configurable warning and confirmation messages.
    
    
  • Supports placeholders for dynamic values (%time%, %items%, %entities%).
• Commands
  • /clearlag → Manually trigger item/entity clearing.
    
    
  • /clearlag reload → Reload configuration without restarting the server.
    
    
  • /clearlag tps → Display current server TPS.

Configuration (config.yml)

• clear-interval → Time in seconds between automatic clears.
  
  
• warning-times → List of times (in seconds) to send warnings before clearing.
  
  
• protected-mobs → List of mobs that will not be removed.
  
  
• protected-blocks → List of blocks that will not be cleared around.
  
  
• tps-threshold → TPS value that triggers emergency clearing.
  
  
• messages → Customizable text for warnings and results.

Placeholders:

• %time% → Remaining time until clear.
  
  
• %items% → Number of items removed.
  
  
• %entities% → Number of entities removed.

Supported Versions

• Paper/Spigot 1.17 → Latest (tested on 1.21.x)