How to Profile a Paper Minecraft Server with spark

A spark profile helps explain where a Paper Minecraft server spends processing time. It is most useful when the server is actively doing the work that players say is slow.

Before capturing anything, write a short problem statement: “block placement delays when four players visit the trading hall” is better than “server lag.” It gives you a workload to repeat after a fix.

Prepare a representative capture

Record the server build, plugin versions, player count, and recent changes. Ask players to repeat their normal activity rather than create an artificial stress test they never perform in regular play.

Paper's official profiling instructions give this example:

/spark profiler start --timeout 600

Check your installation's command help if the command is unavailable. Permissions, server age, and whether spark is bundled or separately installed can affect what you see.

Follow the expensive work

When the capture completes, open the report and look at the period corresponding to the complaint. Identify the main server thread and investigate expensive branches of work. A large entry is a starting point, not automatic proof that the named plugin is defective.

Some plugins legitimately do work on behalf of player actions. A protection plugin checking a huge build operation may appear prominently because another system generated an unusually large request.

Keep the report with a plain-language description of what happened during the capture. That context is valuable to a plugin maintainer or host support team.

Compare a controlled change

Test one hypothesis: reduce a particular activity, adjust one configuration setting, or update one confirmed component on a copy. Repeat the same workload and capture again.

Compare player experience and measurements. Do not disable every plugin on a live community world merely to obtain a clean-looking graph; the altered server may no longer represent actual use.

Can a profile tell me which hosting plan to buy?

It can identify whether the workload is CPU-heavy or associated with memory pressure. Combine it with the host's resource graphs and a busy-session test before choosing a larger plan.

For interpreting tick metrics, read TPS vs MSPT.

Choose your next step

Compare EZ Game Host Minecraft hosting for your group. Choose resources for your actual world and workload, then keep a downloadable backup before changing hosts.