lagprotector

LagProtector is a cozy little Paper/Folia plugin that helps your server stay calm when one corner of the world gets a bit too excited—big mob farms, chunky redstone, or chunks that quietly hoard way too many entities and tile blocks.

What you get

• Per-chunk limits for mobs and other entities, so one hotspot can’t tank everyone else’s TPS.
• Caps for mechanics-style blocks (hoppers, furnaces, and friends) per chunk—and optional checks so pistons can’t shuffle tiles across chunk lines just to dodge the limit.
• Optional cleanup waves for things already over the line—you’re not only blocking new spawns, you’re also tidying up.
• Ignore rules for stuff players care about: named mobs, tamed pets, babies, geared armor stands, and more—so the plugin doesn’t feel mean-spirited.
• Folia-friendly scheduling, so it plays nice with region threading.

Requirements

• Paper or Folia 1.21.4+
• Java 21 on the server

Commands
| Command | Permission | What it does |
| --- | --- | --- |
| /lagprotector reload | lagprotector.reload (default: op) | Reloads config.yml and restarts the scheduled cleanup tasks |

Config
Everything lives in config.yml. For the full walkthrough—options, defaults, and how spawn limits interact with EntityTypes, BlockTypes, and AutoClean—check docs/configuration.md in the repo.

Build from source
./gradlew shadowJar → jar in build/libs/.