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