Premium tool · Servers

Server Lag Diagnoser

Rank the causes of low TPS and get the config changes to fix them.

PremiumServers

Enter the numbers from spark, /mspt or your panel. The diagnoser ranks the likely causes of low TPS and gives the Paper, Spigot and server.properties settings to change first.

Server snapshot

MSPT (milliseconds per tick)

Players online

Total entities

Villagers

Hoppers (tile entities)

Loaded chunks

View distance

Simulation distance

Diagnosis

Estimated TPS

16.1

20 TPS needs MSPT under 50

Tick budget used

124%

high priority
4,200 entities (210 per player)
Lower bukkit.yml spawn-limits (monsters 50, animals 8), raise spigot.yml merge-radius item to 3.5, and cap mob farms with entity cramming.
medium priority
350 villagers
Villager pathfinding is expensive. Lock trading halls in 1x1 pods, lower spigot.yml entity-activation-range villagers to 16, and consider Paper villager tick throttling.
medium priority
2,800 hoppers
Set spigot.yml ticks-per hopper-check to 8 and hopper-transfer to 8, and in Paper set hopper.disable-move-event: true. Encourage water streams and composter or block on top of idle hoppers.
medium priority
Simulation distance 10
Set server.properties simulation-distance to 6 to 8. Entities and redstone only tick inside this radius.

Starting configuration

# server.properties
view-distance=10
simulation-distance=8

# spigot.yml (world-settings.default)
entity-activation-range:
  animals: 16
  monsters: 24
  villagers: 16
merge-radius:
  item: 3.5
  exp: 4.0
ticks-per:
  hopper-transfer: 8
  hopper-check: 8

# bukkit.yml
spawn-limits:
  monsters: 50
  animals: 8

Unlock Server Lag Diagnoser

This is a members-only tool. Premium starts at $4.08/mo billed yearly, or pay once for lifetime access.

All 10 Premium planners and optimizers
Saved projects in your Workshop
Priority AI generations and HD exports

See Premium plans

More Premium tools

Anvil Cost Optimizer

Find the cheapest order to combine books and gear before Too Expensive

Redstone Clock Designer

Exact tick timings, repeater counts and hopper clock materials

Trading Hall Planner

Size a villager hall: pods, workstations, emeralds per hour and materials

Spawner XP Optimizer

Mob rates, XP per hour and levels per hour for any spawner setup

Nether Highway Planner

Convert coordinates, cost the tunnel and estimate travel time

Elytra Flight Calculator

Rockets, gunpowder, paper and flight time for any distance