Skip to content Nodecraft

How to Make a Timings Report on a Minecraft Server

Support / Minecraft / Performance / How to Make a Timings Report on a Minecraft Server
Create a Minecraft Server today!
Start Free Trial

Spigot, PaperMC, and SpongeForge have a great built in tool called a Timings Report. It can be used to diagnose lag on your Minecraft server by providing a very thorough breakdown on your server's performance and can point out key aspects that may be bogging down resources. It's very easy to turn on and utilize!

If you're using any of the following commands in the Nodecraft Console, drop the / at the beginning of the commands.

Using the Timings Report in Spigot

The first 4 steps are only recommended for Spigot builds between 1261 - 1537. Please skip to Step 5 if using any of the latest builds.

  1. First, Stop your server. This is always recommended whenever you make any changes to settings or files.

  2. Navigate to your File Manager on the left hand side of your NodePanel, select the bukkit.yml file and click the Edit button. The NodePanel showing the location of the bukkit.yml file

  3. Find the plugin-profiling setting and change it to true. Showing the plugin-profiling setting in the bukkit.yml file in NodePanel

  4. Save the changes and start your server up.

  5. Issue the /timings on command either in the console of your server, or in-game while you're OP'd.

  6. Wait 10-15 minutes while the server is experiencing the lag, that way the server can collect as much data as accurately as possible. Usually this means playing on the server, to ensure the server creating the appropriate scenarios that cause the server to lag, but not crash.

  7. Issue the command /timings paste. This will provide you with a URL link that will take you to the Timings Report. The NodePanel's Console showing the timings commands as well as the URL link provided to the Timings Report

  8. Make sure to issue the command /timings off, as leaving the Timings Report on can use additional resources on your server.

Using the Timings Report in PaperMC

In the latest builds for PaperMC, the Timings Report feature is enabled by default. It is usually why whenever you start your server, you'll see a line in your server's Console that says Timings Reset. If you see this line in your console, skip to Step 4.

  1. First, Stop your server. This is always recommended whenever you make any changes to settings or files.

  2. Navigate to your File Manager on the left hand side of your NodePanel, select the paper.yml and then click the Edit button. The Nodepanel's File Manager showing the location of the paper.yml file

  3. Find the timings section, and make sure the enabled and verbose setting are set to true. PaperMC's papaer.yml file showing the timings report settings in the NodePanel

  4. Save the changes and start your server up. You should now see Timings Reset in your console. You can also issue the command /timings reset to make the Timings Report start a brand new report.

  5. Wait 10-15 minutes while the server is experiencing the lag, that way the server can collect as much data as accurately as possible. Usually this means playing on the server, to ensure the server creating the appropriate scenarios that cause the server to lag, but not crash.

  6. Issue the command /timings paste, this will provide you with a URL link that will take you to the Timings Report. The Nodepanel Console showing PaperMC's Timings commands

  7. If you wish to turn off the Timings Report feature, open the paper.yml file again and set the timings enabled setting to false.

Using the Timings Report in SpongeForge

  1. Issue the /sponge timings on command either in the console of your server, or in-game while you're OP'd.

  2. Wait 10-15 minutes while the server is experiencing the lag, that way the server can collect as much data as accurately as possible. Usually this means playing on the server, to ensure the server creating the appropriate scenarios that cause the server to lag, but not crash.

  3. Issue the command /sponge timings paste or sponge timings report, this will provide you with a URL link that will take you to the Timings Report.

  4. Make sure to issue the command /timings off, as leaving the Timings Report on can use additional resources on your server. The NodePanel's Console showing the Sponge Timings commands

Other useful commands to make note of for the SpongeForge version is /sponge timings verbon which provides more verbose monitoring. The /sponge timings verboff command disables the verbose monitoring.

Analyze your Timings Report

Now it's time to use the URL link provided to you. It will point out problem areas, and may also give some suggestions on how you can improve on your servers performance like using Aikar's flags. Feel free to Chat with Us in Customer Support if you need some help in reading the Timings Report! It can be a little overwhelming and confusing the first time you view one of these reports. https://app.nodecraft.com/support

Need Help?

If you have questions or run into any issues, our support team is here to help! Reach out using the support widget on our website or visit our support center for further assistance.