Just Enough Threads [JEI Startup Optimize]

模组

· 作者 tonywww4

通过将 JEI 最繁重的任务移至主线程之外并跨 CPU 核心执行,从而加速其启动过程。

0 本站下载 0 关注 更新于 6 天前

最新 Just Enough Threads 0.14.9 - MC 26.1.2 (neoforge) · 26.1.2 · NeoForge

一键开服(送7天)

Just Enough Threads

更快地进入你的世界。 Just Enough Threads 将 JEI 最繁重的启动工作从主线程移出,并分散到 CPU 核心上处理,从而让大型整合包在 JEI 构建搜索索引时不再于加载界面卡死。

功能说明

响应式 JEI 启动

JEI 的启动过程在 JEI 原始顺序下运行于一个专用的后台线程,因此游戏在构建配方和运行时仍能保持渲染。插件回调不会并发执行。需要主线程的插件、最终的 onRuntimeAvailable 回调以及运行时发布都会返回客户端线程。离开世界、连接超时或服务器关闭会取消构建,从而确保过期的运行时永远不会发布到下一个世界中。

预算控制的原料搜索索引

JEI 通常会在加载界面等待期间在主线程上构建其原料过滤器——即对所有物品和流体的搜索索引。在大型整合包中,这可能需要几秒钟。Just Enough Threads 会在你进入世界后的客户端刻(ticks)中以小步骤填充该索引,在物品栏中显示进度,并在索引完成后刷新一次侧边栏。

你将看到:JEI 物品列表会在你出生片刻后出现,而不会阻碍世界加载。

实验性配方原料预解析

在 JEI 检查其内置配方(合成、熔炼、石砧切割等)之前,每个原料标签都必须被解析为具体的物品列表。Minecraft 采用惰性方式处理,而 JEI 会在启动期间触发所有解析操作。Just Enough Threads 会提前跨 CPU 核心完成解析,然后将控制权交还给 JEI。JEI 自身的验证和注册流程仍像往常一样在主线程上运行,只是针对的数据已经是已解析状态。

此选项默认关闭,因为自定义配方和惰性原料缓存在从工作线程访问时并不总是安全的。它仅保留用于特定整合包的受控测试。

精简生成的铁砧与砂轮配方

在非常大的整合包中,生成所有物品与附魔组合的铁砧配方可能需要几分钟。Just Enough Threads 会保留一个精简的代表性集合:每种适用的附魔最多在三个物品系列上可见,并提供最多 16 个修复示例;对于生成砂轮配方的 JEI 版本,砂轮示例也会以相同方式进行修剪。设置 disableAnvilRepairRecipes = true 或 disableAnvilEnchantRecipes = true 可隐藏整类生成的铁砧配方。

性能

来自 0.2.0 版本(2026 年 7 月)的早期测量数据,在一个大型整合包(约 21,000 种物品和流体,34,000 个原版类型配方)中,在同一台机器上进入同一世界,对比优化关闭与开启的情况:

JEI 启动 关闭 开启
运行时构建 5.18 s 0.55 s
启动 JEI(总计) 10.7 s 6.4 s

后续版本将 JEI 的启动移至专用线程,并将索引构建分散到客户端 tick 中,因此当前数据有所不同。具体数值因硬件和整合包大小而异。

配置

配置文件:config/justenoughthreads-client.toml。每项优化均可独立切换。当新文件不存在时,会自动复制旧的 jei_optimize-client.toml。

  • enabled — 整个模组的总开关。
  • asyncStartup — 在专用的后台线程上串行构建 JEI,然后在客户端线程上运行已配置的插件、运行时回调和发布操作;世界退出、超时和服务端关闭会立即取消过时的任务。
  • mainThreadPlugins — 必须使用客户端线程的 JEI 插件 ID。默认值涵盖 Alex's Caves、Experience Obelisk、Collector's Reap、Theurgy 和 Productive Trees。为单个插件添加 modid:path,或为一个模组的所有插件添加 modid。

JEI 自身的创造模式标签枚举和 GUI 运行时构建始终保留在客户端线程上; 它们不需要在此列表中列出。

  • asyncIngredientFilter — 在客户端 tick 中以小步骤填充物品搜索索引,然后一次性发布侧栏。
  • parallelVanillaRecipes — 实验性的配方原料预解析;默认禁用。
  • optimizeAnvilRepresentatives — 保留紧凑的代表性铁砧示例;默认启用。
  • disableAnvilRepairRecipes / disableAnvilEnchantRecipes — 隐藏该类生成的所有铁砧配方;默认禁用。

如果你在世界进入时遇到问题,请关闭各个选项,或设置 enabled = false 以完全恢复原版 JEI 的行为。

要求

Minecraft 加载器 JEI(已检查版本)
1.20.1 Forge 47.4.4+ 15.20 - 15.74
1.21.1 NeoForge 21.1.x 19.27 - 19.70
26.1.2 NeoForge 26.1.2.109+ 29.43 - 29.53

仅限客户端。 26.1.2 版本需要 Java 25。

Just Enough Threads

更快进入世界。 Just Enough Threads 将 JEI 启动时最繁重的工作移出主线程并分散到多个 CPU 核心上,使大型整合包在加载界面上不再因为 JEI 构建搜索索引而卡住。

功能

分批构建物品搜索索引

JEI 默认在主线程上构建物品筛选器——即覆盖所有物品与流体的搜索索引——而你只能在加载界面干等。在大型整合包中,这一步可能需要好几秒。Just Enough Threads 会在你进入世界之后,利用每个客户端 tick 的一小段时间分批填充索引,在物品栏中显示进度,全部完成后一次性刷新侧栏。

你会看到: JEI 物品列表在你进入世界后稍等片刻才出现,而不是拖慢世界加载。

保持界面响应的串行 JEI 启动

asyncStartup 会在一条专用后台线程上按 JEI 原顺序构建配方与 runtime。插件回调不会并发执行;mainThreadPlugins 中的插件、最终的 onRuntimeAvailable 回调和 runtime 发布会返回客户端线程,以兼容 JEI 仅允许在主线程调用的 API。退出世界、连接超时或服务器关闭时,当前 generation 会立即失效,启动线程和派生任务会被取消,旧 runtime 不会发布到下一个世界。

实验性并行预解析配方材料

JEI 在检查内置配方(合成、熔炼、切石等)之前,需要先把每一条材料标签解析成具体的物品列表。Minecraft 采用惰性解析,而 JEI 启动时会把这些解析全部触发一遍。Just Enough Threads 提前用多个 CPU 核心完成这项解析,再交回 JEI。JEI 自身的校验与注册照常在主线程上运行,只是读到的数据已经解析完毕。

此选项默认关闭,因为自定义配方与惰性材料缓存不一定能安全地从工作线程访问。它仍可用于针对特定整合包的受控测试。

精简自动生成的铁砧与砂轮配方

在超大型整合包中,枚举所有物品与附魔的铁砧组合可能耗时数分钟。Just Enough Threads 改为保留一组有代表性的示例:每种可用附魔仍会出现在最多三类物品上,另保留最多 16 个修复示例;生成砂轮配方的 JEI 版本也按同样方式精简。将 disableAnvilRepairRecipes = true 或 disableAnvilEnchantRecipes = true 可以隐藏整类自动生成的铁砧配方。

性能

以下是 0.2.0 版本(2026 年 7 月)的早期测量,在一个大型整合包(约 21,000 个物品/流体、34,000 条原版类配方)中,于同一台机器进入同一世界,关闭 vs 开启优化:

JEI 启动阶段 关闭 开启
Building runtime 5.18 s 0.55 s
Starting JEI(总计) 10.7 s 6.4 s

之后的版本把 JEI 启动移到专用线程、把索引构建改为按客户端 tick 分批进行,当前数字会有所不同。具体数字随硬件与整合包规模而变化。

配置

配置文件:config/justenoughthreads-client.toml。每一项优化都可以单独开关。若新文件不存在,会自动从旧的 jei_optimize-client.toml 复制配置,且不会删除旧文件。

  • enabled — 整个 mod 的总开关。
  • asyncStartup — 在专用后台线程上串行启动 JEI;退出世界、连接超时或服务器关闭时立即取消,默认开启。
  • mainThreadPlugins — 必须在客户端主线程执行的 JEI 插件 ID 列表。默认包含 Alex's Caves、Experience Obelisk、Collector's Reap、Theurgy 和 Productive Trees。填写 modid:path 可匹配单个插件,只填写 modid 可匹配该模组的全部插件。

JEI 自身的创造栏枚举和 GUI runtime 构建始终保留在客户端主线程,无需加入该列表。

  • asyncIngredientFilter — 进入世界后按客户端 tick 分批填充物品搜索索引,完成后一次性发布侧栏。
  • parallelVanillaRecipes — 实验性并行预解析配方材料;默认关闭。
  • optimizeAnvilRepresentatives — 保留精简的代表性铁砧示例;默认开启。
  • disableAnvilRepairRecipes / disableAnvilEnchantRecipes — 隐藏该类全部自动生成的铁砧配方;默认关闭。

如果进入世界时遇到任何问题,可以逐项关闭这些选项,或将 enabled = false 以完全恢复 JEI 的原生行为。

需求

Minecraft Loader JEI(已检查的版本)
1.20.1 Forge 47.4.4+ 15.20 - 15.74
1.21.1 NeoForge 21.1.x 19.27 - 19.70
26.1.2 NeoForge 26.1.2.109+ 29.43 - 29.53

仅客户端需要安装。 26.1.2 版本需要 Java 25。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源