VillagerLimiter
Lightweight performance plugin that automatically limits the number of villagers per chunk, preventing server lag caused by overbred villager farms.
Features
- Per-chunk villager limit — configurable maximum number of villagers allowed in a single chunk.
- Gradual removal — removes excess villagers in small batches per cycle instead of all at once, avoiding lag spikes.
- Configurable scan interval — control how often chunks are checked.
- Per-world control — enable the limiter only on the worlds you choose.
- Spawn egg toggle — optionally allow villager spawn eggs to bypass the limit.
- In-game GUI — view live stats through
/villager gui. - Detailed stats & debug tools — track cached chunks, total villagers, top overpopulated chunks, and more.
Commands
| Command | Description |
|---|---|
/villager reload |
Reload the configuration |
/villager stats |
Show general statistics |
/villager chunk |
Show info about the chunk you're standing in |
/villager top |
List the top 5 chunks with the most villagers |
/villager debug |
Show detailed internal debug info |
/villager gui |
Open the stats GUI |
/villager tpchunk <world> <x> <z> |
Teleport to a specific chunk |
Permissions
villagerlimiter.reload— allows using/villager reloadvillagerlimiter.tpchunk— allows teleporting to chunks
Configuration
villagerLimit—9checkInterval—60maxRemovalsPerCycle—3allowVillagerSpawnEggs—trueenabledWorlds—world(list of worlds where the limit applies)

