Loading Profiler

模组

· 作者 lcy0x1

配置文件游戏启动/加载/初始化时间

0 本站下载 0 关注 更新于 1 年前

最新 0.1.11 · 1.20.1 · Forge / NeoForge

一键开服(送7天)

Discord:

本模组提供游戏加载时间的详细分解以及每个模组的加载时间分析。

加载时间分析完全基于代码使用情况,因此资源加载(方块模型)、Mixin 以及 Fabric 模组(如果你使用 Sinytra)将被计算为原版加载时间的一部分。

请勿使用此模组加载已有世界。由于此模组的侵入性性质,它可能与某些模组在加载世界时不兼容。此模组仅应用于性能分析和剖析目的。

游戏加载是如何工作的?

游戏加载主要有三个阶段:

  • 模组加载器初始化
  • Minecraft 引导(原版设置 + 模组初始化)
  • 资源重载(资源加载 + 模组加载)
模组加载器初始化

在此阶段,Forge Mod Loader 将初始化必要的服务,例如访问转换器(accesstransformer)、核心模组(coremod)、Mixin 以及本模组。在此阶段,将对模组文件进行初步扫描,但没有服务的模组不会被加载。本模组将此阶段细分为 5 个阶段:

  • Services Initializing(服务初始化):这是第一个阶段,应该很快。
  • Services Loading(服务加载):某些模组服务可能会在此处执行工作,导致加载时间变长。
  • Mod Scanning(模组扫描):如果你没有其他服务类模组,这将是你要看到的第一个阶段。
  • Launch Plugin Working(启动插件工作):在此阶段,将扫描模组代码以收集基本信息。
  • Transformer Class Loader Working(转换器类加载器工作):在此阶段,访问转换器、核心模组和 Mixin 将开始加载。如果你有大量的 Mixin 或核心模组,这可能需要很长时间。
游戏引导

在此阶段,Minecraft 和模组代码开始加载。由于这些阶段中的任何一个都可能被 Mixin 显著改变,因此被拆分为 17 个阶段。拥有详细的分解有助于识别导致加载缓慢的原因。

  • Client Early Initialization(客户端早期初始化):在此阶段,没有加载任何游戏内容代码。此处的加载时间主要受 Mixin 影响。
  • Vanilla Bootstrap Start(原版引导开始):在此阶段,加载原版游戏内容(方块、物品)。大约需要 1 秒。如果你在这里看到更长的时间,可能是 Fabric 模组造成的。
  • Loading User / Options(加载用户/选项):在此阶段,Minecraft 加载用户配置和客户端选项。应该很快,这里加载了许多类,从而触发了更多的 Mixin。这主要是 Mixin 加载。
  • Minecraft Client Initialization(Minecraft 客户端初始化):在此阶段,Minecraft 初始化其客户端基础设施。与上一个阶段相同,原版情况下很快,但由于加载了许多类,它将触发更多的 Mixin 加载。
  • Loading Languages(加载语言):此处游戏加载 Minecraft 和 Forge 的语言文件。应该在 20ms 以内。
  • Constructing Mods(构建模组):实际模组初始化的开始。在此阶段,正在构建模组。后续将提供每个模组实际加载过程的详细分解。由于模组是并行加载的,模组加载的实际持续时间(实际时间)将短于每个模组的配置文件加载时间(线程时间)。
  • Creating Registries(创建注册表):在此阶段,具有自定义注册表的模组将初始化它们。
  • Gathering Object Holders(收集对象持有者):在此阶段,模组注册它们的对象持有者。这是注册过程的一部分。
  • Injecting Capabilities(注入能力):在此阶段,定义了 Capabilities(能力)的模组将对其进行初始化。
  • Loading Registries(加载注册表):在此阶段,模组将它们的遊戲对象注册到注册表中。这是模组初始化的最后一步。
  • Gather Modded Resource Packs(收集模组资源包):在此阶段,模组向游戏添加可选的资源包(默认启用或未启用)。某些模组可能会在此处执行工作。
  • Gather Tasks(收集任务):在此阶段,Minecraft 和模组向重载管理器注册它们的任务(重载监听器)。通常很快,但如果模组实际上是在这里加载而不是注册加载器,你可能会发现它很慢。(这是糟糕的代码编写)
  • Setup GUI(设置 GUI):设置原版 GUI 组件。应该很快。
  • Dispatch Client Events(分发客户端事件):在此阶段,大量模组化事件被分发给模组。
  • Vanilla Client Setup(原版客户端设置):杂项原版客户端设置,例如叙述者(narrator)。 Initializing Tasks(初始化任务):在此步骤中,Minecraft 开始初始化任务(重载监听器)。如果发现此步骤缓慢,这意味着某些模组在此处执行工作而不是在实际的任务过程中。(这是糟糕的代码编写)
  • Setup Loading Screen(设置加载屏幕):初始化加载屏幕上的 "MOJANG" 文本。游戏引导的最后一步。
资源重载

在此阶段,任务正在并行收集和执行。将会对每个任务花费的时间进行详细剖析。所有任务的总时间可能比重载过程的时间短,该比率就是你的线程利用率。如果你有 400% 的利用率,这意味着 4 个 CPU 不间断地并行运行以处理所有任务,这样你花费 30 秒就完成了如果由 1 个 CPU 运行则需要 120 秒才能完成的任务。

值得注意的是,此处最慢的任务应该是 ModelManager。ModelManager 负责加载游戏中的所有方块模型,此过程被细分为 10 个阶段。

  • 读取 JSON:模型加载器从原版、模组和资源包中读取 JSON 模型文件。
  • 解析 JSON:模型加载器将 JSON 文件解析为 UnbakedModel(未烘焙模型)。
  • 添加模组特殊模型:模组添加其自定义的特殊模型。
  • 解析层级关系:UnbakedModel 经过处理以分配父级模型。
  • 缝合纹理:将所有纹理合并为一张大纹理。此过程与读取 JSON 并行发生。如果你发现这个阶段耗时极短,意味着它比前四个阶段更早完成。
  • 烘焙模型:在此阶段,模型附加了纹理信息,形成 BakedModel(已烘焙模型)。
  • 模组修改模型:模组可以在这里修改 BakedModel。
  • 将模型分配给方块:在此阶段,模型被分配给方块状态。如果你拥有大量方块状态,这一步可能会变慢。
  • 等待屏障:等待其他任务完成。
  • 上传缝合纹理:将缝合后的纹理上传至 GPU。某些模组可能正在此时执行工作。

如何阅读分析报告?

一旦你使用此模组运行游戏,它将在 logs/profiler/loading-<time>.txt 生成一份分析报告。

报告包含两个部分:摘要(Summary)和详情(Detail)。摘要是详情的缩写版,因此我将仅解释详情部分。

游戏启动 (Game Bootstrap)

本节显示了第 1 阶段(模组加载器初始化)和第 2 阶段(Minecraft 引导)的持续时间。此处共有 22 个阶段。通常较慢的阶段包括:

Transformer Class Loader Working (mixin)(转换器类加载器工作,即 mixin) Constructing Mods (mod initial code)(构建模组,即模组初始代码) Loading Registries (mod registering game content objects to registry)(加载注册表,即模组向注册表注册游戏内容对象)

示例格式:

Game takes <xxx> seconds to bootstrap
 <Stage>: <xxx> ms
...
重载管理器 (Reload Manager - Tasks)

本节显示完成所有任务的总执行时间以及各个任务的单独执行时间。通用任务会优先显示,然后是特定于模组的任务。在详细视图中,每个任务将显示两个数字:主线程时间和总线程时间。主线程时间指在主线程中执行任务所花费的时间,用于那些无法并行的操作,例如修改游戏对象的数据。总线程时间指该任务占用 CPU 的总时间。如果该任务被拆分为多个片段并由多个 CPU 同时执行,则总线程时间可能长于总执行时间。

示例格式:

Reload Manager takes <xxx> seconds, loading <xxx> tasks
Tasks are processed in parallel using multiple threads.
- <Task>: <main thread time> / <total time>
...
Misc <xxx> Tasks: <xxx> ms / <xxx> ms
Model Analyzer: <xxx> ms / <xxx> ms
Main thread utilization: xx%
Off thread utilization: xx%
Idle time: <xxx> ms

Misc Tasks(杂项任务)指运行时间非常短的任务。列出所有这些任务会造成过多的冗余,因此我在此处仅显示所有这些任务的总和。

Model Analyzer(模型分析器)是本模组添加的一个用于分析模型来源的任务。如果发现该任务耗时过长,它将有助于显示哪个模组添加了大量需要加载的模型。此任务应占用 ModelManager 时间的不到 10%。

Main thread utilization(主线程利用率):主线程用于加载任务的比例。如果发现该值较高,这意味着有模组在主线程中执行缓慢的任务,这通常是不应该发生的。

Off thread utilization(非主线程利用率):有效用于执行所有任务的 CPU 数量。

Idle time(空闲时间):没有任何任务运行的时间。这可能是由于模组分配了错误的执行器来运行其任务,导致本模组无法识别谁在运行造成的。

模组加载时间 (Mod Loading Time)

本节显示每个模组初始化和加载所花费的时间。请注意,这里仅统计模组构建和模组事件的时间。Mixin 和 Fabric 模组不在此统计范围内。

加载时间超过 0.1 秒的模组将被列出,而加载时间超过 1 秒的模组还将列出详细信息。详细信息将包括构建时间(通常是最长的部分)和模组事件时间(模组通常会在每个事件中执行工作,以确保它们在正确的时间发生)。

示例格式:

Mods use <xxx> seconds to initialize
(Explanations)
Mods use <xxx> seconds to load
Mod init takes <xxx> seconds CPU time. Thread utilization: xx%
- <modid>: <xxx> ms
  | - <process>: <xxx> ms
- <modid>: <xxx> ms
Misc <xxx> mods: <xxx> ms
模型管理器 (Model Manager)

本节显示了 10 个模型管理器加载阶段的时间分解。

阶段“Adding modded special models”(添加模组特殊模型)和“Mods altering models”(模组修改模型)通常非常快,但如果模组大量添加或修改方块模型,则可能会变慢。

示例格式:

Model Load Time per Stage:
- <Stage>: <xxx> ms
Found <xxx> packs
Loaded <xxx> model files with total size of <xxx> KB
Baked <xxx> models
- <mod jar or resource pack zip>: <xxx> KB
Misc <xxx> packs: <xxx> KB
  • Packs(资源包):指模组、资源包以及模组提供的可选资源包。
  • Model file(模型文件):位于 assets/<modid>/models/ 文件夹下的模型 JSON 文件。
  • Baked models(已烘焙模型):已完成烘焙的模型。如果使用相同模型文件但不同纹理的多个模型,则已烘焙模型的数量可能多于模型文件数量。但由于大多数模型的纹理是在模型文件中指定的,因此数量不应相差太大(除非模型是通过代码添加的)。
  • Misc packs(杂项资源包):体积过小而不便单独列出的资源包。本模组将它们的大小进行了汇总。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源