Lag has two different causes, and the fix depends on which one you have:
- Server lag (low TPS): everyone lags at the same time, mobs freeze, blocks come back after you break them.
- Connection lag (high ping): only one player lags, others are fine.
1. Check your TPS
A healthy server runs at 20 TPS. On Paper, type in the console:
tps
Also look at the CPU and memory graphs in the panel. If memory is always full, the server is short on RAM. If CPU is always at the limit, something is using too much processing power.
2. Use Paper, not Vanilla
Paper is a drop-in replacement for the normal server that runs much faster and fixes many bugs. Set it in the Startup tab of the panel and reinstall the server (take a backup first).
3. Lower the distances
In server.properties:
view-distance=8
simulation-distance=6
These two lines alone often double performance. Players still see far enough for normal play.
4. Pre-generate the world
Exploring new land is the heaviest thing a server does. Install the Chunky plugin and run:
chunky radius 3000
chunky start
Let it finish while nobody is online.
5. Find what is lagging
Install the spark plugin and run:
spark profiler start
Wait a few minutes during lag, then:
spark profiler stop
You get a link that shows exactly which plugin, entity or farm uses the most time.
6. Common culprits
- Huge mob farms and thousands of dropped items.
- Redstone clocks that never stop.
- Too many plugins, or an outdated one.
- Not enough RAM for the number of players. If you keep hitting the limit, upgrade your plan from the Client Area.