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-<version>+mc<YOUR_MC>.jarthat 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
