启动流程

启动流程

通过多线程模型烘焙、并行纹理多级渐远纹理映射和智能启动缓存,加速1.12.2的启动时间。

性能

⚡ Startup Flow

Minecraft 1.12.2 高性能启动优化器

CleanroomMC • Minecraft Forge • 客户端 • 专用服务器

Minecraft 1.12.2 Cleanroom and Forge Client and Server GPL 3.0


🌟 什么是 Startup Flow?

厌倦了每次启动大型 Minecraft 1.12.2 整合包(如 RLCraft、MeatballCraft 或 GreedyCraft)都要等待数分钟吗?

Startup Flow 是一款双重用途的优化模组,专为消除 CleanroomMC 和标准 Minecraft Forge 1.12.2 上的启动卡顿而设计。它解决了两个最严重的启动瓶颈:

  1. 缓存 FermiumBooter 的启动扫描:通过将结果缓存到磁盘,绕过每次启动时对数百个模组 JAR 文件进行的重复且磁盘密集的 ClassGraph 扫描。
  2. 多线程模型烘焙:将方块和物品模型的编译并行化到多个工作线程,而不是强制所有内容通过单个 CPU 核心。

⚡ 主要优势与特性

  • Jar 扫描即时重放: 在热启动时,Startup Flow 仅需 约 24 毫秒 即可将缓存的模组 ID 和 @MixinConfig 开关预加载到 FermiumBooter 中,完全跳过耗时的磁盘扫描。
  • 多核模型烘焙: 自动检测您的 CPU 核心数并并发烘焙方块/物品模型,在拥有数万个模型变体的整合包上显著加快客户端加载速度。
  • 智能失效指纹: 自动检测 mods/ 目录(包括 mods/1.12.2/ 等嵌套文件夹)以及 config/fermiumbooter.cfg 内容的变更。缓存仅在您的模组配置实际发生变化时才会更新。
  • 通用兼容性: 在 Cleanroom 和标准 Forge 实例上均可原生运行。
  • 客户端与服务器友好: 缓存同时惠及客户端启动和专用服务器。模型烘焙优化在无头服务器上会安全地保持待命。
  • 安全且非侵入性: 使用反射,对 FermiumBooter 零编译时依赖。如果 FermiumBooter 不存在,Startup Flow 会优雅地让路,不会记录可怕的错误。
  • 内置 OptiFine 与 VintageFix 保护: 自动检测 OptiFine 并禁用冲突的纹理 Mixin,以保留自定义光影和纹理。与 VintageFix 的动态资源完全兼容。

📊 真实基准测试结果

在拥有 234 个模组 和 564 个 @MixinConfig 开关 的真实整合包上测量(Cleanroom 0.6.13-alpha,相同硬件):

启动状态 缓存状态 日志跨度(开始 → 完成) 实际耗时(±0.5秒) 开关扫描处理
基线(无 StartupFlow) 无 56.0 秒 60.4 秒 全盘 ClassGraph JAR 扫描
StartupFlow(冷启动) 未命中 → 写入 55.0 秒 59.0 秒 扫描一次并缓存到磁盘
StartupFlow(热启动 1) 缓存命中 53.0 秒 57.6 秒 564 个开关在 24 毫秒内应用
StartupFlow(热启动 2) 缓存命中 53.0 秒 57.0 秒 564 个开关在 24 毫秒内应用

正确性保证: 冷启动与热启动之间验证了 0 个 Mixin 错误、0 次崩溃,且开关评估结果完全一致。


🧩 兼容性矩阵

  • CleanroomMC: 完全支持并推荐。
  • Minecraft Forge 1.12.2: 在 Forge 14.23.5.2847 或更高版本上完全支持。
  • FermiumBooter: 自动支持。安装 FermiumBooter 后,扫描缓存会激活。
  • OptiFine: 完全兼容。Startup Flow 在运行时检测 OptiFine,并动态禁用其纹理图集 Mixin,使 OptiFine 的光影和纹理管线保持 100% 不受影响。
  • VintageFix: 完全兼容。如果 VintageFix 启用了 dynamic_resources(按需加载模型),Startup Flow 的模型烘焙器会安全地闲置,而 FermiumBooter 扫描缓存会继续加速启动。
  • Surge / CensoredASM: 完全兼容,无冲突转换。

📋 要求与安装

要求:

  • Minecraft 1.12.2
  • Minecraft Forge(14.23.5.2847+)或 Cleanroom(0.6.x+)
  • MixinBooter(10.0 或更新版本)
  • 可选: FermiumBooter(仅在需要扫描缓存时必需)
  • Java 8 至 Java 25

安装:

  1. 确保 MixinBooter 已放入您的 mods 文件夹。
  2. 下载 startupflow-1.0.1.jar 并将其放入您的 mods 文件夹。
  3. 启动游戏。首次启动会记录缓存;此后每次启动都将自动受益于热启动!

⚙️ 配置与命令

配置文件:config/startupflow.cfg

"Model Baking" {
    # Bake block and item models across multiple worker threads instead of a single thread.
    B:"Enable Parallel Model Baking"=true

# Number of threads for model baking (0 = auto-detect CPU cores).
I:"Model Baking Threads"=0

# Compute texture atlas mipmap levels concurrently across multiple threads.
B:"Enable Parallel Mipmaps"=true

# Number of threads for mipmap generation (0 = auto-detect CPU cores).
I:"Mipmap Threads"=0
}

缓存管理:

  • 通过 JVM 标志禁用缓存: 在启动器参数中添加 -Dfermiumscancache.disable=true。
  • 通过文件标记禁用缓存: 在 config/fermiumscancache.disabled 放置一个空文件。
  • 强制重新扫描: 删除 config/fermiumscancache.json。

游戏内命令:

  • /startupflow status — 查看当前模型烘焙线程和状态。
  • /startupflow toggle — 切换并行模型烘焙的开启或关闭。

📜 许可证

Startup Flow 是根据 GNU General Public License v3.0 (GPL-3.0) 许可的开源软件。源代码可在 GitHub 上获取。