PerfTriage
by IonHex975
Once a Fabric or NeoForge server shows lasting tick-time spikes, PerfTriage writes a report on what was loaded and where the load sat.
What it does
PerfTriage watches a server's tick time without interfering with ordinary play. It keeps windowed statistics covering average, 95th percentile and maximum MSPT, and when sustained spikes cross its thresholds it writes a focused report instead of running a heavy profiler all the time, so evidence remains after the lag has passed. Reports are written asynchronously, and dumps are throttled by a cooldown and a hard scan budget so the capture itself adds little load.
The mod names the chunks that look most suspicious, because local concentrations of entities or block updates often cause lag even when global load looks ordinary. After a lag event it recovers automatically and resumes watching. PerfTriage does not replace full profilers such as spark; it answers the first question, whether something is wrong and in which area, and spark can then be used for deeper profiling of that area. It is published for Fabric and NeoForge on 1.21.4 only, and it is server-side only, so players join without installing it.
Key features
Automatic incident capture
Sustained MSPT spikes trigger a structured snapshot without any command from an operator.
Suspicious chunk ranking
The report points to the chunks where load is most concentrated, not only to the total server load.
Windowed MSPT statistics
Average, 95th percentile and maximum tick times are tracked over windows to separate lasting problems from brief peaks.
Throttled, asynchronous dumps
A cooldown limits how often reports are written, and a hard scan budget caps the work each capture performs.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
ServersPulse is a Fabric, Forge and NeoForge mod for versions 1.8 – 26.2, licensed under the Apache License 2.0 and open source. TickShield is a Fabric server-side mod for 1.21.11 only, licensed under the Mozilla Public License 2.0 and open source. PerfTriage covers only 1.21.4 and is licensed under the MIT License without being open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| PerfTriage | Fabric and NeoForge | 1.21.4 | Server-side only | 2026-05-03 |
| ServersPulse | Fabric, Forge and NeoForge | 1.8 – 26.2 | Not published | 2026-07-29 |
| TickShield | Fabric | 1.21.11 | Server-side only | 2026-04-12 |
Questions
Does PerfTriage need to be installed on player clients?
Which loaders and version is PerfTriage published for?
Can PerfTriage replace spark?
In the catalog
PerfTriage is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 17,979 mods support Minecraft 1.21.4.
More from IonHex975
Similar mods
What the author says
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.
Official listing
- Modrinth page
- modrinth.com/mod/perftriage
- Owner
- IonHex975
- Published
- 2026-02-28
- Updated on Modrinth
- 2026-05-03
- Facts verified
- 2026-10-15
