Entity count: why mob farms and item piles kill performance

Entity count is one of the most reliable predictors of server lag. A world with 3,000 entities will consistently show lower TPS than the same world with 300, regardless of player count. Understanding what entities are and where they come from is essential for keeping performance stable.

What counts as an entity

In Minecraft, an entity is any object in the world that has independent state and can move or interact. This includes mobs of every type, dropped items on the ground, projectiles, experience orbs, boats and minecarts, armor stands, item frames, lead knots, and falling blocks. Each one is tracked individually by the server and ticked every game tick.

Why entities cause lag

Every tick, the server must process every entity in every loaded chunk: update its position, run its AI, check for collisions, and decide if it should despawn. This work runs on the main thread in most Paper configurations.

A single cow in an empty world costs almost nothing. Ten thousand items dropped in a hopper farm's overflow area can consume most of a tick budget on their own. The relationship between entity count and TPS is roughly linear until you hit a threshold specific to your hardware, at which point each additional entity has an increasingly severe impact.

Per-world tracking

clan.me tracks entity count separately for each world and plots them over time. This matters because a server-wide total of 2,000 entities is very different from a situation where 1,800 of those are in a single resource world while the main world is healthy. The per-world breakdown in your dashboard shows exactly which world is responsible for a spike.

The entity spike alert fires when any single world reaches 3 times its 7-day average entity count, giving you a specific world name to investigate rather than just a server-wide warning.

Common culprits

• Mob farms without kill mechanisms: farms that trap mobs but don't kill them fast enough accumulate entities continuously
• Item overflow from farms: automated farms without proper item management drop items onto the ground when storage is full
• Experience orb piles: XP orbs from large-scale mob farms or player deaths accumulate quickly and are expensive to tick
• Unrestricted pet ownership: players with large numbers of pets in populated areas add persistent entity load that doesn't despawn
• Large explosions: falling blocks are entities, and a big explosion can briefly create hundreds of them