- Loaders
- Fabric
- Downloads on Modrinth
- 164
- Followers on Modrinth
- 0
- versions
- 8
- Updated
- May 13, 2026May 13
- Published
- in 2026
At a glance
Works both in the game and on the server — install where you need it
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 colors; core profiling still runs without it).
Why use it
- Find which entities in which dimension dominate tick time during a window you control.
- Optional dimension filters and bot-only mode for Carpet players.
- Configurable auto MSPT, scheduled profiles, sampling stride / heavy-tick modes, and noise floor in
config/sguprofiler.json.
Requirements
- Minecraft: 1.21.1, 1.21.4, 1.21.6–1.21.11 (incl. 1.21.10) — use the file **`sguprofiler-+mc<YOUR_MC>.jar`** that matches your game.
- Java 21+
- Fabric Loader (≥ 0.16.0; see project metadata)
- Fabric API for your MC version
Optional: Carpet — needed for profile … bot and Attack/Use splits; use a Carpet build compatible with your MC.
Quick start
- Install Fabric + Fabric API (matching MC).
- Drop the correct
+mc…jar inmods/. - You must be a vanilla operator, or be listed in
config/sguprofiler_command_whitelist.json(managed by OP / high-permission console). In-game (root literal is case-sensitive):
/SGUProfiler profile start— full profile/SGUProfiler profile start overworld/nether/end/all— dimension filter/SGUProfiler profile start bot— Carpet fake-player actions only (with Carpet)/SGUProfiler profile stop— stop and print report
Report numbers are ms per sampled tick for each bucket — not the same thing as whole-server MSPT from F3; don’t treat row sums as “the server MSPT”.
Links
- Source / issues: https://github.com/MiYui34/SGUprofiler/issues
- Carpet: https://modrinth.com/mod/carpet
- Fabric API: https://modrinth.com/mod/fabric-api
License: MIT
FAQ
How to install SGUProfiler?
Install Fabric for your Minecraft version, download SGUProfiler for the same version and loader, put the file into the mods folder and launch the game with the loader profile.
Which Minecraft versions does SGUProfiler support?
SGUProfiler has builds for Minecraft 1.21.1, 1.21.4, 1.21.6–1.21.11.
Is SGUProfiler needed on the server?
Works on either side — install it in the game, on the server, or both
