How to Set Up and Use Spark


Mods and plugins are a great addition to your server that can make your game much more interactive and fun by adding new content and features.

This guide will help you with setting up and using the Spark plugin or mod on your server.

—

# ❓ What Is Spark❓

Once you add plugins or mods, which are more demanding and sometimes add new content to your game, performance issues can pop up at any time. Spark is a plugin or mod that will help you identify the source of your lag or performance issues, so you can handle them.

The Spark plugin and mod work for Minecraft versions 1.7 to 1.19.

> You can read more about the Spark mod [here](https://spark.lucko.me/docs) in the official documentation or [here](https://www.curseforge.com/minecraft/mc-mods/spark) on the official CurseForge page.
> You can read more about the Spark plugin [here](https://spark.lucko.me/docs) in the official documentation or [here](https://www.spigotmc.org/resources/spark.57242/) on the official Spigot page.
|| ⚠ **NOTE **⚠: You need to run as server type Forge or Fabric to be able to use the Spark mod version. If you are using the plugin version, Bukkit, Spigot, or Paper are required as server types.

Our team may request a spark report from your server in certain tickets, so we can identify lag-related issues.

—

# How to Install Spark

Spark can be set up as a plugin or a mod, depending on the server type you are using.

—

## The Spark Mod

The first step is to make sure you are running Forge or Fabric.

If not, [here](https://help.ggservers.com/en-us/article/how-to-install-any-server-type-clean-installation-133ufiy/) is our guide for doing a clean installation of Forge or Fabric on your server. Beware that this process will delete all server files, so you will have to download anything important before.

||| Here is our guide for installing mods on your server.
|| ⚠ **NOTE **⚠: If you are running Fabric, you will also have to install the FabricAPI mod as it is a dependency for Spark. You can find the FabricAPI mod [here](https://www.curseforge.com/minecraft/mc-mods/fabric-api).

—

Now, to set up the mod, you will have to:

1. Log in to your Multicraft panel [here](https://mc.ggservers.com/site/login) and stop your server.


—

2. Download the appropriate version of the mod [here](https://www.curseforge.com/minecraft/mc-mods/spark/files) according to the Forge/Fabric version you are running.


—

3. Use FileZilla to upload the mod to your server’s `mods` folder.


||| [Here](https://help.ggservers.com/en-us/article/how-to-connect-to-your-server-using-filezilla-yl0q5r/) is our guide for using FileZilla.

—

4. Open your Multicraft panel and start your server.


—

## The Spark Plugin

The first step is to be sure you are running Bukkit, Spigot, or Paper.

If not, [here](https://help.ggservers.com/en-us/article/how-to-change-your-server-type-and-version-ve6dtm/) is our guide for changing your server type to Bukkit, Paper, or Spigot. It is recommended to do a backup before any server type changes. [Here](https://help.ggservers.com/en-us/article/how-to-make-a-backup-and-download-it-noz1kf/) is our guide for doing a backup.

||| [Here](https://help.ggservers.com/en-us/article/how-to-install-plugins-on-your-server-1yxw90a/) is our guide for installing plugins on your server.

—

Now, to set up the plugin, you will have to:

1. Log in to your Multicraft panel [here](https://mc.ggservers.com/site/login) and stop your server.


—

2. Download the appropriate version of the plugin [here](https://www.spigotmc.org/resources/spark.57242/) according to the Bukkit, Spigot, or Paper version you are running.


—

3. Use FileZilla to upload the plugin to your server’s `plugins` folder.


||| [Here](https://help.ggservers.com/en-us/article/how-to-connect-to-your-server-using-filezilla-yl0q5r/) is our guide for using FileZilla.

—

4. Open your Multicraft panel and start your server.


—

# How to Generate a Spark Report

To generate a Spark report, you will have to:

1. Log in to your Multicraft panel [here](https://mc.ggservers.com/site/login) and start your server.


—

2. Use the `/spark profiler –only-ticks-over 150` command in-game or in the Multicraft console.


|| ⚠ **NOTE **⚠: You need to use the command without the `/` at the beginning if you choose to use it via the Multicraft console (`spark profiler –only-ticks-over 150`).

—

3. Now that you have started the Spark profiler, you just need to play on your server for a minimum of 30 minutes, so the profiler can register your performance issues. The best results will be given when you experience lag on the server since Spark will be able to register that and provide you with a conclusive report.


—

4. Use the `/spark profiler –stop` command in-game or in the Multicraft console.


|| ⚠ **NOTE **⚠: You need to use the command without the `/` at the beginning if you choose to use it via the Multicraft console ( `spark profiler –stop` ).

As you can see, the Spark profiler provided a link in the console logs. You will have to open the link with an internet browser to be able to see the generated report.

—

# How to Read Your Spark Report


The profiler will list any process that took over 150 ms to execute, which is for sure causing lag on your server. You can click on them to open any subprocess. This way, you can find out which action, mob, or mod is responsible for the lag on your server.

|| ⚠ **NOTE **⚠: In Minecraft, when the code loop happens, we call that a tick, like the tick of a clock. There are 20 ticks per second, meaning every tick takes at most 50 milliseconds. 20 is known as TPS (ticks per second), and 50 is known as MSPT (milliseconds per tick). Because of that, if a tick takes longer than 50ms  (150 ms, for example), this will surely cause lag, as other actions have to wait for that tick to finish.

—

The spark report will also provide the class for any item listed, which can help you identify if the process was added by a specific plugin or mod.


—

You can also highlight processes in the report by right-clicking and then clicking on `Toggle Bookmark`.


In most cases, our team will request a Spark report from you to identify what is causing performance issues on your server.

—

| If you find any issues setting up or using the Spark mod, contact us on live chat or via the [ticket system](https://help.ggservers.com/en-us/article/how-to-open-a-support-ticket-qjzuyd/).
—

# ❕Useful Links❕

– [How to Install Mods on Your Server](https://help.ggservers.com/en-us/article/how-to-install-mods-on-your-server-1bauy2t/)
– [How to Set Up and Use Biomes O’ Plenty Mod](https://help.ggservers.com/en-us/article/how-to-set-up-and-use-biomes-o-plenty-mod-1kuwpqm/)
– [How to Install Mods Into Your Client](https://help.ggservers.com/en-us/article/how-to-install-mods-into-your-client-1t47nya/)