How to Install and Use Spark Profiler
Learn how to install Spark to diagnose lag, monitor TPS, and generate performance reports.
Spark is a performance profiler that helps you identify what's causing lag on your server. It monitors TPS, memory usage, and CPU time per plugin/task.
Installing Spark
Check if Spark is pre-installed
Paper 1.21+ comes with Spark built-in. Try running /spark tps in Console first. If it works, you're already set.
Download Spark (if needed)
Download from spark.lucko.me for your server type.
Upload to your server
Access the XGamingServer panel, go to Files, navigate to /plugins/ (or /mods/), and upload the .jar.
Using Spark
Check Server Health
spark healthShows TPS, MSPT, CPU usage, and memory stats.
Check TPS
spark tpsShows recent TPS (ticks per second). 20.0 is perfect.
Run a Profiler
spark profiler startWait 5-10 minutes of normal gameplay, then:
spark profiler stopSpark generates a shareable link to view the report.
Reading a Spark Report
The report shows a flame graph where:
- Wider bars = more CPU time spent there
- Plugin names = identify which plugins use the most resources
- Minecraft internals = entity ticking, chunk loading, etc.
Commands Reference
| Command | Description |
|---|---|
/spark tps | Current TPS |
/spark health | Overall server health |
/spark profiler start | Start profiling |
/spark profiler stop | Stop and generate report |
/spark gc | Garbage collection stats |
/spark heapdump | Create heap dump for memory analysis |
💡 Tip: Share your Spark report link in our Discord and we can help identify the cause of lag.
See also: Performance Guide | How Much RAM
If you need help, join our Discord.
How is this guide?
