![[FREE] LagSpike Guardian - The Ultimate Performance & Diagnostics Toolkit [1.20.1]](https://www.spigotmc.org/data/resource_icons/127/127391.jpg?1753695074){kind=icon}
ModsJava
[FREE] LagSpike Guardian - The Ultimate Performance & Diagnostics Toolkit [1.20.1]
━━━━━━━━━━━❖━━━━━━━━━━━
LagSpike Guardian
Your All-in-One Solution for Server Stability
━━━━━━━━━━━❖━━━━━━━━━━━
As a developer and server enthusiast, I know the biggest challenge for any server owner is lag. It can come from anywhere—a forgotten mob farm, a massive item spill, or a broken redstone machine. I created **LagSpike Guardian** to be a smarter, all-in-one solution. Instead of just blindly clearing entities, this plugin actively monitors your server's health and provides you with the tools to both automatically prevent lag and diagnose it yourself. It's powerful, lightweight, and designed to give you peace of mind.
⭐ Features
Commands & Permissions
*(All permissions default to OP)*
⚙️ Default Configuration
Installation
Support
This plugin was designed to be powerful yet simple to use. If you have any suggestions for future features, find a bug, or need help, please use the discussion thread or leave a review!
⭐ Features
✅ Automatic TPS Monitoring: Intelligently clears entities only when your server's TPS drops below a configured threshold, preventing lag without disrupting gameplay.
✅ Scheduled Item Sweeper: Proactively cleans up dropped items on a timer, with configurable warnings and a protected-item list so valuable gear is never deleted.
✅ Smart Redstone Limiter: Detects and temporarily disables hyperactive redstone clocks that cause server lag, with whitelisted worlds to protect player builds.
✅ Powerful Diagnostic Tools: Use `/lagspike topchunks` to instantly find the 5 laggiest chunks on your server, helping you pinpoint the exact source of entity-based lag.
✅ Full Admin Control: Manually clear items or mobs on demand, and reload the entire plugin configuration without a server restart using `/lagspike reload`.
✅ 100% Configurable: Every message, color, timer, and setting can be changed in the `config.yml`.
✅ User-Friendly Commands: All commands feature full tab-completion for ease of use.
Commands & Permissions
| Command | Permission | Description |
| /lagspike status | (none) | Shows the server's current TPS, entities, and memory. |
| /lagspike reload | lagspike.admin | Reloads the entire plugin configuration. |
| /lagspike clear <items|mobs> | lagspike.clear | Manually clears all items or configured mobs. |
| /lagspike topchunks | lagspike.diagnostics | Shows the top 5 chunks with the most entities. |
*(All permissions default to OP)*
⚙️ Default Configuration
Spoiler: Click to view the default config.yml
Code (YAML):
[/B
]
[B ] # LagSpike Guardian Configuration[/B]
[B]tps-threshold : 18.5 [/B ]
[B ] [/B ]
[B ]entity-clearing: [/B ]
[B ] mobs-to-clear: [/B ]
[B ] - ZOMBIE [/B ]
[B ] - SKELETON [/B ]
[B ] - SPIDER [/B ]
[B ] - CREEPER [/B ]
[B ] - PHANTOM [/B ]
[B ] - CHICKEN [/B ]
[B ] - COW [/B ]
[B ] [/B ]
[B ]item-clearing: [/B ]
[B] enabled : true [/B ]
[B] clear-interval-minutes : 15 [/B ]
[B ] warning-times-seconds: [/B ]
[B ] - 60 [/B ]
[B ] - 30 [/B ]
[B ] - 10 [/B ]
[B ] dont-clear-items: [/B ]
[B ] - DIAMOND [/B ]
[B ] - DIAMOND_BLOCK [/B ]
[B ] - NETHERITE_INGOT [/B ]
[B ] - NETHERITE_BLOCK [/B ]
[B ] - BEACON [/B ]
[B ] - ELYTRA [/B ]
[B ] [/B ]
[B ]redstone-limiter: [/B ]
[B] enabled : true [/B ]
[B] pulse-threshold-per-second : 15 [/B ]
[B ] disabled-worlds: [/B ]
[B ] - "skyblock_world" [/B ]
[B ] - "creative" [/B ]
[B] disable-duration-seconds : 30 [/B ]
[B ] [/B ]
[B ]messages: [/B ]
[B] prefix : "&8[&cGuardian&8] " [/B ]
[B] no-permission : "&cYou do not have permission to use this command." [/B ]
[B] reload-success : "&aLagSpike Guardian configuration reloaded!" [/B ]
[B] unknown-command : "&cUnknown sub-command. Use /lagspike status, reload, clear, or topchunks." [/B ]
[B ] [/B ]
[B] status-header : "&8--- &6LagSpike Guardian Status &8---" [/B ]
[B] status-tps : "&eTPS: &a%tps%" [/B ]
[B] status-entities : "&eTotal Entities: &a%amount%" [/B ]
[B] status-memory : "&eMemory Usage: &a%used%MB / %max%MB" [/B ]
[B ] [/B ]
[B] entity-clear-broadcast : "&eCleared %amount% entities to improve server health." [/B ]
[B ] [/B ]
[B] item-clear-warning : "&eClearing ground items in %time% seconds!" [/B ]
[B] item-clear-broadcast : "&aCleared %amount% ground items." [/B ]
[B ] [/B ]
[B] topchunks-header : "&8--- &6Top 5 Laggiest Chunks &8---" [/B ]
[B] topchunks-format : "&e%rank%. &bWorld&f: %world% &bX&f: %x% &bZ&f: %z% &8- &a%amount% entities" [/B ]
[B] topchunks-calculating : "&eCalculating, please wait..." [/B ]
[B ] [/B ]
[B] manual-clear-items : "&aSuccessfully cleared %amount% items." [/B ]
[B] manual-clear-mobs : "&aSuccessfully cleared %amount% mobs." [/B ]
[B ]
[B ] # LagSpike Guardian Configuration[/B]
[B]tps-threshold : 18.5 [/B ]
[B ] [/B ]
[B ]entity-clearing: [/B ]
[B ] mobs-to-clear: [/B ]
[B ] - ZOMBIE [/B ]
[B ] - SKELETON [/B ]
[B ] - SPIDER [/B ]
[B ] - CREEPER [/B ]
[B ] - PHANTOM [/B ]
[B ] - CHICKEN [/B ]
[B ] - COW [/B ]
[B ] [/B ]
[B ]item-clearing: [/B ]
[B] enabled : true [/B ]
[B] clear-interval-minutes : 15 [/B ]
[B ] warning-times-seconds: [/B ]
[B ] - 60 [/B ]
[B ] - 30 [/B ]
[B ] - 10 [/B ]
[B ] dont-clear-items: [/B ]
[B ] - DIAMOND [/B ]
[B ] - DIAMOND_BLOCK [/B ]
[B ] - NETHERITE_INGOT [/B ]
[B ] - NETHERITE_BLOCK [/B ]
[B ] - BEACON [/B ]
[B ] - ELYTRA [/B ]
[B ] [/B ]
[B ]redstone-limiter: [/B ]
[B] enabled : true [/B ]
[B] pulse-threshold-per-second : 15 [/B ]
[B ] disabled-worlds: [/B ]
[B ] - "skyblock_world" [/B ]
[B ] - "creative" [/B ]
[B] disable-duration-seconds : 30 [/B ]
[B ] [/B ]
[B ]messages: [/B ]
[B] prefix : "&8[&cGuardian&8] " [/B ]
[B] no-permission : "&cYou do not have permission to use this command." [/B ]
[B] reload-success : "&aLagSpike Guardian configuration reloaded!" [/B ]
[B] unknown-command : "&cUnknown sub-command. Use /lagspike status, reload, clear, or topchunks." [/B ]
[B ] [/B ]
[B] status-header : "&8--- &6LagSpike Guardian Status &8---" [/B ]
[B] status-tps : "&eTPS: &a%tps%" [/B ]
[B] status-entities : "&eTotal Entities: &a%amount%" [/B ]
[B] status-memory : "&eMemory Usage: &a%used%MB / %max%MB" [/B ]
[B ] [/B ]
[B] entity-clear-broadcast : "&eCleared %amount% entities to improve server health." [/B ]
[B ] [/B ]
[B] item-clear-warning : "&eClearing ground items in %time% seconds!" [/B ]
[B] item-clear-broadcast : "&aCleared %amount% ground items." [/B ]
[B ] [/B ]
[B] topchunks-header : "&8--- &6Top 5 Laggiest Chunks &8---" [/B ]
[B] topchunks-format : "&e%rank%. &bWorld&f: %world% &bX&f: %x% &bZ&f: %z% &8- &a%amount% entities" [/B ]
[B] topchunks-calculating : "&eCalculating, please wait..." [/B ]
[B ] [/B ]
[B] manual-clear-items : "&aSuccessfully cleared %amount% items." [/B ]
[B] manual-clear-mobs : "&aSuccessfully cleared %amount% mobs." [/B ]
[B ]
Installation
[*]Download the `LagSpikeGuardian.jar` file.
[*]Place the JAR in your server's `plugins` folder.
[*]Restart your server. The `config.yml` and other files will be generated automatically.
[*]Enjoy a lag-free server!
Support
This plugin was designed to be powerful yet simple to use. If you have any suggestions for future features, find a bug, or need help, please use the discussion thread or leave a review!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
[FREE] LagSpike Guardian - The Ultimate Performance & Diagnostics Toolkit [1.20.1] is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 61 times (via Spigot). Download it and open it directly in the game.