# LagSpike Guardian
\n### Your All-in-One Solution for Server Stability
\n—
\nAs a developer and server enthusiast, I know the biggest challenge for any server owner is lag. It can come from anywhere\u2014a 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.<\/p>\n
—
\n### \u2b50 Features
\n– \u2705 **Automatic TPS Monitoring:** Intelligently clears entities only when your server’s TPS drops below a configured threshold, preventing lag without disrupting gameplay.
\n– \u2705 **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.
\n– \u2705 **Smart Redstone Limiter:** Detects and temporarily disables hyperactive redstone clocks that cause server lag, with whitelisted worlds to protect player builds.
\n– \u2705 **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.
\n– \u2705 **Full Admin Control:** Manually clear items or mobs on demand, and reload the entire plugin configuration without a server restart using `\/lagspike reload`.
\n– \u2705 **100% Configurable:** Every message, color, timer, and setting can be changed in the `config.yml`.
\n– \u2705 **User-Friendly Commands:** All commands feature full tab-completion for ease of use.<\/p>\n
— *(All permissions default to OP)*<\/p>\n — “`yaml entity-clearing: item-clearing: redstone-limiter: messages: status-header: “&8— &6LagSpike Guardian Status &8—” entity-clear-broadcast: “&eCleared %amount% entities to improve server health.”<\/p>\n item-clear-warning: “&eClearing ground items in %time% seconds!” topchunks-header: “&8— &6Top 5 Laggiest Chunks &8—” manual-clear-items: “&aSuccessfully cleared %amount% items.” Your Server’s Silent Protector.<\/p>\n","protected":false},"featured_media":91572,"template":"","meta":{"_minecraft_slug":"lagspike-guardian","_minecraft_project_id":"kpFBW5XJ","_minecraft_author":"Kazumiii-arch","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":60,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lagspike-guardian.zip","_minecraft_size_bytes":17222,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:48:09.405994Z","_minecraft_date_created":"2025-08-07T20:21:27.431952Z","_minecraft_date_modified":"2025-07-28T10:00:58.870560Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lagspike-guardian","_minecraft_icon_attachment_id":91572,"_minecraft_imported_at":"2026-06-05T05:33:51+00:00","_minecraft_import_hash":"05eecf6521c5c5033f2b2794ba22cfa9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132,134],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-91571","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n
\n### \ud83d\udcd9 Commands & Permissions
\n| Command | Permission | Description |
\n| :— | :— | :— |
\n| `\/lagspike status` | *(none)* | Shows the server’s current TPS, entities, and memory. |
\n| `\/lagspike reload` | `lagspike.admin` | Reloads the entire plugin configuration. |
\n| `\/lagspike clear
\n| `\/lagspike topchunks` | `lagspike.diagnostics` | Shows the top 5 chunks with the most entities. |<\/p>\n
\n### \u2699\ufe0f Default Configuration
\nThis plugin is fully customizable. See how much control you have by viewing the default `config.yml` below.<\/p>\nClick to view the default config.yml<\/summary>\n
\n# LagSpike Guardian Configuration
\ntps-threshold: 18.5<\/p>\n
\n mobs-to-clear:
\n – ZOMBIE
\n – SKELETON
\n – SPIDER
\n – CREEPER
\n – PHANTOM
\n – CHICKEN
\n – COW<\/p>\n
\n enabled: true
\n clear-interval-minutes: 15
\n warning-times-seconds:
\n – 60
\n – 30
\n – 10
\n dont-clear-items:
\n – DIAMOND
\n – DIAMOND_BLOCK
\n – NETHERITE_INGOT
\n – NETHERITE_BLOCK
\n – BEACON
\n – ELYTRA<\/p>\n
\n enabled: true
\n pulse-threshold-per-second: 15
\n disabled-worlds:
\n – “skyblock_world”
\n – “creative”
\n disable-duration-seconds: 30<\/p>\n
\n prefix: “&8[&cGuardian&8] ”
\n no-permission: “&cYou do not have permission to use this command.”
\n reload-success: “&aLagSpike Guardian configuration reloaded!”
\n unknown-command: “&cUnknown sub-command. Use \/lagspike status, reload, clear, or topchunks.”<\/p>\n
\n status-tps: “&eTPS: &a%tps%”
\n status-entities: “&eTotal Entities: &a%amount%”
\n status-memory: “&eMemory Usage: &a%used%MB \/ %max%MB”<\/p>\n
\n item-clear-broadcast: “&aCleared %amount% ground items.”<\/p>\n
\n topchunks-format: “&e%rank%. &bWorld&f: %world% &bX&f: %x% &bZ&f: %z% &8- &a%amount% entities”
\n topchunks-calculating: “&eCalculating, please wait…”<\/p>\n
\n manual-clear-mobs: “&aSuccessfully cleared %amount% mobs.”<\/p>\n","protected":false},"excerpt":{"rendered":"