SGUProfiler

SGUProfiler

服务端 Fabric 模组：按实体逐 tick 工作的示例

管理

SGUProfiler 对服务器 tick 中每个实体的工作进行采样（AI、实体 tick、移动/传送、碰撞等）。当安装了 Carpet 时，你还可以将假玩家的时间拆分为 攻击、使用 和其他 ActionPack 分类。报告通过 Carpet 的 Messenger 样式在聊天中打印（安装 Carpet 以获得预期的颜色；核心性能分析在没有它的情况下仍然可以运行）。

为什么使用它

  • 找出在你控制的时间窗口内，哪个维度中的哪些实体占据了 tick 时间的主导地位。
  • 可选的维度过滤器和仅限 Carpet 玩家的 机器人模式。
  • 可在 config/sguprofiler.json 中配置自动 MSPT、计划分析、采样步长 / 高负载 tick 模式以及噪声基底。

环境要求

  • Minecraft： 1.21.1、1.21.4、1.21.6–1.21.11（包括 1.21.10）——使用与你的游戏版本匹配的文件 sguprofiler-<版本>+mc<你的MC版本>.jar。
  • Java 21+
  • Fabric Loader（≥ 0.16.0；参见项目元数据）
  • 适用于你 MC 版本的 Fabric API

可选： Carpet — 用于 profile … bot 以及攻击/使用拆分；请使用与你的 MC 版本兼容的 Carpet 构建。

快速开始

  1. 安装 Fabric + Fabric API（匹配 MC 版本）。
  2. 将正确的 +mc… jar 文件放入 mods/ 文件夹。
  3. 你必须是原版 管理员，或者被列入 config/sguprofiler_command_whitelist.json（由 OP / 高权限控制台管理）。
  4. 在游戏中（根命令区分大小写）：
    • /SGUProfiler profile start — 完整分析
    • /SGUProfiler profile start overworld / nether / end / all — 维度过滤器
    • /SGUProfiler profile start bot — 仅 Carpet 假玩家动作（需要 Carpet）
    • /SGUProfiler profile stop — 停止并打印报告

报告中的数字是每个分类的每采样 tick 毫秒数 — 不是 F3 中显示的整个服务器 MSPT；不要将行总和视为“服务器 MSPT”。

链接

许可证： MIT