截图
介绍

找出游戏卡顿的原因。
扫描服务器几秒钟,就能在游戏世界中查看每个村民、漏斗、熔炉和农场每刻造成的开销:从表示开销较低的淡黄色,到表示开销最高的深洋红色。帧率也能进行同样的扫描,还能查看是什么让每个区块保持加载,以及是谁触发了加载。Culprit 会指出该怪谁、它的位置,以及它来自哪个模组。
NeoForge 适用于 Minecraft 26.3、26.1.2 和 1.21.1 · Forge 适用于 1.20.1 · 单人游戏和服务器 · 支持光影包和 Distant Horizons · 不添加物品或方块
游戏世界中万物的开销

按下 F8,扫描服务器 10、30 或 60 秒。扫描结束后,所有在扫描期间执行过 tick 的生物和方块实体都会在原地被框出,并根据开销着色,色阶也方便色盲玩家辨认。附近开销最高的对象会带有标签,每个区块的总开销则显示在区块边框上。不会对游戏世界做任何改动:Culprit 只负责测量。
指出卡顿元凶

注视任意对象,Culprit 就会在准星下方显示它的信息:对象类型、每刻开销、占用 tick 的比例、最慢的一刻,以及它来自哪个模组。
每一毫秒都有据可查

按下 F9 查看结果。Tick选项卡会将整个服务器 tick 拆分展示(生物、方块实体、区块加载与维护、随机刻、生物生成、方块刻、玩家连接、自动保存、Culprit 自身的计时,以及未测量的部分),各项相加即为整个 tick 的耗时。对象、类型、模组和区块选项卡会列出其余信息。你可以搜索任意列表,点击条目即可用光束在世界中标记它;如果你是管理员,还能传送到它那里。
帧率也能测

帧扫描也会分析每帧的开销:每种生物、箱子、告示牌和粒子效果的绘制成本,以及帧的各个环节——从构建区块网格到等待帧率上限。使用光影包时,阴影开销会单独统计;Distant Horizons 的远景地形也会单独统计。任何服务器都能运行帧扫描,即使服务器没有安装 Culprit。
是什么让世界保持加载

区块检查器会显示所有已加载区块及其加载原因:玩家、/forceload(以及执行命令的玩家)、传送门、末影珍珠、出生点,以及其他模组的区块加载器;并标出背后的方块、玩家或队伍。你可以在周围地图上查看这些区块,按加载原因分类浏览,也能在游戏世界中看到它们的轮廓。
卡顿尖峰与顿挫
平均值会掩盖造成顿挫的那些 tick。每次扫描还会记录最慢的 tick:启用仅看卡顿尖峰,即可只查看这些 tick(耗时超过通常值两倍且至少达到 5 毫秒)对应的列表、图表和游戏世界,以及这些 tick 中运行的内容。帧扫描也有仅看顿挫选项。
一切尽在其中
- Tick 扫描:每个方块实体和实体的 tick、计划中的方块刻和流体刻、方块事件、按方块类型统计的随机刻、每个区块的维护和生物生成,以及分项展示的 tick 其他耗时。
- 帧扫描:每个绘制的实体和方块实体、按类型统计的粒子、帧的每个组成部分,以及单独统计的光影阴影和 Distant Horizons 远景地形。
- 区块检查器:所有维度中每个已加载区块、加载原因、区块繁忙程度和区块内容;既能在地图上查看,也能按加载来源分类并在地图上查看。
- 地图显示:按开销着色的方框、附近开销最高对象的标签、每个区块的总开销、准星下方对象的开销说明,以及为选中对象标出的光束。
- 结果界面(F9):服务器 tick 和帧扫描的 Tick、对象、类型、模组和区块标签页,搜索框、点击标记对象的功能,以及管理员专用的传送功能。
- 卡顿 tick 和卡顿帧与平均值一并显示,数据来自同一次扫描。
- 报告: 保存报告会将结果保存为可分享的网页(Markdown)和 JSON 文件,放在游戏文件夹的
culprit/reports;服务器上使用/culprit export也会生成相同报告。 - HUD 信息行默认关闭,可自行开启:显示服务器每秒 tick 数和每个 tick 的耗时(可在服务器上扫描时使用),以及每秒帧数;可选择显示在屏幕哪个角落。
- 命令可在控制台和聊天栏使用:
/culprit scan、stop、top、chunks和export。 - 对游戏影响很小:没有运行扫描时,Culprit 只会在它监测的游戏调用中检查一次开关。
更多图片见图片标签页。
快速上手
- 在游戏中安装 NeoForge(Minecraft 1.20.1 使用 Forge)和 Culprit。要扫描服务器的 tick 和区块,也请在服务器上安装 Culprit。
- 按 F8,选择扫描服务器或帧的时长,然后继续游戏。
- 聊天栏提示扫描完成后,按 F9查看结果,再点击在地图上显示。
- 看向任意对象即可查看它的开销;也可以点击结果中的一行,在地图上标记对应对象。
两个按键都可以在控制中更改。
服务器使用说明
- 默认情况下,管理员可以扫描。服务器设置中可以指定哪些人(按权限等级)可以扫描,以及扫描最长可运行多久(默认 2 分钟)。
- 结果会发送给发起扫描的人。
/culprit scan [seconds]、/culprit stop、/culprit top [things|types|mods|chunks] [count]、/culprit chunks和/culprit export既能在聊天栏中使用,也能在服务器控制台中使用。- 扫描未运行时,测量不会产生开销;扫描运行时,Culprit 会统计自身测量耗时,并在 tick 耗时中单独显示。
兼容性
- 光影包:Minecraft 26.3、26.1.2 和 1.21.1 使用 Iris 搭配 Sodium;1.20.1 使用 Oculus 搭配 Embeddium。结果会直接绘制在光影效果上方,不会修改光影包;帧扫描也会单独统计光影阴影(所有版本均测试过 Complementary Reimagined;26.3 还测试过 Complementary Unbound、BSL、Bliss、Photon、Solas 和 MakeUp Ultra Fast)。
- Sodium 和 Embeddium:使用它们时,方块实体和区块网格的测量方式与不使用时相同。
- Distant Horizons所有版本均支持:远景地形会作为单独的帧组成部分统计。
- 任何模组的方块和生物都会像游戏原版内容一样测量,并标明所属模组;其他模组的区块加载器也会标明背后的方块、玩家或队伍。
常见问题
- Forge 还是 Fabric?Minecraft 26.3、26.1.2 和 1.21.1 使用 NeoForge;1.20.1 使用 Forge。不支持 Fabric。
- 需要哪个 Java 版本?使用启动器为你的 Minecraft 版本选择的版本:1.20.1 用 17,1.21.1 用 21,26.x 用 25。
- 服务器需要安装吗?Tick 扫描和区块检查器需要安装(单人游戏中服务器始终已安装)。帧扫描可在任何服务器上使用。
- 每个玩家都需要安装吗?不需要。未安装的玩家也能加入安装了它的服务器,并在有扫描权限时使用命令。
- 会拖慢游戏吗?不扫描时不会。扫描期间,它会统计自身测量所花的时间并显示给你。
- 它和 spark 类似吗?spark 用来找出运行缓慢的代码;Culprit 用来找出地图中导致卡顿的对象及其位置。两者搭配使用效果很好。
- 会改变地图吗?不会,只会进行测量。
- 可以放进整合包吗?可以,完全自由。
- 支持基岩版或携带版吗?不支持,只支持 Java 版。
设置
个人设置:对象方框的范围(16 至 128 格)、显示标签的对象数量(0 至 30)、结果自动隐藏的等待时间(分钟,或设为永不隐藏),以及 HUD 信息行及其显示角落。服务器设置:允许哪些人扫描,以及最长扫描时长。
如何更改设置
游戏内:按 F9,再点击右上角的设置;或者打开模组,选择Culprit,再选择配置。
- Minecraft 26.3、26.1.2 和 1.21.1:在模组列表中打开配置,在自己的地图中也可以查看服务器设置。
- Minecraft 1.20.1:服务器设置保存在对应文件中(见下文)。
在文件中更改:用任意文本编辑器打开文件;每项设置上方都有说明。
- 所有版本:你的个人设置位于
config/culprit-client.toml。 - Minecraft 26.3:服务器设置位于 Minecraft 文件夹中的
config/culprit-synced.toml(服务器上则位于服务器文件夹中)。 - Minecraft 26.1.2 和 1.21.1:位置相同,为
config/culprit-server.toml。 - Minecraft 1.20.1:每个地图都有单独的设置文件,位于世界文件夹中的
serverconfig/culprit-server.toml(单人游戏中在saves中;服务器上则在其world文件夹中)。
运行要求
Culprit 针对不同 Minecraft 版本提供四个文件;请选择与你的版本对应的文件:
- Minecraft 26.3:NeoForge 26.3.0.103 或更新版本
- Minecraft 26.1.2:NeoForge 26.1.2.126 或更新版本
- Minecraft 1.21.1:NeoForge 21.1.266 或更新版本
- Minecraft 1.20.1:Forge 47.4 或更新版本
无需其他前置。
整合包
你可以自由地将 Culprit 加入任何整合包。生成的报告便于分享给整合包作者。
计划中的功能
- 正在考虑:统计各模组事件处理器的耗时;保存扫描结果,以便对比改动前后;服务器卡顿时自动开始扫描。
链接
- 源代码:GitHub
- 发现 Bug?请在Issues标签页提交反馈。
鸣谢
- Culprit 基于MIT 许可证发布。
常见问题
Culprit 支持哪些 Minecraft 版本?
Culprit 支持 Minecraft Java 版 1.20.1–26.3,共 4 个版本,可用的加载器:Forge / NeoForge。下载时注意选择和你游戏版本一致的文件。
Culprit 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Forge / NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
评论
登录后评论和评分