Chunk Cap Guard

A Minecraft entity cleanup and performance management mod.

Chunk Cap Guard periodically monitors the number of tracked entities in loaded chunks across all biomes. When the number of specified entities in a chunk exceeds the configured limit, the mod removes all matching entities from that chunk to prevent localized entity buildup, reduce server lag, and lower the performance impact caused by abnormal mob concentration.

Features

Long-interval periodic scanning of target entities in loaded chunks
Counts specified entities on a per-chunk basis
Removes all matching entities from a chunk when the target entity count exceeds the limit
Helps control performance issues caused by localized entity overcrowding
Supports configurable scan interval, entity limit, and target entity list
Will broadcast over-limit chunks to all players
Broadcast text that can be changed in the configuration

How It Works

Chunk Cap Guard performs checks at a fixed interval and processes all loaded chunks in the current world:

Iterate through all entities
Count target entities by block area
If the number of target entities in a block area exceeds the upper limit, clear all matching target entities within that block area

Note: When a chunk exceeds the configured limit, Chunk Cap Guard removes all configured target entities in that chunk, rather than only the excess amount.

Example Scenario

Assume the configuration monitors the following entities:

minecraft:zombie
minecraft:skeleton

A chunk contains:

30 Zombies
25 Skeletons

The total number of tracked target entities in that chunk is 55.

If the configured per-chunk entity limit is 50, Chunk Cap Guard will remove all Zombies and Skeletons from that chunk.

Command

tyj cleannow Execute a cleanup immediately and reset the cleanup timer