PerfTriage

模组

· 作者 IonHex975

自动捕获 Fabric 服务器上的卡顿事件,并指出可疑的热区区块。

0 本站下载 0 关注 更新于 6 个月前

最新 1.8.1+mc1.21.4-2026-05-01 · 1.21.4 · NeoForge

一键开服(送7天)

⚡ PerfTriage – Fabric 服务器自动卡顿诊断


自动捕捉卡顿瞬间

PerfTriage 是一款轻量级的 Fabric 服务端卡顿分流模组。

在正常游戏过程中,它会保持静默。 当你的服务器出现持续的 MSPT(每刻毫秒数)尖峰时,它会自动捕获一个结构化的诊断快照,记录加载了什么、集中在哪里、哪些区块最可疑。

它旨在解决一个实际问题:

当卡顿发生时,到底发生了什么?


为什么安装 PerfTriage?

大多数服务器卡顿并不会发生在你正在主动分析性能的时候。

等到玩家报告:

  • “服务器卡死了”
  • “某个区域不对劲”
  • “TPS 又掉了”

……那个时刻往往已经过去了。

PerfTriage 正是为了解决这个问题而设计的。

它不像重型的全程性能分析器那样一直运行,而是等待有意义的卡顿尖峰,然后记录一份重点报告,让你在事件发生后仍能保留证据。

文本报告显示 MSPT 平均值 / p95 / 最大值,以及主要实体类型


PerfTriage 检测什么

PerfTriage 监控:

  • 持续的 MSPT 尖峰
  • 卡顿后的自动恢复
  • 基于冷却时间的转储节流
  • 硬性扫描预算保护

触发后,它会生成一份结构化报告,包含:

Tick 分析

  • 窗口化 MSPT 统计信息(avg / p95 / max)
  • 采样持续时间
  • 预算使用情况
  • 扫描截断状态

世界快照

  • 每个维度已加载的区块数量
  • 实体/方块实体总数
  • 主要实体类型
  • 主要方块实体类型

热点分析

  • 主导实体类型
  • 主导方块实体类型
  • 区块级集中度
  • 每刻平均人口密度
  • 预算信息
  • 区块扫描能力标志

报告异步写入以下目录:

config/perftriage/reports/

同时提供两种格式:

  • .txt 供人类阅读
  • .json 供工具处理

为什么热点区块很重要

卡顿通常是由局部集中引起的,而不仅仅是全局负载过高。

典型例子包括:

  • 物品/生物/船只泛滥
  • 红石机器
  • 刷怪塔
  • 潜影贝农场
  • 区块加载器
  • 少数区块内行为异常的机械装置

PerfTriage 不仅告诉你加载了什么。 它还告诉你集中在哪里。

这意味着你可以:

  • 直接传送至问题区域
  • 检查受影响的区块
  • 移除源头
  • 立即验证改善效果

文本报告显示 entity_hot_type , entity_hot_chunks_topN


PerfTriage vs spark

PerfTriage 不是像 spark 这样的完整性能分析器的替代品。

它们解决的问题不同。

工具 最佳用途 典型工作流程
PerfTriage 自动捕获卡顿事件 安装并等待尖峰出现
spark 深度分析和根本原因调查 需要时手动运行
两者结合 先捕获事件,稍后深入调查 最佳整体工作流程

PerfTriage 用于自动捕获事件。 spark 用于在你明确查找方向后进行更深入的剖析。

这就是为什么它们配合使用效果很好。


谁应该安装这个模组?

PerfTriage 对以下用户特别有用:

  • 只有在玩家抱怨后才注意到卡顿的服务器所有者
  • 需要区块坐标而不只是“服务器很卡”的管理员
  • 不希望全程开启性能分析的正式运营服务器
  • 难以手动复现间歇性卡顿的服务器

将 PerfTriage 与 Spark 进行对比


它的独特之处是什么?

PerfTriage 不会持续对 tick 函数进行插桩。

相反,它专注于:

  • 仅在有意义卡顿期间激活
  • 使用严格的扫描和采样预算
  • 避免沉重的后台开销
  • 生成确定性快照
  • 提供区块级定位

这使得它非常适合对稳定性至关重要的正式服务器。


命令

手动转储

/perftriage dump now

状态

/perftriage status

显示:

  • 当前 MSPT 窗口统计信息
  • 剩余冷却时间
  • 上次报告路径
  • 恢复状态

示例热点输出

entity_hot_type: minecraft:acacia_boat
entity_hot_chunks_topN:
  - -4,-4: 35320
  - -4,-3: 35280
  - -5,-3: 31600

这意味着检测到的热点人口主要集中在这些区块中。


兼容性

  • Fabric Loader 0.18+
  • Minecraft 1.21.4
  • 服务端

理念

PerfTriage 专注于:

  • 低开销
  • 确定性诊断
  • 自动操作
  • 生产环境安全

它旨在帮助你在卡顿时保留证据,而不是迫使你事后猜测。


路线图

  • 多版本支持(1.20.x / 1.21.x)
  • 可选的 Top-K 类型区块细分
  • 可配置的阈值
  • 报告索引聚合
  • 可选的性能分析器集成模式

许可证

MIT


为真正的服务器构建。 为真实的卡顿设计。


本模组每周更新,可能一周更新一到两次。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源