Entity activation range and mob caps are two of the most important performance settings for Minecraft servers. They control how many mobs exist and how far away from players they run AI.
Entity Activation Range
Entity activation range determines the distance at which mobs run their full AI. Mobs outside this range still exist but do not pathfind, attack, or perform complex behaviors.
Default Spigot Values (spigot.yml)
entity-activation-range:
animals: 32
monsters: 32
raiders: 48
misc: 16
water: 16
villagers: 32
flying-monsters: 32
Optimized Values for Busy Servers
entity-activation-range:
animals: 16
monsters: 24
raiders: 48
misc: 8
water: 8
villagers: 16
flying-monsters: 32
Lower values = less CPU usage. Mobs outside the range barely affect performance.
Paper Extensions
Paper adds more granular control:
# paper-world-defaults.yml
entity-activation-range:
villagers:
tick-inactive-villagers: false # Huge performance gain
Disabling inactive villager ticking is one of the most impactful optimizations for servers with trading halls.
Mob Caps
Mob caps limit how many mobs can exist per player. When the cap is reached, no more mobs of that category spawn.
Default Bukkit Values (bukkit.yml)
spawn-limits:
monsters: 70
animals: 10
water-animals: 5
water-ambient: 20
water-underground-creature: 5
axolotls: 5
ambient: 15
Optimized Values
spawn-limits:
monsters: 40
animals: 8
water-animals: 3
water-ambient: 8
water-underground-creature: 3
axolotls: 3
ambient: 3
Reducing monster spawns from 70 to 40-50 significantly reduces entity count while keeping gameplay functional.
The Combined Effect
High mob caps + large activation ranges = maximum lag. By reducing both:
- Fewer mobs exist overall (lower caps)
- Existing mobs use less CPU (smaller activation range)
- Server TPS stays closer to 20
Per-World Configuration
Paper supports per-world settings. Set aggressive limits for resource worlds and standard limits for the main overworld.
FAQ
What is entity activation range? The distance in blocks at which mobs run full AI. Mobs further away are dormant.
What are mob caps in Minecraft? Limits on how many mobs can exist per player. Higher caps = more mobs = more lag.
Should I lower mob caps? Yes, if your server has TPS issues. Reduce monster cap to 40-50 for a good balance.
Will players notice reduced entity activation range? At moderate values (16-24), barely noticeable. Mobs still spawn and fight when players are nearby.
Related: MSPT explained, View distance guide, World pregeneration