Tree Host

What Is TPS in Minecraft and How Do You Check It?

Updated · by the Tree Host team

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.

TermMeaningHealthy
TPSTicks finished per second19.5 to 20
MSPTMilliseconds per tickUnder 50, ideally under 35
PingDelay between one player and the serverUnder 100 ms
FPSFrames per second on a player's computerNot 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.

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.

CommandWhat it does
/tick queryShows the target tick rate, the average tick time and percentiles
/tick rate 20Sets the target tick rate (the default is 20)
/tick freezeStops the world ticking while players can still move around
/tick unfreezeStarts 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

TPSWhat players seeWhat to do
19.5 to 20SmoothNothing
18 to 19.5Rare hiccupsWatch it, check after busy hours
15 to 18Mobs jump, blocks reappearFind the cause now
Under 15Hard lag, delayed chestsStop 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

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

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.

More guides

← More guides