# LagOptimizer
\nA comprehensive lag mitigation and analysis solution for Minecraft servers<\/p>\n
## Features<\/p>\n
– **Entity Management**
\n– **Configurable automated entity purging**
\n– **Whitelist\/blacklist for entity types**
\n– **Maximum entities per chunk limit**
\n– **Entity age-based removal**
\n– Distance-based entity cleanup
\n– Manual purge command with entity type filtering**<\/p>\n
– **Performance Monitoring**
\n– **Real-time TPS monitoring (requires Spark plugin)**
\n– **Memory usage tracking**
\n– **Entity and chunk counting**
\n– **Customizable scoreboard display**
\n– **Performance metric logging**
\n– **Configurable monitoring intervals**<\/p>\n
## Requirements
\n– Minecraft Server 1.19+
\n– Java 8 or higher
\n– Spark (optional, for TPS monitoring)<\/p>\n
## Installation
\n**Download the latest release from the releases page
\nPlace the JAR file in your server’s plugins directory
\n(Optional) Install Spark plugin for TPS monitoring
\nStart or reload your server
\nConfigure the plugin using the generated config.yml**<\/p>\n
## Configuration<\/p>\n
**Entity Purge Settings**
\npurge:
\n auto-purge-enabled: true
\n interval: 300 # Purge interval in seconds (5 minutes)
\n max-entities-per-chunk: 100
\n max-entity-age: 300 # Maximum age of entities in seconds (5 minutes)
\n max-distance-from-players: 32 # Maximum distance from players in blocks<\/p>\n
whitelist:
\n – PLAYER
\n – VILLAGER
\n – IRON_GOLEM
\n – WOLF
\n – HORSE<\/p>\n
blacklist:
\n – DROPPED_ITEM
\n – EXPERIENCE_ORB
\n – ARROW
\n – SPECTRAL_ARROW
\n – TRIDENT
\n – FALLING_BLOCK<\/p>\n
**Performance Monitoring Settings**
\nmonitoring:
\n enabled: true
\n interval: 60 # Monitoring interval in seconds (1 minute)<\/p>\n
scoreboard:
\n enabled: true
\n title: “&6Server Performance”
\n lines:
\n – “&7TPS: &f{tps}”
\n – “&7Memory: &f{memory_used}\/{memory_max} MB”
\n – “&7Entities: &f{entity_count}”
\n – “&7Chunks: &f{chunk_count}”
\n – “&7Players: &f{player_count}”<\/p>\n
logging:
\n enabled: true
\n file-path: “plugins\/LagOptimizer\/logs\/performance.log”
\n retention-days: 7
\n## Commands<\/p>\n
“`
\n\/lagoptimize purge [entityType] – Manually purge entities
\nPermission: lagoptimizer.purge
\n\/lagoptimize reload – Reload the configuration
\nPermission: lagoptimizer.reload
\n\/lagoptimize stats – Display performance statistics
\nPermission: lagoptimizer.stats
\n\/lagoptimize toggle – Toggle automatic purging
\nPermission: lagoptimizer.toggle
\n“`<\/p>\n
## Permissions<\/p>\n
“`
\nlagoptimizer.* – Access to all commands
\nlagoptimizer.purge – Manual purging
\nlagoptimizer.reload – Configuration reload
\nlagoptimizer.stats – View stats
\nlagoptimizer.toggle – Toggle features
\nlagoptimizer.use – Basic command access
\n“`<\/p>\n
## Performance Impact
\n**Heavy operations run asynchronously
\nConfigurable intervals for monitoring and purging
\nSmart entity management to prevent server overload
\nMinimal memory footprint**<\/p>\n
– Logging
\n– Performance metrics are logged to plugins\/LagOptimizer\/logs\/performance.log with:
\n– Timestamp
\n– TPS (if Spark is installed)
\n– Memory usage
\n– Entity count
\n– Chunk count
\n– Player count<\/p>\n
## Support
\nJoin our Discord server for help and discussion.<\/p>\n","protected":false},"excerpt":{"rendered":"
A comprehensive lag mitigation and analysis solution for Minecraft servers<\/p>\n","protected":false},"featured_media":91565,"template":"","meta":{"_minecraft_slug":"lagoptimizer","_minecraft_project_id":"KzGgFtoB","_minecraft_author":"NotGamerPratham","_minecraft_license":"MIT","_minecraft_downloads":6,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lagoptimizer.zip","_minecraft_size_bytes":17067,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:20:15.094816Z","_minecraft_date_created":"2026-05-06T00:16:52.228007Z","_minecraft_date_modified":"2025-08-08T08:14:42.131767Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lagoptimizer","_minecraft_icon_attachment_id":91565,"_minecraft_imported_at":"2026-06-05T05:33:22+00:00","_minecraft_import_hash":"5dbe07190e3005e06512de4827c65f20","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,89,126,90,127,867,129,92,159],"mod_loader":[130,895,132,134],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-91564","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-utility","mod_category-worldgen","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n