MINECRAFTBIBLE
Loading...
Automatically captures lag incidents on Fabric servers and points you to suspicious hotspot chunks.
PerfTriage is a lightweight server-side lag triage mod for Fabric.
It stays quiet during normal gameplay.
When your server hits sustained MSPT spikes, it automatically captures a structured diagnostic snapshot of what was loaded, where it was concentrated, and which chunks are most suspicious.
It is built for one practical question:
When lag happened, what exactly was going on?
Most server lag does not happen while you are actively profiling.
By the time players report:
…the moment is often already gone.
PerfTriage is designed for that exact problem.
Instead of running as a heavy always-on profiler, it waits for meaningful lag spikes, then records a focused report so you still have evidence after the incident.
PerfTriage monitors:
When triggered, it generates a structured report with:
avg / p95 / max)Reports are written asynchronously to:
config/perftriage/reports/
Both:
.txt for humans.json for toolsLag is often caused by local concentration, not just global load.
Typical examples include:
PerfTriage does not only tell you what was loaded.
It tells you where the concentration was.
That means you can:
PerfTriage is not a replacement for full profilers like spark.
They solve different problems.
| Tool | Best for | Typical workflow |
|---|---|---|
| PerfTriage | Automatically catching lag incidents | Install and wait for spikes |
| spark | Deep profiling and root-cause investigation | Run manually when needed |
| Both together | Catch first, investigate later | Best overall workflow |
PerfTriage is for automatic incident capture.
spark is for deeper profiling after you know where to look.
That is why they work well together.
PerfTriage is especially useful for:
PerfTriage does not continuously instrument tick functions.
Instead, it focuses on:
This makes it suitable for real servers where stability matters.
/perftriage dump now
/perftriage status
Displays:
entity_hot_type: minecraft:acacia_boat
entity_hot_chunks_topN:
- -4,-4: 35320
- -4,-3: 35280
- -5,-3: 31600
This means most of the detected hotspot population is concentrated in those chunks.
PerfTriage focuses on:
It is designed to help you keep evidence when lag happens, instead of forcing you to guess after the fact.
1.20.x / 1.21.x)MIT
Built for real servers.
Designed for real lag.