LagShield

[](modrinth.com/project/pdYTEg3Q)
[](hangar.papermc.io/us3rn1me/LagShield)
[
](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 or Hangar
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

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)

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

📜 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.

1. 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.

1. 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.

1. 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.

1. 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.

1. 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.

1. 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.

1. 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!

[](coindrop.to/username)

Made with ❤️ by us3rn1me