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/.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21.4, 1.21.5, 1.21.6
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as LagProtector-1.0.0.jar — drop this file into the mods folder
- Download size: 82 KB
- Download link checked 22 Aug 2026 — working
These come from our own check of the pack file, not from the source page.