LessLagg

# LessLag **Server performance guardian for Paper/Spigot (1.20.4+) with Folia support.** LessLag is built for production servers that need stable TPS without disruptive “wipe everything” behavior. It focuses on three things: - **Detect lag early** - **Explain what is causing it** - **Apply safe, configurable mitigation** ## Why use LessLag? - **Actionable diagnostics**, not guesswork - **Adaptive responses** based on live server pressure - **Modular controls** for entities, redstone, AI, chunks, memory, and farms - **Low overhead**: workload budgeting + on-demand deep metrics ## Highlights - **`/lg status` dashboard** with health score, MSPT percentiles (`P50`, `P95`, `P99`), uptime, queue status, and spike counters - **`/lg tickmonitor` diagnostics** with MSPT distribution + avg/min/max - **Lag source analysis** via `/lg sources` and `/lg trace` to identify hotspots and likely culprits - **Entity management** with protections for named/tamed/NPC entities - **Redstone safeguards** (activation limits, clock detection, piston pressure control) - **Mob AI optimization** (frustum/distance-based) - **Farm optimizations** (villager optimizer, breeding limiter, density optimizer) - **Predictive optimization** from MSPT trend analysis ## What makes it practical in production? - **Operator-focused workflows** for daily checks and incident response - **Targeted mitigation** before emergency-wide cleanup - **Farm-aware controls** for villager halls and high-density breeding setups - **Low-overhead telemetry model** (on-demand deep stats + workload budgeting) ## Useful Commands - `/lg status` — live performance dashboard - `/lg health` — health report and context - `/lg tickmonitor` — tick/MSPT distribution diagnostics - `/lg sources` — 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 config/messages without restart ## Quick Operations Workflow 1. Baseline with `/lg status` and `/lg health` 2. During spikes, run `/lg tickmonitor` + `/lg trace` 3. Use `/lg sources` to identify likely hotspots 4. Mitigate minimally (`/lg clear hostile`, `/lg ai disable`) only when needed 5. Tune one module group, then `/lg reload` 6. Validate recovery through MSPT percentile and spike trend improvements ## Tuning by server style - **SMP**: keep balanced defaults, tune entities/chunks gradually - **Farm-heavy/Skyblock**: prioritize density + breeding + villager modules - **Lobby/Minigame**: emphasize chunks/world-guard and notifications ## Permissions - `lesslag.admin` — full command access - `lesslag.notify` — receive performance alerts - `lesslag.setup` — setup advisor access ## Compatibility - Paper/Spigot `1.20.4+` - Folia supported - Compatibility toggles for common optimization plugin stacks ## Install 1. Put `LessLag.jar` in your `/plugins` folder 2. Restart the server 3. Configure `plugins/LessLag/config.yml` 4. Run `/lg status` and `/lg setup` to verify baseline ## Links - Website: https://lesslag-web.vercel.app - Source/Issues: https://github.com/Alexteens24/Lesslag If you report an issue, include your server version, plugin list, and output from `/lg status`, `/lg tickmonitor`, and `/lg trace`.