What Is TPS in Minecraft and How Do You Check It?
TPS means ticks per second. A Minecraft server aims for 20 TPS, which is also the maximum, so each tick has 50 milliseconds. To check it, run /tps on Paper or Purpur, /tick query on vanilla 1.20.3 or newer, or /spark tps if you have the Spark plugin or mod. A result of 19.5 to 20 is healthy. Below 18 players notice lag.
What a tick is
The server does its work in small steps called ticks. In one tick it moves mobs, grows crops, runs redstone, updates hoppers and handles what players did. The game is built around 20 of these every second. That gives each tick a budget of 50 milliseconds, because 1000 divided by 20 is 50.
TPS is how many ticks the server actually finished in the last second. MSPT is how many milliseconds a single tick took. They describe the same thing from two sides. If every tick takes 30 ms, the server finishes its work early and waits, so TPS stays at 20. If ticks take 80 ms, the server can only manage about 12 per second.
TPS can never go above 20. The server waits for the rest of the 50 ms when it is ahead. That is why a number like 20.0 only tells you the server is keeping up, not how much spare time it has. MSPT tells you the spare time.
| Term | Meaning | Healthy |
|---|---|---|
| TPS | Ticks finished per second | 19.5 to 20 |
| MSPT | Milliseconds per tick | Under 50, ideally under 35 |
| Ping | Delay between one player and the server | Under 100 ms |
| FPS | Frames per second on a player's computer | Not a server number |
1. Check TPS on Paper, Purpur and Spigot
Open the console or join as an operator. If you need operator rights, see our guide to making yourself op.
- Run
/tps. Paper, Purpur and Spigot print three numbers: the average over the last 1, 5 and 15 minutes. - Read the first number for what is happening now and the third for the longer trend.
- Run
/mspton Paper and Purpur to see how long ticks take, with the average, minimum and maximum. - Check while players are online. An empty server almost always shows 20.
Paper may show a star before a value, such as *20.0. That means the number was capped at 20 for display. It is not a problem.
2. Check TPS on a vanilla server
Plain vanilla servers have no /tps command. Since Java Edition 1.20.3 there is a /tick command instead.
| Command | What it does |
|---|---|
/tick query | Shows the target tick rate, the average tick time and percentiles |
/tick rate 20 | Sets the target tick rate (the default is 20) |
/tick freeze | Stops the world ticking while players can still move around |
/tick unfreeze | Starts ticking again |
Do not change /tick rate to fix lag. Lowering it slows down the whole game, including mobs and crops. Use it for testing only, and set it back to 20.
3. Check TPS on Fabric
Fabric has no built-in /tps either. The usual answer is the Spark mod, which is available on Modrinth. Install the Fabric version of Spark in the mods folder, restart, then run /spark tps. It prints TPS and MSPT. Spark also works as a plugin on Paper, so the same command works on both.
Our Paper vs Purpur vs Fabric guide explains which server software suits you.
4. Read the numbers
| TPS | What players see | What to do |
|---|---|---|
| 19.5 to 20 | Smooth | Nothing |
| 18 to 19.5 | Rare hiccups | Watch it, check after busy hours |
| 15 to 18 | Mobs jump, blocks reappear | Find the cause now |
| Under 15 | Hard lag, delayed chests | Stop heavy farms, lower distances, restart |
A short dip right after a restart or when many players join at once is normal. A dip that stays is not.
5. Why TPS drops
- Too many loaded chunks. Each player loads chunks around them based on
view-distanceandsimulation-distance. - Chunk generation. Players exploring new land make the server build terrain, which is heavy.
- Too many entities, such as large mob farms, animals in small pens and piles of dropped items.
- Slow plugins or mods. A profiler such as Spark shows which one.
- Too little memory. When Java spends its time clearing memory, ticks get delayed.
- Redstone clocks and hopper chains that run all the time.
Our full walkthrough is in How to fix Minecraft server lag. For memory sizing, see how much RAM a Minecraft server needs.
6. Find the cause with a profiler
If TPS stays low, run /spark profiler start, play for a few minutes, then run /spark profiler stop. Spark gives you a link to a report that shows which plugins, mods and world tasks take the most time. Look at the biggest items first. Often it is one plugin or one chunk full of animals.
7. Quick fixes that help
- Lower
view-distanceto 8 to 10 andsimulation-distanceto 6 to 8 inserver.properties. See server.properties explained. - Pre-generate the world so players do not trigger generation while exploring.
- Clear dropped items and cull mob farms.
- Remove or update the plugin that the profiler points at.
- Restart the server if TPS has slowly dropped over days.
Tree Host puts a TPS button in the console, so you can check without typing a command. The troubleshooting guide covers the next steps.
Tree Host shows TPS in the console and charts memory and CPU, so you can see lag before players report it.