Modrinth · Fabric, Forge, NeoForge, Quilt

spark on your Minecraft server

spark runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

spark is a performance profiler for Minecraft clients, servers and proxies.

Downloads
24.6M
Author
lucko
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
1.16.5 – 26.3
Updated
–

Setup

Install spark on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 26.3.

  3. 03

    Install the mod

    Search the mod browser for “spark” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    spark is optional on the client. Players connect using the server address from the panel.

On the server
Optional
On the client
Optional
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
26.3, 26.2, 26.1.2 +31 more
License
GNU General Public License v3.0 only

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

spark · Modrinth
Original description by the project author

spark

spark is a performance profiler for Minecraft clients, servers and proxies.
Useful Links

spark is proudly sponsored by .​

What does spark do?

spark is made up of three separate components:

  • CPU Profiler: Diagnose performance issues.
  • Memory Inspection: Diagnose memory issues.
  • Server Health Reporting: Keep track of overall server health.
⚡ CPU Profiler

spark's profiler can be used to diagnose performance issues: "lag", low tick rate, high CPU usage, etc.

It is:

  • Lightweight - can be ran in production with minimal impact.
  • Easy to use - no configuration or setup necessary, just install the plugin.
  • Quick to produce results - running for just ~30 seconds is enough to produce useful insights into problematic areas for performance.
  • Customisable - can be tuned to target specific threads, sample at a specific interval, record only "laggy" periods, etc
  • Highly readable - simple tree structure lends itself to easy analysis and interpretation. The viewer can also apply deobfuscation mappings.

It works by sampling statistical data about the systems activity, and constructing a call graph based on this data. The call graph is then displayed in an online viewer for further analysis by the user.

There are two different profiler engines:

  • Native AsyncGetCallTrace + perf_events - uses async-profiler (only available on Linux x86_64 systems)
  • Built-in Java ThreadMXBean - an improved version of the popular WarmRoast profiler by sk89q.
⚡ Memory Inspection

spark includes a number of tools which are useful for diagnosing memory issues with a server.

  • Heap Summary - take & analyse a basic snapshot of the servers memory
    • A simple view of the JVM's heap, see memory usage and instance counts for each class
    • Not intended to be a full replacement of proper memory analysis tools. (see below)
  • Heap Dump - take a full (HPROF) snapshot of the servers memory
    • Dumps (& optionally compresses) a full snapshot of JVM's heap.
    • This snapshot can then be inspected using conventional analysis tools.
  • GC Monitoring - monitor garbage collection activity on the server
    • Allows the user to relate GC activity to game server hangs, and easily see how long they are taking & how much memory is being free'd.
    • Observe frequency/duration of young/old generation garbage collections to inform which GC tuning flags to use
⚡ Server Health Reporting

spark can report a number of metrics summarising the servers overall health.

These metrics include:

  • TPS - ticks per second, to a more accurate degree indicated by the /tps command

  • Tick Durations - how long each tick is taking (min, max and average)

  • Memory Usage - how much memory is being used by the process

  • Disk Usage - how much disk space is free/being used by the system

As well as providing tick rate averages, spark can also monitor individual ticks - sending a report whenever a single tick's duration exceeds a certain threshold. This can be used to identify trends and the nature of performance issues, relative to other system or game events.

Usage

To install, just add the .jar file to your mods directory.

Information about how to use commands can be found in the docs.

If you’d like help analysing a profiling report, or just want to chat, feel free to join us on Discord.

Guides

There are a few small "guides" available in the docs, covering the following topics.

FAQ

spark questions

Question not listed? Ask our team.

spark server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does spark run on?

According to Modrinth, spark supports Fabric, Forge, NeoForge, Quilt for Minecraft 26.3, 26.2, 26.1.2. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.

How much RAM does a server with spark need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with spark?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server