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

1. Download the latest release from the releases page
2. Place the JAR file in your server's plugins directory
3. (Optional) Install Spark plugin for TPS monitoring
4. Start or reload your server
5. 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.