LagOptimizer
A comprehensive lag mitigation and analysis solution for Minecraft servers
Features
Entity Management
Configurable automated entity purging
Whitelist/blacklist for entity types
Maximum entities per chunk limit
Entity age-based removal
Distance-based entity cleanup
Manual purge command with entity type filtering**
Performance Monitoring
Real-time TPS monitoring (requires Spark plugin)
Memory usage tracking
Entity and chunk counting
Customizable scoreboard display
Performance metric logging
Configurable monitoring intervals
Requirements
- Minecraft Server 1.19+
- Java 8 or higher
- Spark (optional, for TPS monitoring)
Installation
Download the latest release from the releases page Place the JAR file in your server's plugins directory (Optional) Install Spark plugin for TPS monitoring Start or reload your server Configure the plugin using the generated config.yml
Configuration
Entity Purge Settings purge: auto-purge-enabled: true interval: 300 # Purge interval in seconds (5 minutes) max-entities-per-chunk: 100 max-entity-age: 300 # Maximum age of entities in seconds (5 minutes) max-distance-from-players: 32 # Maximum distance from players in blocks
whitelist: - PLAYER - VILLAGER - IRON_GOLEM - WOLF - HORSE
blacklist: - DROPPED_ITEM - EXPERIENCE_ORB - ARROW - SPECTRAL_ARROW - TRIDENT - FALLING_BLOCK
Performance Monitoring Settings monitoring: enabled: true interval: 60 # Monitoring interval in seconds (1 minute)
scoreboard: enabled: true title: "&6Server Performance" lines: - "&7TPS: &f{tps}" - "&7Memory: &f{memory_used}/{memory_max} MB" - "&7Entities: &f{entity_count}" - "&7Chunks: &f{chunk_count}" - "&7Players: &f{player_count}"
logging: enabled: true file-path: "plugins/LagOptimizer/logs/performance.log" retention-days: 7
Commands
/lagoptimize purge [entityType] - Manually purge entities
Permission: lagoptimizer.purge
/lagoptimize reload - Reload the configuration
Permission: lagoptimizer.reload
/lagoptimize stats - Display performance statistics
Permission: lagoptimizer.stats
/lagoptimize toggle - Toggle automatic purging
Permission: lagoptimizer.toggle
Permissions
lagoptimizer.* - Access to all commands
lagoptimizer.purge - Manual purging
lagoptimizer.reload - Configuration reload
lagoptimizer.stats - View stats
lagoptimizer.toggle - Toggle features
lagoptimizer.use - Basic command access
Performance Impact
Heavy operations run asynchronously Configurable intervals for monitoring and purging Smart entity management to prevent server overload Minimal memory footprint
- Logging
- Performance metrics are logged to plugins/LagOptimizer/logs/performance.log with:
- Timestamp
- TPS (if Spark is installed)
- Memory usage
- Entity count
- Chunk count
- Player count
Support
Join our Discord server for help and discussion.
