[FREE] LagSpike Guardian - The Ultimate Performance & Diagnostics Toolkit [1.20.1] icon

[FREE] LagSpike Guardian - The Ultimate Performance & Diagnostics Toolkit [1.20.1] -----

Your Server's Silent Protector.

Download Now
29.5 KB .jar



​

━━━━━━━━━━━❖━━━━━━━━━━━​


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

  • ✅ 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
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 ]



Installation

  1. [*]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!​
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 43
First Release: Jul 28, 2025
Last Update: Jul 29, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings
Ask Questions / Get Support