Load and parse a spark file from a local path, a bytebin/spark.lucko.me URL, or a bytebin key. Supports .sparkprofile (sampler), .sparkheap (memory), and .sparkhealth (health) files. Returns a profileId plus a headline summary; all other tools take that profileId.

List the profiles currently loaded in memory (id, type, source).

Headline health summary: server/MC version, TPS, MSPT, heap, GC%, entities, top hot methods & plugin sources, and the overall diagnosis verdict.

Apply the built-in interpretation knowledge base (TPS/MSPT/GC/heap/CPU thresholds, plugin dominance, entity/chunk/redstone/IO signatures, JVM-flag checks) and return ranked findings, each with evidence, diagnosis, and a concrete recommended action. This is the primary 'what should I tune' tool.

Server brand/version, Minecraft version, the plugin/mod list with versions, config file names, and key config highlights (view/simulation-distance, spawn limits, etc.).

Host CPU/RAM/disk/OS, Java version, JVM args (secrets redacted), detected GC, Xmx/Xms, and an Aikar's-flags check.

Tick health: TPS (1m/5m/15m), MSPT percentiles (mean/median/p95/max), ping, heap, GC analysis, and — for .sparkhealth reports (and the windows inside a sampler) — the per-minute time series with the worst windows highlighted.

World/entity statistics: total entities, top entity types by count, per-world entity totals, data packs, non-default game rules.

List the sampled threads (name, total sampled ms, node count), busiest first. Use a name with the call-tree tools.

Top methods by self-time on a thread (default 'Server thread'). excludeNative drops idle/native wait frames to reveal the hottest Java methods.

Self-time grouped by plugin/mod source (spark 'sources' view) on a thread. excludeNative drops idle frames. Shows which plugin/mod owns the work.

Pruned call tree for a thread. Children below minPercent of the thread total are dropped and depth is capped. Pass rootPath (an array of 'Class.method' labels/substrings) to descend into a specific subtree before expanding.

Find stack frames whose Class.method matches a substring or /regex/, returned with total/self time. Useful to check whether a suspected plugin/mechanic appears and how heavy it is.

For a .sparkheap file: the largest retained types by size, with instance counts.