<\/p>\n
#### spark is a performance profiler for Minecraft clients, servers and proxies.<\/p>\n
#### Useful Links
\n* **Website** – browse the project homepage
\n* **Documentation** – read documentation and usage guides
\n* **Downloads** – latest plugin\/mod downloads<\/p>\n
___<\/p>\n
<\/p>\n
spark is proudly sponsored by BisectHosting.\u200b<\/p>\n
BisectHosting are Minecraft server hosting experts, ready to help you create and host your very own server! They are a trusted and well-established hosting provider in the community, and provide an outstanding level of service that we are happy to recommend. There is a special 25% off discount available for spark users – click the link above to create your server today.<\/p>\n
## What does spark do?<\/p>\n
spark is made up of three separate components:<\/p>\n
* **CPU Profiler**: Diagnose performance issues.
\n* **Memory Inspection**: Diagnose memory issues.
\n* **Server Health Reporting**: Keep track of overall server health.<\/p>\n
### \u26a1 CPU Profiler<\/p>\n
spark’s profiler can be used to diagnose performance issues: “lag”, low tick rate, high CPU usage, etc.<\/p>\n
It is:<\/p>\n
* **Lightweight** – can be ran in production with minimal impact.
\n* **Easy to use** – no configuration or setup necessary, just install the plugin.
\n* **Quick to produce results** – running for just ~30 seconds is enough to produce useful insights into problematic areas for performance.
\n* **Customisable** – can be tuned to target specific threads, sample at a specific interval, record only “laggy” periods, etc
\n* **Highly readable** – simple tree structure lends itself to easy analysis and interpretation. The viewer can also apply deobfuscation mappings.<\/p>\n
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.<\/p>\n
There are two different profiler engines:
\n* Native `AsyncGetCallTrace` + `perf_events` – uses async-profiler (*only available on Linux x86_64 systems*)
\n* Built-in Java `ThreadMXBean` – an improved version of the popular WarmRoast profiler by sk89q.<\/p>\n
### \u26a1 Memory Inspection<\/p>\n
spark includes a number of tools which are useful for diagnosing memory issues with a server.<\/p>\n
* **Heap Summary** – take & analyse a basic snapshot of the servers memory
\n * A simple view of the JVM’s heap, see memory usage and instance counts for each class
\n * Not intended to be a full replacement of proper memory analysis tools. (see below)
\n* **Heap Dump** – take a full (HPROF) snapshot of the servers memory
\n * Dumps (& optionally compresses) a full snapshot of JVM’s heap.
\n * This snapshot can then be inspected using conventional analysis tools.
\n* **GC Monitoring** – monitor garbage collection activity on the server
\n * 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.
\n * Observe frequency\/duration of young\/old generation garbage collections to inform which GC tuning flags to use<\/p>\n
### \u26a1 Server Health Reporting<\/p>\n
spark can report a number of metrics summarising the servers overall health.<\/p>\n
These metrics include:<\/p>\n
* **TPS** – ticks per second, to a more accurate degree indicated by the \/tps command
\n* **Tick Durations** – how long each tick is taking (min, max and average)
\n* **CPU Usage** – how much of the CPU is being used by the server process, and by the overall system
\n* **Memory Usage** – how much memory is being used by the process
\n* **Disk Usage** – how much disk space is free\/being used by the system<\/p>\n
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.<\/p>\n
## Usage
\nTo install, just add the **.jar** file to your mods directory.<\/p>\n
Information about how to use commands can be found in the docs.<\/p>\n
If you\u2019d like help analysing a profiling report, or just want to chat, feel free to join us on Discord.<\/p>\n
## Guides
\nThere are a few small “guides” available in the docs, covering the following topics.
\n* The tick loop
\n* Finding the cause of lag spikes<\/p>\n","protected":false},"excerpt":{"rendered":"
spark is a performance profiler for Minecraft clients, servers and proxies.<\/p>\n","protected":false},"featured_media":146082,"template":"","meta":{"_minecraft_slug":"spark","_minecraft_project_id":"l6YH9Als","_minecraft_author":"lucko","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":15666313,"_minecraft_follows":1948,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"spark.zip","_minecraft_size_bytes":342722666,"_minecraft_version_count":110,"_minecraft_updated_at":"2026-05-15T17:50:09.313513Z","_minecraft_date_created":"2021-06-04T13:36:54.735179Z","_minecraft_date_modified":"2026-03-26T08:30:19.360685Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/spark","_minecraft_icon_attachment_id":146082,"_minecraft_imported_at":"2026-06-08T17:57:27+00:00","_minecraft_import_hash":"35c470fa9f95f543908413ae7373efae","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,158,98,92],"mod_loader":[99,106,160,100],"minecraft_version":[48,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-146081","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-neoforge","mod_category-quilt","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-16-5","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n