LagOptimizer

LagOptimizer

A comprehensive lag mitigation and analysis solution for Minecraft servers

Features

- Entity age-based removal - Entity age-based removal - Entity age-based removal - Entity age-based removal - Entity age-based removal - Distance-based entity cleanup - Manual purge command with entity type filtering**

- Configurable monitoring intervals - Configurable monitoring intervals - Configurable monitoring intervals - Configurable monitoring intervals - Configurable monitoring intervals - Configurable monitoring intervals - 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.