Guides · Minecraft servers
Reduce lag
Find the cause → lower distances → pre-generate chunks.
1. Server lag or internet lag?
| Symptom | Cause |
|---|---|
| Everyone stutters together · mobs and blocks react late | Server lag (low TPS) |
| Only one player stutters · high ping | That player's internet |
| Only when exploring new areas | Chunk generation → step 4 |
2. Find the cause (spark)
- Paper, Leaf and Purpur 1.21+: the
sparkconsole command is built in. Other versions and modded servers: install the spark plugin or mod. spark tps: 20 = healthy. MSPT (time per tick) over 50 ms means lag.spark profiler start→ 3–5 minutes while it lags →spark profiler stop→ open the link and look at the heaviest entries.
| Heavy in spark | What to do |
|---|---|
| Entities · villagers | Fewer mobs in farms · clear dropped items |
| Hoppers · redstone | Shrink large contraptions |
| Chunk generation (worldgen) | Pre-generate chunks |
| A specific plugin or mod | Fix its settings · remove it |
3. Lower the distances
Panel → Files → server.properties → save → restart.
| Setting | SJNoDE default | If it lags |
|---|---|---|
view-distance (how far you see) | 8 | 6 |
simulation-distance (how far mobs and crops update) | 6 | 4 |
4. Pre-generate chunks
- Install Chunky and restart.
- Console
chunky radius 5000→chunky start. Run it when few players are online. - Set a world edge:
worldborder set 10000(diameter).
Disk space per radius: Create a Minecraft server, step 6.
5. Switch to Leaf
Paper-based · Paper plugins keep working · lighter with many players.
| Players (10 GB · 1.21.11) | Paper average tick | Leaf average tick |
|---|---|---|
| 15 | 32.5 ms | 25 ms |
| 20 | 46.3 ms | 35 ms |
- Back up first.
- Service page → Version · reset → server type Leaf · same version.
- To keep the current world, choose Keep the world (risky).
6. Memory
- If Memory on the panel console stays near the limit, you are short of memory → Upgrade.
- If memory is free but TPS is low, more memory will not help. Do steps 2–5 first.