How to Install and Use Spark

Spark is a performance profiling plugin/mod which provides you with a variety of tools which help when diagnosing performance and memory issues.

While Spark is simple to install it has a lot of options, commands, and information that can feel a bit overwhelming to users. If you need help at any time, please don't hesitate to contact our 24/7 support team or check out the Spark documentation available here.


Installing Spark

To install Spark, you will need to download its jar file, and then upload it to your relevant mods or plugins folder.

  1. Download Spark from CurseForge or download the Spigot version here.

  2. Navigate to your control panel and Stop your server.
  3. Access your server files via FTP, we recommend using FileZilla.
  4. Navigate to the /mods directory.
  5. Upload the spark.jar file.
  6. Start your server.

Generating and Accessing a Profiler Report

Although there are a variety of utility commands provided by Spark, we will only cover the CPU profiler tool. We highly recommend you refer to the Spark documentation if you'd like to learn more detail about the CPU profiler tool or the other tools Spark provides.

Running the Spark profiler will generate a link that will direct you to your server's Spark report. This link can be sent to Shockbyte Support to help our staff diagnose the cause of lag, however, it can be insightful to more advanced users as well.

  1. Connect to your server and ensure you are an op or have the permission node spark.profiler.
  2. After installing Spark and allowing your server to run for 10 minutes or more, type the command /Spark Profiler --Stop.
  3. Click the link provided after your Spark report generates.

Analysing the Profiler

After opening your profiler report, you can click the Server thread dropdown menu to expand the server's threads. According to the Spark Documentation, "Threads (at the top of the profile) will always show 100% next to them; this is because 100% of the time spent profiling the thread was, well, spent within that thread."

Call threads (or each item in the dropdown menu) may be a little confusing, especially if you're new to Java programming or Minecraft server internals. You can find a list of notable call frames to be aware of on the Spark Documentation here.

  1. Click the Call thread called Server thread to expand the menu
  2. Click the next Call thread which had taken the most percentage of time to complete to continue expanding the tree
  3. Continue this process until you have found a Call thread which gives you enough information to continue troubleshooting
  4. In this example, we can determine that our server lag is caused by an excessive amount of entities. Now we can focus on troubleshooting entity lag thanks to Spark.

To learn more about Spark and how to use it, we highly recommend reading the Spark Using the Viewer documentation.

If you require any further assistance, please contact our support at: https://shockbyte.com/billing/submitticket.php

Mitchell Smith

Managing Director @ Shockbyte

  • plugin, mod, performance, spark
  • 15 Users Found This Useful
Was this answer helpful?

Related Articles

How to Install Sponge on a Forge Server

You may learn more about SpongeForge and the Sponge project by visiting the official Sponge...

How to Install Fabric Mods on Your PC

This guide explains how to install mods onto your Fabric client. Fabric, like Forge, is a version...

How to Install Minecraft Forge on Your PC

We have a tutorial for installing Minecraft Forge on your computer:   Forge is a Minecraft...

How to Install Modpacks on Your Computer Using the CurseForge App

CurseForge is a Minecraft launcher owned by Overwolf that allows you to install thousands of...

How to Use Buycraft / Tebex on Your Server (Monetisation)

Tebex, formerly known as Buycraft, is the primary webstore application used across thousands of...