# LessLag<\/p>\n
**Server performance guardian for Paper\/Spigot (1.20.4+) with Folia support.**<\/p>\n
LessLag is built for production servers that need stable TPS without disruptive \u201cwipe everything\u201d behavior. It focuses on three things:<\/p>\n
– **Detect lag early**
\n– **Explain what is causing it**
\n– **Apply safe, configurable mitigation**<\/p>\n
## Why use LessLag?<\/p>\n
– **Actionable diagnostics**, not guesswork
\n– **Adaptive responses** based on live server pressure
\n– **Modular controls** for entities, redstone, AI, chunks, memory, and farms
\n– **Low overhead**: workload budgeting + on-demand deep metrics<\/p>\n
## Highlights<\/p>\n
– **`\/lg status` dashboard** with health score, MSPT percentiles (`P50`, `P95`, `P99`), uptime, queue status, and spike counters
\n– **`\/lg tickmonitor` diagnostics** with MSPT distribution + avg\/min\/max
\n– **Lag source analysis** via `\/lg sources` and `\/lg trace` to identify hotspots and likely culprits
\n– **Entity management** with protections for named\/tamed\/NPC entities
\n– **Redstone safeguards** (activation limits, clock detection, piston pressure control)
\n– **Mob AI optimization** (frustum\/distance-based)
\n– **Farm optimizations** (villager optimizer, breeding limiter, density optimizer)
\n– **Predictive optimization** from MSPT trend analysis<\/p>\n
## What makes it practical in production?<\/p>\n
– **Operator-focused workflows** for daily checks and incident response
\n– **Targeted mitigation** before emergency-wide cleanup
\n– **Farm-aware controls** for villager halls and high-density breeding setups
\n– **Low-overhead telemetry model** (on-demand deep stats + workload budgeting)<\/p>\n
## Useful Commands<\/p>\n
– `\/lg status` \u2014 live performance dashboard
\n– `\/lg health` \u2014 health report and context
\n– `\/lg tickmonitor` \u2014 tick\/MSPT distribution diagnostics
\n– `\/lg sources` \u2014 lag source analysis
\n– `\/lg trace` \u2014 runtime bottleneck summary
\n– `\/lg density` \u2014 density optimizer limits + suppression stats
\n– `\/lg breeding` \u2014 breeding limiter blocked-event stats
\n– `\/lg reload` \u2014 reload config\/messages without restart<\/p>\n
## Quick Operations Workflow<\/p>\n
1. Baseline with `\/lg status` and `\/lg health`
\n2. During spikes, run `\/lg tickmonitor` + `\/lg trace`
\n3. Use `\/lg sources` to identify likely hotspots
\n4. Mitigate minimally (`\/lg clear hostile`, `\/lg ai disable`) only when needed
\n5. Tune one module group, then `\/lg reload`
\n6. Validate recovery through MSPT percentile and spike trend improvements<\/p>\n
## Tuning by server style<\/p>\n
– **SMP**: keep balanced defaults, tune entities\/chunks gradually
\n– **Farm-heavy\/Skyblock**: prioritize density + breeding + villager modules
\n– **Lobby\/Minigame**: emphasize chunks\/world-guard and notifications<\/p>\n
## Permissions<\/p>\n
– `lesslag.admin` \u2014 full command access
\n– `lesslag.notify` \u2014 receive performance alerts
\n– `lesslag.setup` \u2014 setup advisor access<\/p>\n
## Compatibility<\/p>\n
– Paper\/Spigot `1.20.4+`
\n– Folia supported
\n– Compatibility toggles for common optimization plugin stacks<\/p>\n
## Install<\/p>\n
1. Put `LessLag.jar` in your `\/plugins` folder
\n2. Restart the server
\n3. Configure `plugins\/LessLag\/config.yml`
\n4. Run `\/lg status` and `\/lg setup` to verify baseline<\/p>\n
## Links<\/p>\n
– Website: https:\/\/lesslag-web.vercel.app
\n– Source\/Issues: https:\/\/github.com\/Alexteens24\/Lesslag<\/p>\n
If you report an issue, include your server version, plugin list, and output from `\/lg status`, `\/lg tickmonitor`, and `\/lg trace`.<\/p>\n","protected":false},"excerpt":{"rendered":"
Async performance guardian plugin<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"lesslagg","_minecraft_project_id":"VdfBGpnl","_minecraft_author":"alexisbinh","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":84,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lesslagg.zip","_minecraft_size_bytes":746863,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T20:05:03.584093Z","_minecraft_date_created":"2026-03-11T22:37:20.927020Z","_minecraft_date_modified":"2026-04-06T03:58:27.101361Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lesslagg","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-05T07:46:29+00:00","_minecraft_import_hash":"2ee741f48f090a49d9c21a7a04dab268","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,90,127,128,129],"mod_loader":[131,132,133,134],"minecraft_version":[94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-93128","mod","type-mod","status-publish","hentry","mod_category-folia","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n