SGUProfiler

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>.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

1. Install Fabric + Fabric API (matching MC).
2. Drop the correct +mc… jar in mods/.
3. You must be a vanilla operator, or be listed in config/sguprofiler_command_whitelist.json (managed by OP / high-permission console).
4. 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: /mod/carpet
• Fabric API: /mod/fabric-api

License: MIT