![LagShield Title](https://cdn.modrinth.com/data/cached_images/ae55d0b0e10767b72a813e9bedc8336f652f9a5b.png) [

](https://modrinth.com/project/pdYTEg3Q) [ hangar

](https://hangar.papermc.io/us3rn1me/LagShield) [ generic-plural

](https://coindrop.to/username) --- ## 🛡️ Overview **LagShield** is a powerful, all-in-one server performance optimization plugin for Minecraft 1.13+. Say goodbye to low TPS and lags with intelligent entity management, redstone lag prevention, and automated server configuration optimization. ### ✨ Features #### 🧹 **Intelligent Entity Cleaner** - **Item Cleanup**: Automatically removes dropped items in chunks with excessive ground items - **Entity Cleanup**: Manages entity populations in overcrowded chunks - **Countdown System**: Warns players before cleanup with accurate countdowns - **Configurable Thresholds**: Set minimum item/entity counts and countdown times - **Smart Detection**: Only targets problematic chunks, not the entire world #### ⚡ **Redstone Lag Prevention** - **Clock Detection & Breaking**: Automatically detects and dismantles lag-causing redstone clocks - Observer clocks (facing observers) - Repeater/Comparator loops - Hopper clocks - Torch clocks (rapid update detection) - **Item Recovery**: Drops broken redstone components as items for player retrieval - **Placement Prevention**: Stops clock patterns from being placed - **Anti-Spam Protection**: Prevents redstone interaction spam (150 interactions/5s threshold) #### ⚙️ **Automatic Server Optimization** - **Config Tweaks**: Applies performance-optimized settings to server configs - **Engine-Aware**: Detects your server type (Bukkit/Spigot/Paper/Purpur) and applies appropriate tweaks - **Customizable Tweaks**: All optimization files are extracted to `plugins/LagShield/tweaks/` for review and modification - **Reversible**: All changes are backed up and can be reverted - **Auto-Restart**: Automatically restarts server after first-time tweak application #### 📊 **Performance Monitoring** - `/lagshield tps` - View real-time TPS (1m, 5m, 15m averages) - `/lagshield ping [player]` - Check player latency - `/lagshield bar` - Show a performance bar - `/lagshield panel` - Show a performance panel GUI - Server uptime tracking --- ## 📥 Installation 1. **Download** the latest version from [Modrinth](https://modrinth.com/project/pdYTEg3Q) or [Hangar](https://hangar.papermc.io/us3rn1me/LagShield) 2. **Drop** the JAR file into your `plugins/` folder 3. **Start** your server - LagShield will generate default configs 4. **Restart** - Server will auto-restart after applying tweaks for the first time 5. **Configure** (optional) - Edit `plugins/LagShield/config.yml` and tweak files --- ## 🎮 Commands | Command | Permission | Description | |---------|------------|-------------| | `/lagshield reload` | `lagshield.admin` | Reload configuration | | `/lagshield tps` | `lagshield.tps` | Show server TPS | | `/lagshield ping [player]` | `lagshield.ping` | Show player ping | | `/lagshield clearitems` | `lagshield.clearitems` | Trigger item cleanup | | `/lagshield disable` | `lagshield.admin` | Disable the plugin | **Aliases**: `/ls`, `/shield` --- ## 📋 Permissions ```yaml lagshield.admin # Full access to all commands lagshield.tps # Use /lagshield tps lagshield.ping # Check own ping lagshield.ping.others # Check other players' ping lagshield.clearitems # Trigger item cleanup lagshield.notify # Receive cleanup notifications ``` --- ## ⚙️ Configuration ### Main Config (config.yml) ```yaml # LagShield Configuration plugin: debug: false # Enables verbose logging. Prints detailed information about applied tweaks, # detected server type, file merges, and restoration steps. prefix: "&a&lLag&2&lShield&r &7| &r" # Chat prefix used for all plugin messages. Supports legacy color codes. tweaks: enable: true # Enables or disables all server configuration optimizations # (server.properties, bukkit.yml, spigot.yml, Paper/Purpur configs). # Disabling this restores the user's original values. cleaner: enable: true # Enables the smart item and entity cleanup system. mode: 3 # 1 = clean dropped items only # 2 = clean entities only # 3 = clean both items and entities min-items: 50 # Minimum number of dropped items in an area required to start # the cleanup countdown. item-countdown: 10 # Time in seconds before dropped items are removed once the # threshold is reached. min-entities: 50 # Minimum number of entities in a chunk required to trigger # entity cleanup in that chunk. entity-countdown: 10 # Time in seconds before entities are removed from the chunk # once the threshold is exceeded. redstone: disable-clocks: false # Completely disables redstone clock mechanisms. # Use only if clocks are a major source of lag. anti-redstone-spam: true # Detects excessive redstone updates caused by a player and # temporarily blocks redstone interaction for that player. anti-redstone-spam-disable-time: 30 # Duration (in seconds) for which redstone usage is blocked # for a player after triggering anti-spam protection. mob-stacker: enable: true # Enables the mob stacking feature to reduce entity count. max-stack-size: 50 # Maximum number of mobs allowed in a single stack. stack-radius: 5 # Radius in blocks to search for other mobs to stack with. update-interval: 5 # How often (in seconds) to scan for mobs to stack. nametag-format: "&6{amount}x &f{type}" # Format of the stack nametag. # {amount} = stack size # {type} = entity type name explosions: enable: true # Enables the explosion limiter to prevent server crashes from massive TNT chains. max-explosions-per-tick: 5 # Maximum number of block-breaking explosions allowed per tick. # Excess explosions will be neutralized to preserve TPS. prevention-mode: 1 # 1 = Cancel explosion event completely (Safest: No damage, no block break) # 2 = Cancel block breaks only (Entity damage still occurs) ``` --- ## 🔧 How It Works ### First-Time Setup 1. Plugin extracts tweak files to `plugins/LagShield/tweaks/` 2. Creates `tweaks-applied.txt` marker file 3. Applies optimizations to server configs 4. Shows 5-second countdown 5. **Automatically restarts** server to apply changes ### Subsequent Starts - Tweaks are managed normally (enable/disable via config) - No automatic restart - Changes can be reverted by disabling tweaks ### Entity Cleaner - Scans chunks every 30 seconds - Chunks exceeding thresholds enter countdown - Countdown decrements every second - Players receive warnings at each second - At 0 seconds, excess entities/items are removed ### Redstone Protection - Monitors redstone events for clock patterns - Detects rapid updates (>6.6/second) - Identifies structural patterns (observers, loops) - Breaks connected components (up to 50 blocks) - Drops items at block locations --- ## 📊 Compatibility ### Supported Servers - ✅ **Bukkit** - ✅ **Spigot** - ✅ **Paper** - ✅ **Purpur** - ✅ **Pufferfish** - ✅ **Folia** ### Java Version - **Minimum**: Java 21 - **Recommended**: Java 21/25 --- ## 📈 Statistics

Stats

[![LagShield bStats Image](https://bstats.org/signatures/bukkit/lagshield.svg)](https://bstats.org/plugin/bukkit/LagShield/28419)

--- ## 📜 License

EULA

END USER LICENSE AGREEMENT (EULA) for LagShield Last Updated: December 19, 2025 Author: us3rn1me ("the Author") Jurisdiction: Poland By downloading, installing, or using the LagShield plugin (the "Software"), you agree to be bound by the following terms. If you do not agree to these terms, do not download or use the Software. 1. License Grant The Author grants you a non-exclusive, non-transferable license to use LagShield on your Minecraft server(s). This license covers both private and commercial use, meaning you may use this plugin on servers that generate revenue (e.g., through ranks or donations), provided the server remains in compliance with the Mojang Studios EULA. 2. Intellectual Property LagShield is Closed Source. You acknowledge that all title, ownership rights, and intellectual property rights in and to the Software remain the sole property of us3rn1me. * You may not decompile, reverse engineer, disassemble, or attempt to derive the source code of the Software. * You may not modify the Software or create derivative works based upon it. 3. Redistribution & Mirroring Redistribution of LagShield is strictly prohibited unless you have obtained prior written permission from the Author. If permission is granted, you must provide clear and visible credit to us3rn1me and link back to the official download page. 4. Data Collection LagShield utilizes bStats to collect anonymous usage data (such as server version, player count, and system information). This data is used solely to help the Author understand how the plugin is performing and how to improve it. No personally identifiable information is collected. You may opt-out of this collection via the bStats configuration file. 5. Support Policy The Author is not obligated to provide technical support, bug fixes, or updates for the Software. * Any support provided is done so at the Author's sole discretion. * Users are invited to seek community-based assistance via the Author's official Discord server, but the Author does not guarantee a response or a resolution. 6. Disclaimer of Warranty THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. The Author does not guarantee that the Software will meet your requirements or that its operation will be uninterrupted or error-free. You assume all responsibility for determining whether the Software is suitable for your server environment. 7. Limitation of Liability To the maximum extent permitted by Polish Law, the Author shall not be liable for any damages (including, but not limited to, server crashes, data loss, loss of profits, or player dissatisfaction) arising out of the use or inability to use this Software. 8. Termination This license is effective until terminated by you or the Author. Your rights under this license will terminate automatically without notice if you fail to comply with any term(s) of this EULA.

--- ## 💝 Donate If LagShield has helped improve your server performance, consider supporting development! [ generic-plural

](https://coindrop.to/username) --- **Made with ❤️ by us3rn1me**

us3rn1me

us3rn1me's Plugins

LagShield by us3rn1me

us3rn1me's Organizations

Stars

Watching

LagShield by