SGUProfiler
by MiYui34
SGUProfiler is a Fabric profiler that samples per-entity work during the server tick and prints the results to chat.
What it does
The mod samples the cost of each entity during the server tick, covering AI, entity tick, movement and teleport, and collisions. Its reports show how many milliseconds each sampled bucket used per tick, so a server owner can see which dimension or entity group takes the most time while a profiling window is open. Because the numbers are per sampled tick for each bucket, they are not the same as the whole-server MSPT shown by F3, and the row totals should not be read as server MSPT.
Reports are printed in chat with Carpet's Messenger styling when Carpet is present, so installing Carpet with its intended colors gives the cleanest output. Carpet is needed to profile bot Attack and Use splits, which separate fake-player time from the other ActionPack buckets. Optional dimension filters narrow the output to bot-only mode for Carpet players. Without Carpet, the core profiling still runs.
The mod is released under the MIT License and is open source. Either side can run it, and neither needs it, so a server can add it without requiring players to install anything. It requires Fabric Loader 0.16.0 or later, Fabric API matching the Minecraft version, and Java 21 or newer. Use a Carpet build compatible with the Minecraft version in use.
Key features
Per-entity tick sampling
Samples the server tick by entity group, covering AI, entity tick, movement, teleport and collisions.
Chat reports in milliseconds
Each sampled tick bucket is reported in milliseconds, with output styled through Carpet's Messenger when Carpet is present.
Bot Attack and Use splits
With Carpet installed, fake-player time is split into Attack and Use, apart from the other ActionPack buckets.
Dimension filters
Optional filters limit the report to a dimension or to bot-only mode for Carpet players.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
TPS Reforged is a client and server Fabric mod for 1.21.1, under All rights reserved, so it must also be on each player's client. Carpet FZ Addition is server-side only for 1.21.11 and is open source under the GNU General Public License v3.0 only, which makes it a companion for Carpet features rather than a per-entity tick profiler. TPSnitch is server-side only, open source under the Apache License 2.0, and covers 1.21 – 26.2.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| SGUProfiler | Fabric | 1.21.1 – 1.21.11 | Client or server, optional | 2026-05-13 |
| TPS Reforged | Fabric | 1.21.1 | Client and server | 2026-05-20 |
| Carpet FZ Addition | Fabric | 1.21.11 | Server-side only | 2026-05-28 |
| TPSnitch | Fabric | 1.21 – 26.2 | Server-side only | 2026-07-09 |
Questions
Does SGUProfiler need Carpet?
Which Fabric API version does SGUProfiler need?
Do players have to install SGUProfiler?
In the catalog
SGUProfiler is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 19,862 mods support Minecraft 1.21.11.
Similar mods
What the author says
SGUProfiler samples per-entity work on the server tick (AI, entity tick, movement/teleport, collisions, and more). When Carpet is present, you can also split fake-player time into Attack, Use, and other ActionPack buckets. Reports are printed in chat using Carpet’s Messenger styling (install Carpet for the intended…
Official listing
- Modrinth page
- modrinth.com/mod/sguprofiler
- Owner
- MiYui34
- Published
- 2026-05-13
- Updated on Modrinth
- 2026-05-13
- Facts verified
- 2026-10-15
