LessLag is a performance intelligence plugin focused on stability first: detect lag early, explain what is causing it, and apply safe mitigation before TPS collapses.

Why LessLag?

• Actionable diagnostics instead of blind cleanup
• Adaptive mitigation that reacts to real server pressure
• Modular controls for entities, redstone, AI, chunks, memory, and farms
• Low-overhead design with workload budgeting and on-demand deep stats

Core Features

• Performance Dashboard via /lg status: health score, MSPT percentiles (P50/P95/P99), uptime, queue and spike counters
• Tick Diagnostics via /lg tickmonitor: distribution, avg/min/max, spike visibility
• Lag Source Analyzer via /lg sources and /lg trace: identify hotspots and likely culprits
• Entity Protection + Smart Cleanup: protect named/tamed/NPC entities while targeting low-value overload sources
• Redstone Safeguards: activation limits, clock detection, piston pressure controls
• Mob AI Optimization: frustum/distance-based AI throttling to reduce CPU load
• Farm Optimizations: villager optimizer, breeding limiter, density optimizer
• Predictive Optimization: MSPT trend detection for proactive responses

Useful Admin Commands

• /lg status - Live performance dashboard
• /lg health - Health report with recommendation context
• /lg tickmonitor - Tick and MSPT distribution diagnostics
• /lg sources - Run lag source analysis
• /lg trace - Runtime bottleneck summary
• /lg density - Density optimizer limits + suppression stats
• /lg breeding - Breeding limiter blocked-event stats
• /lg reload - Reload configuration without restart

What Makes LessLag Different?

• No blind wipes: prioritizes diagnosis and targeted mitigation first
• Percentile visibility: uses MSPT distribution (P50/P95/P99) for realistic performance trends
• Proactive control: predictive optimization can trigger before TPS collapse
• Farm-aware optimization: villager, breeding, and density systems for real SMP/Skyblock pain points
• Operator-first workflow: command surface designed for daily checks and incident response

Recommended First 10 Minutes

1. Run /lg status and /lg health to baseline current load
2. Run /lg tickmonitor and /lg trace during peak activity
3. If farms are heavy, inspect /lg density, /lg breeding, /lg villager
4. Tune one config section at a time, then /lg reload
5. Re-check percentiles and spike trend before changing more

Best-Fit Server Types

• Survival SMP with persistent player bases
• Farm-heavy economies / Skyblock
• Networks needing stable TPS with low admin noise

Compatibility

• Paper/Spigot 1.20.4+
• Folia supported
• Designed to coexist with common optimization stacks via compatibility toggles

Permissions

• lesslag.admin - Full command access
• lesslag.notify - Receive performance alerts
• lesslag.setup - Setup Advisor access

Install

1. Drop LessLag.jar into /plugins
2. Restart server
3. Tune plugins/LessLag/config.yml to your needs
4. Use /lg status and /lg setup for baseline verification

Performance Philosophy

• Telemetry counters piggyback existing event/tick paths
• Deep calculations (like percentiles) are command-time, on-demand
• Heavy analysis is workload-budgeted to reduce tick impact

Website
https://lesslag-web.vercel.app

Support / Feedback
Open an issue with your timings/profile context and LessLag command output for faster diagnosis.