性能分析工具（Performance Analyzer）
“整合包为什么卡？有人开了刷沙机，怎么知道是哪儿？”
按 G 打开简洁的游戏内性能面板，从维度、区块和对象坐标找线索。适合普通玩家、整合包作者和服务器服主。它只负责诊断，不会自动优化，也不会偷偷删东西。
能看到什么
- TPS / MSPT：实际 Tick 频率、平均耗时、最近一次和峰值耗时。
- 慢 Tick 次数：最近 100 刻里，有多少刻耗时达到 100 毫秒。
- 哪个维度比较忙：主世界、下界、末地及模组维度的平均/峰值 Tick 耗时。
- 实体统计：动物、怪物、掉落物、弹射物、自定义实体、下落沙和其他重力方块，按类型和 Mod 来源查看。
- 方块实体分析：箱子、熔炉和模组机器等已加载对象的数量与采样 Tick 耗时。
- 热点位置：维度、区块坐标，以及采样对象的 X / Y / Z、类型和单次调用峰值耗时。
- 方块工作采样：计划方块 Tick、随机方块 Tick、方块事件（包括活塞事件），为红石装置提供排查线索。
例如，某个已加载区块里集中出现大量下落的沙方块，面板会提示 “疑似刷沙 / 重力方块装置”，显示维度、区块和实体位置，方便服主过去核查。掉落物很多时，会提醒检查收集与存储系统。
不会看到几个沙方块就断言某人开了刷沙机。 自然落沙和其他装置也可能出现同样现象；数量本身不等于卡顿原因。它给出可核查的线索，不替代 Spark 等专业分析工具。
使用方法
- G：开启 / 关闭附近性能检查，可在按键设置中重新绑定。
- Ctrl + G：切换管理员服务器概览，再按同样组合关闭。
/performance tps：查看 Tick 指标，服务器控制台也能使用。- 使用文字 HUD、绿黄红颜色和小型区块线框；没有大型网页式 GUI。
自带中文和英文。支持 LOW_END 低配模式、NORMAL 普通模式、SERVER 服务器模式。低配模式减少表格行数、关闭区块线框并降低更新频率；模组默认不创建粒子。
安装要求
Minecraft 1.20.1 · Forge 47.4.10 或更新的 47.x · Java 17。
把 performance-analyzer-0.1.0.jar 放入 mods 文件夹。多人服务器和所有连接客户端都需要安装；单人游戏自动使用集成服务器。本页仅提供 Performance Analyzer，不会捆绑其他模组。
权限与配置
普通玩家只能看到自己所在维度的附近加载区块。管理员默认需要 OP 2 级，可看所有已加载维度的服务器概览。单人世界主人无需开启作弊即可查看概览。权限在服务端核验，客户端不能提交任意远程坐标来查询。
- 客户端配置：
config/performanceanalyzer-client.toml，可调整显示位置、显示内容、颜色、表格行数、模式和线框。 - 服务端配置：
<世界>/serverconfig/performanceanalyzer-server.toml，可调整检测间隔、附近范围、权限、警告阈值和采样上限，也可关闭实体、方块实体或区块检查。 - 整合包新世界默认配置可放在
defaultconfigs中。
默认每 100 tick 进行一轮统计，按区块分批处理；仅检查已加载区块，不为了检查而加载或生成区块。对象和方块工作只在少量 tick 中计时，默认约每 20 tick 采样一次。达到保护上限会明确标记“部分样本”。
使用边界
不自动删除实体、不修改游戏规则、不做 JVM 调优。采样结果是近似值，无法覆盖所有模组代码、区块生成、光照、网络和 JVM 停顿；短暂尖峰可能落在采样间隔里。坐标是观察到的对象位置，不保证就是装置控制器。证据不够时，会提示原因尚不明确。
MIT 许可证。非官方 Minecraft 模组，与 Mojang、微软无从属关系。