
PerfTriage
自动捕获Fabric服务器上的卡顿事件,并指向可疑的热点区块。
查看大图⚡ PerfTriage – 面向 Fabric 服务端的自动卡顿取证工具
在卡顿发生时自动捕获
PerfTriage 是一个轻量级的 服务端卡顿分诊模组,适用于 Fabric。
它在正常游戏过程中保持静默。 当你的服务器出现持续的 MSPT 飙升时,它会自动捕获一份结构化的诊断快照,记录 加载了什么、集中在何处,以及哪些区块最可疑。
它只为一个实际问题而生:
当卡顿发生时,到底发生了什么?
为什么要安装 PerfTriage?
大多数服务端卡顿 并非 发生在你正在主动进行性能分析的时候。
等到玩家反馈:
- “服务器卡死了”
- “某个区域出问题了”
- “TPS 又掉了”
……那一刻往往已经过去了。
PerfTriage 正是为此问题而设计。
它不作为重型常驻分析器运行,而是等待有意义的卡顿峰值出现,然后记录一份聚焦的报告,让你在 事件发生之后 仍有证据可查。

PerfTriage 检测的内容
PerfTriage 监控:
- 持续的 MSPT 飙升
- 卡顿后的自动恢复
- 基于冷却的转储节流
- 硬性扫描预算保护
触发时,它会生成结构化报告,包含:
Tick 分析
- 窗口化 MSPT 统计(
avg / p95 / max) - 采样时长
- 预算使用情况
- 扫描截断状态
世界快照
- 每个维度的已加载区块数
- 实体 / 方块实体总数
- 顶级实体类型
- 顶级方块实体类型
热点分析
- 主导实体类型
- 主导方块实体类型
- 区块级集中度
- 每 tick 平均数量
- 预算信息
- 区块扫描能力标记
报告异步写入:
config/perftriage/reports/
两种格式:
.txt供人阅读.json供工具处理
为什么热点区块很重要
卡顿通常由局部集中引起,而不仅仅是全局负载。
典型例子包括:
- 物品 / 生物 / 船泛滥
- 红石机器
- 刷怪场
- 幽匿农场
- 区块加载器
- 集中分布在少数区块中的异常装置
PerfTriage 不仅告诉你 加载了什么, 它还告诉你 集中在哪里。
这意味着你可以:
- 直接传送到问题区域
- 检查受影响的区块
- 移除来源
- 立即验证改善效果

PerfTriage 与 spark 对比
PerfTriage 不是 spark 等完整分析器的替代品。
它们解决不同的问题。
| 工具 | 最适合 | 典型工作流 |
|---|---|---|
| PerfTriage | 自动捕获卡顿事件 | 安装后等待峰值出现 |
| spark | 深度分析与根因调查 | 需要时手动运行 |
| 两者结合 | 先捕获,后调查 | 最佳整体工作流 |
PerfTriage 用于 自动事件捕获。 spark 用于 在你知道该看哪里之后进行更深入的分析。
这就是它们配合良好的原因。
谁应该安装?
PerfTriage 尤其适用于:
- 只在玩家抱怨后才注意到卡顿的服主
- 需要区块坐标而非仅仅“服务器很慢”的管理员
- 不希望常驻性能分析的生产服务器
- 存在难以手动复现的间歇性卡顿的服务器

它的不同之处?
PerfTriage 不会 持续对 tick 函数进行插桩。
相反,它专注于:
- 仅在 meaningful 卡顿时激活
- 使用严格的扫描与采样预算
- 避免繁重的后台开销
- 生成确定性的快照
- 提供区块级定位
这使得它适用于稳定性至关重要的真实服务器。
命令
手动转储
/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
为真实服务器而构建。 为真实卡顿而设计。
本模组每周更新,可能一周一到两次。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。