ModsFinder

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.

FabricNeoForgeServer-side onlyMIT License1.21.4

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

  1. Automatic incident capture

    Sustained MSPT spikes trigger a structured snapshot without any command from an operator.

  2. Suspicious chunk ranking

    The report points to the chunks where load is most concentrated, not only to the total server load.

  3. Windowed MSPT statistics

    Average, 95th percentile and maximum tick times are tracked over windows to separate lasting problems from brief peaks.

  4. Throttled, asynchronous dumps

    A cooldown limits how often reports are written, and a hard scan budget caps the work each capture performs.

Compatibility

Latest build for each game version and loader.

1.21.41.8.0+mc1.21.4-2026-04-251.8.1+mc1.21.4-2026-05-01
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

How it compares

Full comparison

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.

ModLoadersGame versionsEnvironmentUpdated
PerfTriageFabric and NeoForge1.21.4Server-side only2026-05-03
ServersPulseFabric, Forge and NeoForge1.8 – 26.2Not published2026-07-29
TickShieldFabric1.21.11Server-side only2026-04-12

Questions

Does PerfTriage need to be installed on player clients?

No. Server owners install it, and players connect with no copy of their own.

Which loaders and version is PerfTriage published for?

Fabric and NeoForge, for 1.21.4 only. The latest Fabric file is 1.8.0+mc1.21.4-2026-04-25 and the latest NeoForge file is 1.8.1+mc1.21.4-2026-05-01, both dated 2026-05-03 on the listing.

Can PerfTriage replace spark?

No. PerfTriage records focused reports after lag spikes, while spark is a full profiler for deeper analysis. The two are meant to be used together.

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

All projects

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.
IonHex975, on the Modrinth page

Official listing

Owner
IonHex975
Published
2026-02-28
Updated on Modrinth
2026-05-03
Facts verified
2026-10-15

Tags