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。
Just Enough Threads
Get into your world faster. Just Enough Threads moves JEI's heaviest startup work off the main thread and spreads it across your CPU cores, so large modpacks stop freezing on the loading screen while JEI builds its search index.
What it does
Responsive JEI startup
JEI startup runs on one dedicated background thread in JEI's original order, so the game keeps rendering while recipes and the runtime are built. Plugin callbacks never run concurrently. Plugins that need the main thread, the final onRuntimeAvailable callbacks and the runtime publication return to the client thread. Leaving the world, a connection timeout or a server shutdown cancels the build, so a stale runtime is never published into the next world.
Budgeted ingredient search index
JEI normally builds its ingredient filter — the search index over every item and fluid — on the main thread while you wait on the loading screen. In a big pack that can take several seconds. Just Enough Threads fills it in small steps on client ticks after you enter the world, shows the progress in the inventory, and refreshes the sidebar once when the index is complete.
What you will see: the JEI item list appears a moment after you spawn, instead of holding up world load.
Experimental recipe ingredient pre-resolution
Before JEI can inspect its built-in recipes (crafting, smelting, stonecutting, and more), every ingredient tag has to be resolved into a concrete list of items. Minecraft does that lazily and JEI triggers all of it during startup. Just Enough Threads does the resolution across CPU cores up front, then hands back to JEI. JEI's own validation and registration still run exactly as they normally do, on the main thread, just against data that is already resolved.
This option is off by default because custom recipes and lazy ingredient caches are not always safe to access from worker threads. It remains available for controlled testing on a specific pack.
Compact generated anvil and grindstone recipes
Generating every item and enchantment combination for the anvil can take minutes in very large packs. Just Enough Threads keeps a compact representative set instead: every applicable enchantment stays visible on up to three item families, with up to 16 repair examples; grindstone examples are trimmed the same way on JEI versions that generate them. Set disableAnvilRepairRecipes = true or disableAnvilEnchantRecipes = true to hide a whole class of generated anvil recipes.
Performance
An early measurement from version 0.2.0 (July 2026), in a large modpack (roughly 21,000 items and fluids and 34,000 vanilla-type recipes), entering the same world on the same machine with the optimizations off vs on:
| JEI startup | Off | On |
|---|---|---|
| Building runtime | 5.18 s | 0.55 s |
| Starting JEI (total) | 10.7 s | 6.4 s |
Later versions moved JEI startup to a dedicated thread and the index build to client ticks, so current numbers differ. Numbers vary with hardware and pack size.
Configuration
Config file: config/justenoughthreads-client.toml. Every optimization can be toggled independently. The legacy jei_optimize-client.toml is copied automatically when the new file is absent.
enabled— master switch for the whole mod.asyncStartup— build JEI serially on a dedicated background thread, then run configured plugins, runtime callbacks, and publication on the client thread; world exit, timeout, and server shutdown cancel stale work immediately.mainThreadPlugins— JEI plugin IDs that must use the client thread. The defaults cover Alex's Caves, Experience Obelisk, Collector's Reap, Theurgy, and Productive Trees. Addmodid:pathfor one plugin ormodidfor all plugins from a mod.
JEI's own creative-tab enumeration and GUI runtime construction always stay on the client thread; they do not need entries in this list.
asyncIngredientFilter— fill the ingredient search index in small steps on client ticks, then publish the sidebar once.parallelVanillaRecipes— experimental recipe ingredient pre-resolution; disabled by default.optimizeAnvilRepresentatives— keep the compact representative anvil examples; enabled by default.disableAnvilRepairRecipes/disableAnvilEnchantRecipes— hide all generated anvil recipes of that class; disabled by default.
If you ever run into a problem on world entry, turn off the individual options, or set enabled = false to fully restore stock JEI behavior.
Requirements
| Minecraft | Loader | JEI (checked releases) |
|---|---|---|
| 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 |
Client-side only. The 26.1.2 build needs 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。
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Just Enough Threads [JEI Startup Optimize]
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新日志
Just Enough Threads 的所有重要变更均记录在此文件中。
本项目遵循 语义化版本控制。
0.14.9
已修复
- 在 NeoForge 1.21.1 上,压缩化的铁砧和砂轮配方再次生效。JEI 19.27.0.350 及更高版本更改了铁砧附魔检查逻辑,而 JEI 19.36 及更高版本更改了砂轮生成器逻辑,导致这两项优化功能自动关闭,进而使 JEI 生成了所有可能的组合。现在,JEI 1.21.1 的早期和晚期构建版本中的形状均能被正确识别。
- 生成的按食物划分的流体配方在 NeoForge 1.21.1 上再次被压缩。受支持的技术模组在其 1.21.1 版本中移动了 JEI 集成模块,因此为该模组 1.20.1 版本编写的压缩逻辑并未在该版本中生效。具有相同流体输出和剩余容器的食物现在共享同一个配方页面。
- 兼容性检查不再对不适用的优化功能发出警告。针对 JEI 1.20.1 辅助函数的配方扩展修复、针对不再重复子类型的模组发布的重复子类型防护,以及 NeoForge 上的 1.20.1 流体配方压缩功能,现在仅以调试级别记录日志。
- 当其他模组在 JEI 仍在加载时(例如玩家重新加入世界后立即从容器界面)刷新书签列表时,JEI 不再因 “Jei Runtime has not been created yet” 错误而崩溃。JEI 在布局书签列表时会创建配方书签的分类图标,这需要已发布的运行时环境。在运行时发布之前,配方书签会使用同尺寸的占位符;JEI 自身的图标将在随后的首次绘制时创建。
0.14.8
已更改
- 高频分析器和客户端任务守卫通过易变线程引用标识 JEI 启动线程,从而避免线程本地查找。该引用保持活动状态直到启动任务退出(包括取消清理),并在执行器退役前释放。
已修复
- 当其他模组将客户端字体的文本测量替换为仅限渲染线程的布局引擎时,JEI 不再无法启动。分类注册在构建分类屏幕时测量文本,因此只要客户端字体不使用原版文本测量,该操作现在就在客户端线程上运行。使用原版文本测量的资源包仍将其保留在启动线程上。
0.14.7
新增
- 为直接使用 Lucene 存储创建元素搜索的 JEI 构建版本提供预算制成分索引(适用于 JEI 15.73+、19.68+ 和 29.51+)。过滤器初始化为空搜索,成分在客户端刻钟期间添加,每个搜索存储会在侧边栏发布前的各自刻钟中写入其排队索引。隐藏状态规则现在源自 JEI,因此隐藏的成分类型将保持隐藏状态。构建失败时,会发布 JEI 对整个成分列表的同步搜索。较旧的 JEI 构建版本保留其现有的索引变体。
- 为 Minecraft 1.20.1 和 1.21.1 上所有剩余的 JEI 过滤器形状提供预算制成分索引:包括 JEI 15.24-15.72 和 19.42-19.67(其过滤器构造函数通过一次工厂调用构建整个搜索),以及 JEI 19.37-19.39(仍逐个添加成分)。此前只有 26.1.2 使用了工厂变体,这些构建版本在一个阻塞步骤中构建其完整搜索。JEI 的低内存搜索设置使其在所有这些版本上保持同步构建。
- 批量搜索构建器保持打开状态,直到预算制构建在 JEI 构建版本中将所有成分添加完毕(适用于在单独辅助函数中构建存储的版本:15.66-15.72、19.60-19.67、29.46-29.50),这与它们在搜索构造函数中构建它们时的行为一致。
已修复
- Minecraft 26.1.2 上的预算制构建应用了 JEI 自身的隐藏状态规则,因此在 JEI 设置中隐藏的成分类型在侧边栏发布后不再重新出现。
- 燃料配方压缩在方法入口时捕获其成分管理器。经过优化的 JEI 15.74 构建版本在返回前重用该参数槽,这之前会导致压缩功能因
IncompatibleClassChangeError而禁用。 - 另一个移除运行时成分的配方回调现在也在客户端线程上运行,使用与现有规则相同的内置路由。现有配置无需更改。
兼容性
- 回归检查现在拒绝任何在方法入口后读取目标参数的 JEI 目标处理程序,除非该处理程序拥有经过审查的字节码检查。已发布的 JEI 归档文件在铁砧、砂轮和配方扩展处理程序(这些处理程序仍读取目标参数)之前,会检查是否存在参数槽重用情况。
- 兼容性测试运行程序现在也会在链接错误、验证错误和 JET 回退错误时停止。
验证
- 所有三个目标总共成功构建并通过 41 次回归套件执行。
- 30 个已发布的 JEI 归档文件(15.20-15.74、19.27-19.70 和 29.43-29.53)通过了过滤器、构建器、存储和参数槽检查,并且每个归档文件恰好启用一种过滤器变体:15.20-15.21 和 19.27-19.36 使用十参数版本,19.37-19.39 使用增量版本,15.24-15.71、19.42-19.64 和 29.43-29.47 使用工厂版本,15.74、19.69-19.70 和 29.53 使用直接版本。
- 搭载 JEI 15.59.0.212 和 15.71.0.224(Forge 1.20.1)、19.38.0.367、19.54.0.429 和 19.64.0.455(NeoForge 1.21.1)以及 29.43.0.107 和 29.47.0.111(26.1.2)的开发客户端,能够从预算制构建中无错误地发布侧边栏。工厂构建版本保持三个批量构建器处于打开状态,并在总计 3-26 毫秒内将其密封;两个 26.1.2 客户端均绘制了侧边栏并完成了 120 次搜索。
- 在搭载 JEI 15.59.0.212 且具有 2,641 个成分的暖机 Forge 1.20.1 客户端上,使用预算制构建时,JEI 的阻塞过滤步骤耗时分别为 153 和 215 毫秒,而不使用该构建时则分别为 231 和 336 毫秒
交替运行。剩余的索引工作耗时约 600 ms,在客户端刻中完成;最长的一刻为 36-41 ms,而未启用此优化时为 37-46 ms。
- 使用 JEI 15.74.0.232 的 Forge 1.20.1 开发客户端发布了无需回退机制的侧边栏。JEI 的线程内过滤步骤从同一世界上次运行的 583 ms 降至 140 ms;七次存储刷写总共耗时 282 ms,每刻最多 258 ms。燃料压缩将 336 页减少至 19 页。
- 使用 JEI 19.70.0.468 的 NeoForge 1.21.1 开发客户端也无需回退机制即可发布(七次刷写,总计 219 ms),并将 248 页燃料压缩至 13 页。
- JIE 15.74 自身的 Lucene 和共享键存储通过公共搜索方法刷写了排队条目,并随后返回了正确结果。刷写令牌未匹配到任何内容。
0.14.6
已修复
- 精确匹配催化剂注册方法的描述符,以便 JEI 15.74 的其他重载不会在启动期间导致
InvalidInjectionException。 - 避免在方法返回时读取优化后的 JEI 字节码中被复用的参数槽。配方计时在入口处捕获其诊断值,铁砧菜单更新使用返回的菜单,回调不再捕获未使用的参数。附魔代表过滤跳过可能覆盖参数槽的错误/异常返回值,从而防止
VerifyError失败。 - 通过在 JEI 19.57 及更高版本中选择经过验证的传统或现代 GUI 回调,恢复启动渲染保护。叠加层的准备和绘制等待运行时发布,而 Minecraft 26.1.2 保留其单独的渲染守卫。
兼容性
- 当可选的 JET 索引接口不匹配时,JEI 15.74 的 Lucene 搜索保留其原生实现。兼容性检查继续涵盖较旧的 JEI 版本。
- 兼容性测试运行程序识别传统、Baked Substring 和 Lucene 搜索依赖项,并在插件、Mixin 或链接失败后立即停止。
验证
- 所有三个 Minecraft 目标均构建成功并通过总计 38 次回归套件执行。
- 发布的 JEI 15.21、15.62、15.74 和 19.64 归档文件通过了回调和渲染 ABI 检查,包括复用的参数槽、其他重载和本地索引回退。
- 一个隔离的 Forge 1.20.1 开发客户端在启用 MezzConfig 0.6.3、配方计时和催化剂注册诊断的情况下完成了 JEI 15.74.0.232 的启动。
0.14.5
新增
- 针对所有三个 Minecraft 目标的可选
diagnostics.memoryDiagnostics启动采样。报告整个 JVM 观察到的堆使用量、提交堆、非堆使用量以及 GC 收集计数/时间的变化,且不请求垃圾回收。采样器在完成或取消时结束,过时的启动无法结束新一代的采样器。 - 具有 JFR、NMT、活动对象直方图和隔离测试世界的可重现全包内存比较工具。Tooltip 基准查询可以选择运行时的前缀。
已修复
- 在合并启动布局通知时,匹配经过验证的传统 JEI 15/19 网格监听器。批量可见性更改现在在运行时回调完成后刷新每个侧边栏网格一次,避免在隐藏大量物品时对完整原料列表进行重复的过滤和排序。数据更改和非网格监听器保持其原始顺序;未知监听器 ABI 保留原生行为。
验证
- 所有三个 Minecraft 目标均构建成功并通过总计 36 次回归套件。实际 JEI 15/19 归档文件通过了传统监听器 ABI 检查,包括拒绝未知的副作用。
- 比较了在完整 Minecraft 1.20.1 和 26.1.2 整合包中的加载内存。在单次 ATM9 前后运行中,该修复使估计的累计分配减少了 88.4%,GC 收集减少了 82.4%;GC 后的活动堆仍约为 4.09 GiB。有关条件和限制,请参阅 内存研究。
- 在 Minecraft 1.21.1 开发客户端中验证了这两项新功能:启动内存采样已完成,512 次原料隐藏/恢复操作保留了最终计数并合并为一个网格刷新,且侧边栏完成了 120 次搜索调用。诊断夹具被排除在所有发布 JAR 之外。
0.14.4
新增
- 支持 Minecraft 26.1.2,目标是 NeoForge 26.1.2.109、JEI 29.43.0.100+ 和 Java 25。添加了单独的 ModDevGradle 构建,同时保留现有的 Forge 1.20.1 和 NeoForge 1.21.1 目标。最小 JEI 依赖项配置独立于编译版本 29.43.0.107。
- 适配 JEI 29 的确切过滤器和本地搜索构造函数、GUI 提取和输入事件、配方注册,以及铁砧、研磨机和燃料生成 API。
- 在配方压缩期间保留对象 UID 相等性,并在原料无法安全展平时保留自定义原料谓词。类别 UI 注册在客户端线程上运行,以适应 Minecraft 的字体纹理上传。
已修复
- 已知会修改运行时原料的配方回调现在在客户端线程上运行。在 Minecraft 26.1.2 上,仪式配方的文本布局也在该线程上运行,以便字体测量可以安全地上传字形。这些内置规则适用于现有配置,而无需更改
mainThreadPlugins。
验证
- 所有三个目标均构建成功并通过其回归套件,包括内置的插件线程策略。26.1.2 目标使用 JEI 29.43.0.107 进行了测试,并检查实际的 JEI 29 版本
存档,包括构造函数门控和原生构建器/查询对比。已安装的 JEI 29.43.0.106 存档也通过了 ABI 检查。
- 一个新的 26.1.2 客户端世界完成了启动,显示了物品栏侧边栏,并使用原生索引和可选的工具提示索引运行了 120 次搜索调用。工具提示验证也已通过。这些运行使用了 JEI 及其必需的依赖项。新的配方回调路由规则具有回归测试覆盖;更新后的构建尚未在完整的整合包中重新测试。
0.14.3
修复
- 在异步索引期间切换维度不再导致侧边栏卡在发布状态。
原生过滤器发布现在检查客户端连接和启动生成情况,而不是维度的
ClientLevel实例。工具提示构建通过现有的原生回退机制刷新其世界/玩家上下文。失败或取消的过滤器发布也会完成运行时发布的等待,而延迟的进度回调无法复活已完成或失败的启动过程。 - 插件回调路由现在包装了
PluginCaller回调参数。 时机和线程路由在回调被调用时运行。被跳过的回调不会进入这些操作,而被调用的回调则保留其客户端线程策略、插件上下文和清理逻辑。兼容性检查会验证具体的静态回调方法及其描述符。
验证
- 两种加载器构建版本和回归套件均在受影响实例的 JEI
15.21.0.148下通过;最终重映射的 JAR 文件也通过了其 ABI 检查。一项独立测试执行了实际的发布代码,使用原始引导程序复现了未完成的等待,随后在修复维度更改、断开连接、构建取消、索引、密封、安装及刷新失败、资源更改和过时生成情况后通过测试。 客户端会话对象和索引生成为固定设置;客户端世界验证仍在进行中。 - 两种加载器构建版本和回归套件均已通过。最终重映射的 JAR 文件针对 JEI
15.20.0.120和19.57.0.450通过了回调 ABI 检查。 - 无头环境下的回调组合检查在两种配置顺序下均通过,涵盖了跳过的回调、单次执行以及阶段标题的保留。为此检查隔离了游戏路由服务;完整的客户端世界验证仍在进行中。
0.14.2
修复
- JEI 19.56/19.57 不再启用不兼容的原生搜索构建器 Mixin。
打包的注入目标为
ElementSearch(ElementPrefixParser),而较新版本的 JEI 使用三参数构造函数。兼容性检查现在要求构建器调用必须位于确切的注入构造函数内,而不是接受任何构造函数。不支持的版本将记录跳过的优化并保留原生存储。这修复了在 GitHub issue #10 中报告的JeiNativeSearchBuilderMixin注入失败问题。 - 预算限制的原料过滤器构建也验证了其确切的构造函数目标。
保留的
createElementSearch工厂不再启用对已移除构造函数的注入。新的构造函数形状使用 JEI 的原生过滤器构建。
验证
- 两种加载器构建版本和所有回归套件均已通过。最终重映射的 JAR 文件针对已发布的 JEI
15.20.0.120、19.57.0.449和19.57.0.450通过了构造函数/工具提示 ABI 检查。构造函数回归测试未能通过原始的 JET0.14.1JAR 文件。 受影响用户的完整整合包尚未在客户端世界中测试。
0.14.1
修复
- 在异步 JEI 启动期间打开物品栏不再会在运行时存在之前构建配方书签图标。 JEI 15.59 的
updateForScreenRender在绘制前更新书签布局,此前绕过了渲染保护,导致出现IllegalStateException: Jei Runtime has not been created yet.(Jei 运行时尚未创建)。渲染准备、屏幕初始化和绘制现在都需要启动完成且运行时存在。经过验证的只读访问器也支持没有可选运行时获取器的旧版 JEI;失败或取消的启动过程不会暴露缺失的运行时的情况。 - 合并的启动布局刷新现在在运行时发布之后运行。 插件回调保留其串行顺序,然后安装运行时,然后在同一个客户端线程任务上刷新待处理的网格布局。失败/过时的发布将丢弃待处理的刷新。书签和原料数据不会被保护机制删除或修改。
验证
- 两种加载器构建版本和回归套件均已通过,并且针对五个已发布的 JEI 版本通过了 ABI 检查。一项独立的 Forge JEI
15.59.0.212客户端世界测试在启动期间打开了物品栏,验证了发布后显示的已保存配方书签,并完成了 120 次查询。最初受影响的完整整合包、手动资源重载和世界切换尚未重新测试。
0.14.0
JEI 兼容性
- 更新了与 Forge JEI
15.59.0.212和 NeoForge JEI19.56.0.441的兼容性。 这两个确切版本在开发期间均通过了客户端世界工具提示查询对比和完整索引发布检查。NeoForge 测试使用了 NeoForge21.1.238和 MezzConfig0.5.6。这些检查并不意味着支持每个更新的 JEI 或整合包。 - JEI 19.56 的 MezzConfig 迁移不再静默禁用受支持的搜索路径。
工具提示模式、高级工具提示设置和低内存设置现在支持经过验证
IConfigValue接口与较旧的 getter 方法并存。SearchMode 包变更、前缀元数据、内置存储类型以及 Forge/NeoForgefindElement的返回签名均被显式处理,而非假设使用旧的 JEI ABI。 - 生产环境资源重载钩子同时识别映射名称和开发名称。 特定功能的 ABI 检查在注入前运行;不受支持的搜索实现保留原生路径。发布的过滤器重载仍使用 JEI 的同步重建机制。
- 已测试的旧版 JEI 分支仍受覆盖。 Forge
15.20.0.120、Forge15.48.0.179以及 NeoForge19.27.0.340通过了工具提示查询/发布回归检查。每项优化仍需其各自匹配的 ABI,而不仅仅是版本号匹配。
修复
- 大型启动时成分移除操作不再在支持的新版 Forge 版本上反复重建 JEI 侧边栏。 TConstruct 和 KubeJS 可能在每次移除物品时触发完整的可见列表过滤/排序,而运行时回调会阻塞客户端线程。 JEI 自身的网格布局通知现在会合并,直到这些启动回调完成后再进行运行时发布。可见性更改、缓存失效、第三方监听器和显式查询仍保持即时响应。未知的网格监听器形状未打补丁。
- 默认的成分过滤预算现在即使禁用工具提示索引也能到达实际的 GUI 注册路径。 之前的代码在 GUI 构建已在客户端线程上进行时检查专用启动线程,导致尽管启用了过滤选项,仍执行同步的全索引构建。GUI 注册现在提交预算内的构建并立即返回;仅启动线程等待完整结果。
- 现代原生构建保留 JEI 的大规模搜索构建器。 创建空的烘焙索引然后添加每个初始成分会导致其可变后缀树溢出被填充,增加启动等待时间和查询成本。验证过的内置构建器现在接收初始数据,并在客户端刻中发布前密封;后续添加保留原生行为。
- Blue Skies 和 Delightful 的配方注册被显式路由到客户端线程。
它们对 JEI 运行时成分移除 API 的调用之前在
justenoughthreads-start阶段未能通过线程断言。插件执行保持串行,无部分调用重试。 - MineColonies 核心工具扫描缓存不再依赖可选的 MineColonies Tweaks。 之前组合的门控在缺少 Tweaks 时禁用了核心缓存。现在两个核心钩子和可选的 Tweaks 钩子具有独立的依赖检查。这修复了激活问题;测试过的不含 Tweaks 的 ATM9 实例记录了零次缓存命中,因此不声称有缓存加速效果。
- MineColonies JEI 属性计算不再因重复修改器 UUID 而中止。
临时计算现在使用 Minecraft 的设备移除后添加规则,而不是抛出异常并返回错误的零属性值。此修复仅限于 MineColonies JEI 配方注册,不改变玩家或市民的属性,并由
syncOptimizations.fixMineColoniesAttributeModifiers=true控制。在测试的 Forge ATM9 实例中,之前的 104 条属性警告和重复修改器异常降至零。 - Iron's Spells 压缩不再仅激活其所需钩子的一半。
制造者、配方字段/getter、元组构造函数、法术 API 和卷轴持有者现在共享一个精确的兼容性门控。ATM9 的
3.4.0.11保留其原始配方而不进入失败的压缩器;本地 Forge 和 NeoForge3.16.3JAR 契约仍被接受。这不是对旧版配方格式的压缩实现。
新增
- 实验性工具提示搜索索引,默认禁用。
async.tooltipSearchIndex在客户端线程捕获字符串,并在单个工作写入器上构建仅序数的原生后缀索引。有界的批量/字节队列提供背压而无需客户端等待;当预算和容量允许时,提交 128 个元素不再强制跨越刻边界。 结果仅在完整时发布。取消操作有独立的写入器停止信号,失败则在构建完整的原生回退之前丢弃候选项。 - 构建本地的工具提示重播缓存及可选的差异检查。
syncOptimizations.tooltipStringCache=true允许最多 16 MiB 的估计重播缓存条目;这不是总索引内存的上限。不使用磁盘或跨世界缓存。diagnostics.tooltipSearchMetrics=false启用时开启查询比较,并可能在缓存未命中时重复工具提示调用;性能测量时请保持关闭。
验证与限制
- 聚焦测试再次补充真实客户端运行。 两种加载器构建均包含捕获、取消、队列、发布、存储、ABI 和属性测试。Forge 属性测试重现了原始故障,并与 Minecraft 对比了 200 个混合操作案例。
- 启动测量区分 getter、原生添加、工作线程、客户端刻和帧时间。
仅计时刻会遗漏在
Minecraft.tick之外阻塞渲染线程的工作;跨越发布的帧间隔现在包含在每个重叠的测量窗口中。 运行时发布不被视为第一个可见的侧边栏帧。完成的 JFR 归档与活动记录分开,插件/链接失败会使稳定性运行无效。 - 大型整合包的结果属于针对性回归证据,而非普遍的性能加速保证。 对一次 ATM9 的后续测试将运行时回调交付时间从约 165 秒减少至 6.06 秒, 并将测得的最长帧间隔从 165.73 秒缩短至 7.99 秒。然而,JEI 启动仍耗时约 204 秒,原版类别配方注册耗时约 65 秒。 尚未通过匹配 JET 禁用基线或五组 A/B 系列测试来确立整体改进。
- 已知的第三方故障仍未解决。 UtiliTiX 移除的 JEI 字段/类别依赖项以及 Apotheosis 插槽配方布局错误未在此版本中修复。完整的整合包 重载、取消、第二世界和动态更新接受功能仍不完整。 Tooltip(提示框)索引保持为可选启用;仅凭 JEI 完成启动并不构成稳定性声明。
0.13.8
已修复
- MineColonies Tweaks 装备分类在 MineColonies 生成 JEI 工具
配方时被复用。 现在使用一个线程隔离的、单条目的身份缓存,当 MineColonies 立即再次对其挖掘等级分类同一物品堆栈时,Tweaks 会复用其最终的装备结果。当 Tweaks 没有非空的黑名单/自定义工具标签且没有注册的自定义工具类型时,其原本为空的规则检查将被跳过。任何已配置规则均保留 Tweaks 的原始路径。该优化仅存在于
ToolRecipeCategory.findRecipes周围,保留所有配方,并且仅在完整的 MineColonies 和 Tweaks 调用点 ABI 匹配时才激活。
0.13.7
已修复
- 大型 GTCEu 配方类别以有界、有序批次注册到 JEI。 GTCEu
7.2.0此前会在 JEI 分配另一个已接受的配方列表并填充其原料索引之前,创建一个完整的不可变列表。大于 8192 个配方的类别现在避免了全尺寸的临时列表,同时保留了所有配方、原始迭代顺序和 JEI 焦点索引。可选的 Mixin 需要精确验证的 GTCEu 方法和调用点 ABI;未知版本则保留 GTCEu 的原始注册路径。
0.13.6
已修复
- 客户端任务泵保护机制现在在生产环境 Forge 1.20.1 中激活。 版本
0.13.5的 Mixin refmap 正确针对了m_7245_()Z,但其单独的应用前 ABI 检查仅识别开发名称pollTask()Z,并在注入前禁用了保护机制。现在该闸门接受任一经过验证的名称,只要描述符完全匹配,并记录所选的生产环境 ABI。
0.13.5
已修复
- 异步 JEI 启动线程不再能消耗 Minecraft Client 任务。 受保护的
BlockableEventLoop.pollTask调用仅在接收方是 Minecraft 客户端且调用方是justenoughthreads-start时返回而不出队。渲染线程仍然是唯一的队列消费者,防止了在报告的 JEI15.49.0.199崩溃中出现的错误线程重新调度风暴和并发空队列移除问题。 - JEI 兼容性运行现在拒绝独立不完整的
-unshaded制品。 纯运行时 版本覆盖选择 Maven 的完整默认 jar,验证 Forge 上重定位的 Baked Substring 类,并记录两个加载器确切加载的制品和配置哈希值。
诊断信息
- 第一次被阻塞的客户端任务泵尝试现在记录其完整的堆栈和活动 JEI 阶段。 即使禁用了注册计数诊断信息,插件 UID 和类归属仍然可用;后续的尝试受到速率限制,频率为 10 的幂次。
0.13.4
已修复
- 在主线程专属 API 的 JEI 插件在异步启动期间被选择性路由回客户端线程。 默认的
async.mainThreadPlugins列表涵盖 Alex's Caves、Experience Obelisk、Collector's Reap、Theurgy 和 Productive Trees,解决了 issue 6 和 7 中报告的错误线程故障。用户可以添加完整的 JEI 插件 ID 或模组 ID 以覆盖更多插件。回调顺序保持串行,未知插件 UID 安全失败至客户端线程。 - JEI 自身对线程敏感的阶段保持在客户端线程上,而不将其所有工作移至那里。 原版原料注册保持在客户端线程,因为它枚举创造模式标签并调用第三方回调;Forge 和 NeoForge GUI 运行时构建也留在那里,因为它请求第三方提示框。昂贵的原版配方注册保持在专用的启动线程上。
- Sophisticated Storage in Motion 不再第二次注册 Sophisticated Storage 的 42 个子类型解释器。 兼容性钩子在验证两个插件使用完全相同的调用形状后,仅跳过共享子类型表遍历;所有特定于附加组件的行为得以保留,不兼容的更新保留其原始行为。
更改
- 移除了仓库单元测试,改为真实的客户端启动验证。 构建任务继续验证编译和打包,而行为变化则在隔离的同步和异步运行时环境中,针对受影响的已发布模组 jar 进行演练。
0.13.3
已修复
- JEI 插件回调再次在异步启动期间运行于客户端线程。 这保留了 JEI 原始的线程契约,用于原料移除、GUI 注册、配方扩展和运行时回调,同时其余的启动协调仍在离线线程上进行。异步启动现在如果验证的插件回调...(文本在此处截断)
路由指令缺失或存在歧义。
isHandled 已经拒绝后重新构建了布局,导致 getRecipeExtension 抛出异常。受保护的诊断现在报告无副作用的类/类别摘要;真实的布局和索引失败保留 JEI 原有的详细错误路径。isHandled 和 setRecipe 之间不再出现不一致,并且在应用任何一个 Mixin 之前会检查完整的辅助程序/访问器 ABI。finally 块中运行,生成拆卸清除所有临时状态,相关的多 Mixin 功能需要其完整的 ABI 以及强制的关键注入。Recipe 接口获取配方 ID。 生产版 Forge jar 不再尝试反射仅用于开发的 getId 名称,因此 Thermal 燃料页面在发生 NoSuchMethodException 后无需回退即可正常压缩。registerRecipes,尽管其 addRecipes 调用是在一个合成辅助程序中发出的,这使得优化 silently(静默地)错过。addRecipes 调用点在强制注入应用前作为一个特性进行检查;不兼容的模组更新保留其原始配方,而不是部分启用压缩。0.13.2
已更改
- 成分过滤索引现在在预算化的客户端刻内执行一次独立的搜索。 可见性、工具提示、标签、创造模式标签页和颜色辅助程序仍位于客户端线程上。JEI 启动线程仅等待完成,且完成的过滤器只发布一次。
- 未使用的异步预热索引已被退役。 旧的
searchPreheat、snapshotChunking、sortPreheat、recipeFocusPreheat和catalystPreheat键对于配置兼容性仍然有效,但不能再分配重复的搜索或配方索引。
已修复
- 旧版配置不再能启用重复的前缀搜索索引。 旧索引将工具提示、标签、标签页、颜色、名称和 UID 数据复制到项目拥有的地图中,并可能与 JEI 的权威搜索树一起在大型整合包中消耗数 GB 内存。
- 成分过滤构建失败不再在部分树仍可访问时分配第二个完整的搜索树。 启动过程现在会明显失败并释放隔离的树。
- JEI 启动和兼容性缓存具有确定的生命周期。 专用的启动执行程序在每个构建结束后退出,生成缓存在新开始之前和拆卸期间都被清除,以防止线程局部变量和先前的世界物品列表保持根引用状态。
- Celestial Forge 的激进预览不再从小型输入中丢弃同族物品。 代表性过滤仅在确认完全匹配数量超过配置限制后才开始。
- JEI 15.49.0.200 不再绕过砂轮的代表性限制。 JEI 将其
isItemEnchantable调用移入新的canEnchant辅助程序中,这使得之前的调用点 Mixin 静默失效并恢复了完整的按附魔级别展开的物品配方。经过指令检查的旧版和现代变体现在同时覆盖 15.49.0.199 和 15.49.0.200,且选定的关键注入必须精确匹配一次。
0.13.1
已更改
- 成分过滤准备现在基于客户端刻进行预算化,随后是 JEI 原生的批量索引构建。 JEI 和模组可见性辅助程序仍位于客户端线程上,而异步启动在其专用线程上执行不可分割的搜索构建。这避免了每个搜索存储增量增长,并防止索引与 JEI 运行时其余部分的分配重叠。
- Celestial Forge 的强化输入在模组扩展其包装成分之前进行池化处理。 具有相同修饰符类型的配方共享一次候选扫描,并且激进模式在建立溢出和完整代表性集合后立即停止。
已修复
- Advanced Loot Info 的配方注册在消费共享战利品数据之前,等待排队中的客户端刻集成。 这防止了其后台 JEI 插件在集成服务器启动期间与 JEI Tetra 的计划战利品数据回调发生竞争。
- 前缀搜索永远不会在渲染线程上等待未完成的预热索引。 查询使用就绪的快照索引,或直接回退到 JEI 的原始搜索。
- 当插件仍然卡住时,启动停滞看门狗会报告实时堆栈。 它在配置的阈值处发出第一个堆栈,并每十秒刷新一次,因此永不返回的调用仍会留下可操作的诊断信息。
- JEI 15.20.0.119 及更高版本不再从延迟过滤器中逐个接收成分。
这些版本在其搜索存储旁保留了 UID 映射;在大型整合包中,将这些映射跨越多个客户端刻扩展会导致严重的峰值内存增长。延迟路径现在仅调用 JEI 自身的
addAll或全搜索工厂一次。 - Celestial Forge 激进预览不再丢弃来自小型输入的同族物品。 代表性过滤仅在确认完全匹配计数超过配置限制后才开始。
0.13.0
新增
- 受支持的 JEI 版本使用基于生成范围的酿造配方索引。重复的候选查找使用配方身份哈希,并在集合身份、大小或生命周期生成发生分歧时自动恢复 JEI 的扫描。
- JEI 15.20 可以一次一页地创建大型配方类别。有界布局缓存避免了急切地构建数千个小部件;受影响的类别跳过书签/可制作优先排序,并可选择独立退出。
- 运行时诊断功能可识别已安装的 JEI 版本和内部生成版本。已验证的边界区分了 JEI 15.20 旧版、15.24-15.48.0.178 中间版、15.48.0.179 现代版以及 JEI 19+ 路径,同时 ASM 成员契约仍然是应用 Mixin 的权威依据。
更改
- 搜索提取现在以有界的客户端线程块运行。工作线程协调发布,并仅对不可变快照字符串进行并行处理,因此第三方工具提示代码不会从纯 ForkJoin 池中调用。失败的派生前缀会独立回退到 JEI 搜索,而失败的原料提取会在客户端线程上重试一次。
- 工作执行是自动调整大小的且侵入性更低。
workerThreads=0保留两个处理器(限制在 1-8 之间),工作线程继承模组类加载器并以比正常优先级低一级的级别运行,小型不可变工作负载保持顺序执行。 - 受支持的 Forge JEI 构建会批量隐藏铁砧和砂轮菜单更新。中间槽位更新通过嵌套的线程局部作用域被抑制,并且完整的输入对仅评估一次。
- 热启动配置按 JEI 生命周期冻结。具有显式禁用设置的特定功能 Mixin 会在应用前被跳过,而运行时重载会接收一个新的生成快照。
0.12.0
新增
- 覆盖范围保留的配方压缩现在涵盖更多 JEI 和可选模组类别。燃料、Generator Galore 固体燃料、Mekanism 营养液化器、Thermal Stirling Dynamo、Iron Furnaces 发电机、Ultimate Car 车间、Embers Dawnstone Anvil 和 Tinkers 铸造配方的压缩仅在能保留其完整显示的输入/输出关系时才进行。
- 在压缩不合适的地方缓存重复的可选模组配方生成。Celestial Forge 强化预览、SFM Falling Anvil 配方和 Productive Trees 剥皮工具原料使用基于生成范围的缓存,同时保留其原始焦点行为。
- Celestial Forge、Embers 和 SFM 拥有独立的激进代表模式。这些可选模式默认关闭,因为它们可能会为非代表性物品移除直接焦点命中。它们的共享默认值每组保留三个物品族和 16 个通用修复示例。
- Tinkers' Construct 可以在 JEI 索引之前选择性地预过滤高基数物品变体。默认关闭的过滤器涵盖
#tconstruct:modifiable和#tconstruct:parts,并接受额外的逗号分隔物品标签。 - 可选集成现在具有已发布 JAR 的 ABI 契约。缺失的模组会被静默跳过;安装了但类、字段、构造函数或方法形状不兼容的模组将保留其原始 JEI 行为,而不是应用部分优化。
更改
- Iron's Spells Arcane Anvil 压缩现在保留并行的物品、法术卷轴和输出关系。在选择昂贵的输出模拟之前选择代表性配方,而不是将每个包装器展开为完整的物品-法术等级矩阵。
- 无损可选集成默认启用,而所有降低焦点的优化仍为可选。未经证实的并行列表、覆盖不完整或运行时集成失败会回退到原始配方。
修复
- 在 JEED 安装的情况下,物品栏槽位在 JEI 加载时保持交互状态。宽泛的容器鼠标事件阻塞已被替换为对 JEED 效果点击回调的 ABI 检查守卫。只有会读取未发布 JEI 运行时的效果激活才会被忽略;普通点击、右键点击和拖拽继续通过正常的容器路径。
- Celestial Forge 缓存的原料不再能通过第三方预览代码进行突变。缓存的输入和结果已深拷贝,激进模式不再重用无损缓存条目。
- Celestial Forge Item Reinforce 不再丢失其主要输入和输出槽位。空的动态原料被视为缓存未命中而非永久存储,并且缓存条目由 JEI 生成隔离,以便重载无法重用过时的槽位内容。
- Embers Dawnstone Anvil 激进模式现在应用于实际生成的显示页面。顶部原料为空的有效配方不再中止整个压缩过程,16 个示例修复限制在与相同配方 ID 的单例页面间共享。
0.11.0
新增
- 生成的铁砧配方现在默认使用保留覆盖范围的代表性物品。 每种附魔最多保留三个不同物品家族的示例,而通用材料修复配方最多保留 16 个示例。候选项在输出堆栈模拟之前进行过滤,以避免生成完整的物品-附魔矩阵。
- 生成的砂轮配方现在使用相同的代表性选择。 每种可移除附魔最多保留三个不同物品家族的示例,而在提供合成砂轮配方的 JEI 版本中,通用自我修复配方最多保留 16 个示例。
- 当安装 Iron's Spells Arcane Anvil 时,其注入配方会被精简。 物品-法术等级矩阵被缩减为一组代表性内容,同时保留所有符合条件的物品和所有法术等级。该集成没有硬性依赖,如果安装的 API 不兼容,则回退到未更改的配方。
- 代表性配方限制是可配置的。
optimizeAnvilRepresentatives、anvilRepresentativesPerEnchantment、anvilRepairRepresentatives、optimizeGrindstoneRepresentatives、grindstoneRepresentativesPerEnchantment、grindstoneRepairRepresentatives和compactIronsSpellsImbuing可在jeiContent部分中找到。
已更改
- 生成的铁砧配方默认被保留,而不是完全隐藏。
disableAnvilRepairRecipes和disableAnvilEnchantRecipes现在默认为false。启用任一选项仍会隐藏整个配方类别,并优先于代表性选择。 - 可选配方优化根据已安装的类和方法形状进行选择。 缺失的可选集成将被跳过且不发出警告,而已安装但不兼容的集成将保留其原始配方行为并报告不兼容性。
0.10.4
启动交互与显示兼容性补丁。加载过程在第三方屏幕扩展周围保持安全,其进度面板现在可根据可用屏幕空间进行调整。
已修复
- 在 JEI 仍在加载时点击 JEED 效果描述不再导致客户端崩溃。 容器屏幕上的鼠标按钮事件会推迟到 JEI 发布其运行时为止,防止 JEED 和类似的屏幕扩展读取部分初始化的 JEI 状态。正常输入将在启动完成后立即恢复。这个宽泛的 0.10.4 防护将在 0.12.0 中被窄化的 JEED 回调防护所取代。
- 加载进度面板现在在不同 GUI 比例和分辨率下保持完全可见。 它评估打开容器的右侧、左侧、下方和上方的空间,选择最宽的合适位置,并在任何侧面都无法容纳时回退到屏幕受限的位置。这包括高 GUI 比例下的 1920x1080 以及异常宽的模组容器。
0.10.3
Just Enough Resources 兼容性补丁。JER 插件回调现在在 JEI 后台启动时保留其客户端线程假设。
已修复
- Just Enough Resources 注册不再在专用的 JEI 启动线程上运行。 JER 的回调在客户端线程上同步执行,同时保留 JEI 的回调顺序、时序诊断、插件上下文和异常传播。已在 Forge 1.20.1 上的 JER 1.4.0.247 和 NeoForge 1.21.1 上的 JER 1.6.0.17 上验证。
0.10.2
多人游戏启动渲染补丁。JEI 叠加层现在在客户端进入服务器世界且其运行时完全发布之前保持休眠状态。
已修复
- 在加入多人游戏服务器时打开或渲染库存,不再让 JEI 的书签叠加层读取未发布的运行时。
JEI GUI 初始化、布局更新和叠加层渲染在后台启动进行时保持非活动状态,然后在运行时发布后的第一帧恢复。这修复了 JEI 19.27 和 JEI++ 中来自
RecipeBookmarkElement的Jei Client Configs have not been created yet崩溃。
0.10.1
启动交互补丁。窗口事件不能再在运行时回调和全局运行时发布之间暴露 JEI 的配方 GUI。
已修复
- 在 JEI 加载时调整大小或最大化窗口,不再让重放的点击打开半初始化的配方 GUI。
运行时可用的回调和
Internal.setRuntime现在在一个不间断的客户端线程任务中执行,保留 JEI 的发布前回调顺序,不留事件队列间隙。在启动发布不完整期间,第三方RecipesGui打开请求也会被忽略。这修复了 FTB Quests + Ixeris 崩溃报告中来自RecipeLayoutDrawableErrored的Jei Client Configs have not been created yet。
0.10.0
加载器身份和打包一致性发布。mod id 现在与 CurseForge slug 匹配,分发文件名直接使用该 id,而不是 Stonecutter 加载器/项目后缀。
已更改
- 加载器 mod id 现在是
justenoughthreads。 元数据、JEI 插件 UID、Mixin/refmap 名称、资源、翻译键、日志记录器名称、配置文件名和发布制品均使用与 CurseForge 对齐的身份。在安装此版本之前请删除旧的 jar 文件,以免两个加载器身份同时加载。 - 现有的客户端配置得以保留。 如果不存在
justenoughthreads-client.toml,模组会在配置注册前将
jei_optimize-client.toml复制为新名称。它不会覆盖新文件或删除旧版文件。 - 发布版的 JAR 包现在使用
mod.id命名。** Forge 和 NeoForge 制品使用justenoughthreads-<version>+<minecraft>.jar。加载器标识仍可通过包含的 Stonecutter 构建目录以及 JAR 包的加载器元数据获取。 - JEI 加载进度面板现已右对齐。** 其右边缘跟随缩放屏幕的右边距,而不是居中显示在物品栏旁边的空白区域中。
0.9.2
一个关于分析器线程安全的补丁。后台 JEI 启动不再共享 Minecraft 的可变渲染线程分析器状态。
已修复
- 后台 JEI 启动已与 Minecraft 的渲染线程分析器隔离。** Minecraft 直接将可变的
ActiveProfiler.entries地图传递给FilledProfileResults,后者在不进行同步的情况下迭代该地图。任何在后台线程调用Minecraft.getProfiler()的启动回调都可能导致与该迭代过程发生竞态条件,从而引发ConcurrentModificationException。专用的 JEI 启动线程现在接收 Minecraft 无状态的InactiveProfiler;渲染线程的分析保持不变。报告的运行结果还显示存在渲染线程 push/pop 不匹配的情况,因此崩溃报告无法唯一确定是哪个模组写入了共享的分析器。
0.9.1
一个关于启动交互安全的补丁。在 JEI 仍在索引时打开容器是安全的,即使在某些整合包中其他模组会在渲染线程上排队并回放 GLFW 输入的情况下也是如此。
已修复
- 在 JEI 加载期间打开容器并按下按键不再导致客户端崩溃。
JEI 在其运行时发布之前注册其屏幕输入监听器,因此早期的按键或鼠标事件可能会调用
Internal.getJeiRuntime()并因Jei Client Configs have not been created yet而失败。JEI 特定的键盘、字符、点击、释放、滚动和拖拽处理程序现在直到启动发布完成前保持非活动状态;原版容器输入不会被消耗。 已通过针对 JEI 15.21 确切的输入 ABI 以及在活跃索引期间的真实 Forge 屏幕按键事件进行了验证。Ixeris 可以将事件延迟到这个窗口期,但不会重复它。
0.9.0
一个大列表可用性版本。JEI 现在报告真实的成分索引块进度,并在完成的索引就绪后一次性发布其侧边栏,避免在拥有数千个 JEI 页面的整合包中反复进行部分刷新。
新增
- 后台 JEI 加载的真实进度条。** 物品栏侧面的加载面板首先显示不确定性的准备阶段,随后显示已完成的索引块,例如
12 / 47,最后是发布阶段。进度仅在完整索引了一个块后才前进。
更改
- JEI 侧边栏在索引达到 100% 后一次性发布。** 工作线程和客户端刻过滤器构建器现在都会填充一个独立的搜索索引。中间的块不再使 JEI 的实时侧边栏缓存失效;客户端交换已完成的索引并仅失效一次,然后在暴露最终运行时之前运行运行时可用的插件回调。这避免了在拥有数千个 JEI 页面的整合包中发生缓存刷新风暴。
0.8.1
一个生命周期正确性补丁。当 JEI 仍在构建时断开连接,现在会立即停止其后台启动,而不是允许其在世界关闭后继续运行。
已修复
- 当客户端失去与服务器的连接时,JEI 启动将被取消。** 网络超时、服务器关闭、手动断开连接和服务器转移可能会绕过或延迟 JEI 自身的
JeiStarter.stop()回调。Just Enough Threads 现在也在 Minecraft 客户端销毁边界处取消,使当前生成无效,清除派生工作,并防止过时的运行时发布。通过在 JEI 正在启动时经过真实的 Forge 1.20.1 和 NeoForge 1.21.1 断开路径进行了验证。
0.8.0
一个响应性和正确性版本。JEI 启动现在可以在可取消的后台线程上串行运行,而不会使第三方插件回调并发,并且离开世界后过时的启动工作不再会被发布。
新增
- 响应式串行 JEI 启动。** JEI 可以在一个专用的后台线程上构建,同时渲染线程保持响应。插件回调保留 JEI 的原始顺序,且从不并发分发。运行时发布在客户端线程上原子性地完成。
- 退出世界时立即取消启动。** 每次 JEI 启动现在都有一个生成令牌和一个单次飞行任务。离开世界会中断当前的构建,取消派生工作,并防止发布过时的运行时。
- 游戏内后台加载指示器。** 当 JEI 异步启动时,容器屏幕会在 JEI 通常位于物品栏右侧的区域显示一条简短的状态消息。当启动完成或被取消时,它会自动消失。
已修复
- Sophisticated Storage 的潜影盒配方现在与 JEI 15.48 兼容。** 其特殊的配方包装器没有 JEI 类别扩展,导致
minecraft:shulker_box_from_vanilla_shulker_box及相关配方被拒绝为损坏。Just Enough Threads 现在安全地复用了组合的原版配方的扩展。已通过 JEI 15.48.0.179、Sophisticated Storage 1.4.79.2056 和 Sophisticated Core 1.3.74.2216 进行了验证。 - 运行时可用的插件回调现在在客户端线程上运行。** 移动这个最终的回调
批量离线线程导致 JEI 自身的线程守卫拒绝了来自 Botania、CC: Tweaked、KubeJS、NuclearCraft 和 Applied Energistics 2 的运行时成分变更。JEI 的构建在专用的启动线程上保持串行;
onRuntimeAvailable回调及发布结果返回客户端线程,且不改变插件顺序。 - 移除了 PR #5 中的并行插件分发、主线程重试以及不兼容性存储。并行回调会并发写入 JEI 的共享注册容器,这可能导致配方映射损坏、催化剂注册重复、配方丢失或启动挂起。
- 移除了具有误导性的并行阶段屏障计时器。JEI 正常的串行阶段计时器和可选的每个插件诊断功能现在报告实际执行的工作。
- 恢复了
parallelVanillaRecipes = false和stallWatchdog = true作为默认配置。
0.7.1
这是一个诊断版本。当 JEI 启动缓慢时,日志中仅列出 JEI 和注册了慢速内容的模组,导致错误报告被提交到错误的项目。此版本指向实际消耗时间的代码,并提供了一种方法让你在修复该代码之前继续游戏。
新增
- 一个停滞监控程序,用于标识导致 JEI 启动缓慢的代码。 一旦某个阶段运行时间超过
stallThresholdSeconds(默认为 10),系统会对运行该阶段的线程堆栈进行采样,并将频繁出现的帧写入日志。它仅用于观察:从不更改运行内容、顺序或线程。可通过设置stallWatchdog = false关闭它。 skipCreativeTabs,一种针对无法完成构建的创意标签页的紧急逃生舱口。 列出的标签页将被排除在 JEI 的成分扫描之外,可以通过标签 ID(examplemod:special_tab)或模组 ID(examplemod,将跳过该模组的所有标签页)进行指定。这些物品不再出现在 JEI 中,因此这是一种在真正修复做出之前继续游戏的方法,而不是一个建议长期开启的设置。如果某项条目未匹配到任何内容,日志中将记录存在的标签页 ID 列表。
修复
- 铁砧配方控制现在适用于 JEI 15.48。 JEI 将其修理和附魔配方生成器移至无参数实例方法;Just Enough Threads 现在会选择匹配的控件变体,而不是在看到新签名时禁用两个设置。
更改
- 生成的铁砧修理和附魔配方默认隐藏。 大型整合包可能需要花费数分钟来生成每种物品与附魔书的组合。将任一
disableAnvil...选项设置为false以恢复此类 JEI 配方。 parallelVanillaRecipes现在默认为false。 某些模组配方和惰性成分缓存在首次解析其成分时会执行可变操作或仅限主线程的工作。该选项仍可用于受控的每整合包基准测试。
0.7.0
这是一个兼容性版本。Just Enough Threads 现在会根据其找到的 JEI 版本进行调整,而不是假设特定的结构,因此 JEI 更新要么继续正常工作,要么安静地退让。
新增
- 支持新版 JEI 构建中重构的成分过滤器。 离线搜索索引拥有第二种实现方式,它挂钩 JEI 自身的搜索工厂而非构造函数,并根据已安装的 JEI 实际声明的内容选择匹配的实现。已在 1.20.1 的 JEI 15.20.0.120 和 15.48.0.179,以及 1.21.1 的 19.27.0.340 中验证通过。
修复
- 不受支持的 JEI 版本不再导致游戏崩溃。 每个补丁都会针对实际安装的 JEI 进行检查,任何目标结构发生变化的优化都将在日志中附带说明被关闭,而不是在启动期间失败。已在 1.20.1 的 JEI 15.48.0.179 和 1.21.1 的 JEI 19.37.0.363 上报告相关问题。 (#1)
更改
- 成分过滤器现在会在不同成分 UID 的数量旁边显示成分总数。JEI 按 UID 对其搜索索引进行键控,因此每当整合包包含共享同一 UID 的成分时,两者就会不同,而旧的措辞会让这种情况看起来像是成分丢失了。
0.6.0
这是一个正确性版本。两个缺陷可能导致 JEI 丢弃配方或提供来自上一个世界的数据。这两个问题均已修复,相关的优化已基于新的设计重新构建,在保持其测量收益的同时,不再从工作线程接触 JEI。
修复
- 配方可能会无声地从 JEI 中消失。
parallelVanillaRecipes从工作线程调用 JEI 的IRecipeCategory.isHandled。该调用会修改 JEI 内部每个配方的扩展缓存并调用第三方分类扩展,这两者均非线程安全,因此并发访问可能导致缓存损坏。受影响的配方随后在注册过程中被丢弃,并在日志中留下Failed to create recipe extension错误。由于 JEI 会丢弃所有被归类为未处理的内容,这种丢失可能覆盖配方列表的大部分。(#2) - 后台索引可能会泄漏到下一个世界中。 离线成分搜索构建未绑定到 JEI 运行时生命周期。在构建仍在运行时离开世界,可能会将该结果发布到你进入的下一个世界的 JEI 实例中。现在的构建携带运行时生成标记,在 JEI 关闭时被取消,并且如果它们不再属于当前运行时则会被丢弃。
- JEI 关闭时,由模组排队的客户端刻任务现在会被清除,因此上一个世界的残留内容不会干扰新世界的运行。
- 当不相关的功能标志被禁用时,客户端刻队列不再丢弃已排队的任务。
更改
parallelVanillaRecipes现在在工作线程上预先解析配方原料标签,而不是在那里运行 JEI 的验证逻辑。工作线程仅读取配方数据并丢弃其结果;JEI 自身的验证、排序和注册仍在主线程上按原样运行,且仅在工作线程完成后执行。原料标签的解析是惰性的,而 JEI 无论如何都会在启动期间触发所有解析,因此在并行模式下提前进行解析是性能提升的来源。delayCompact现在在稍后的客户端刻中在主线程上运行 JEI 的配方列表压缩操作,而不是在工作线程上执行。压缩会精简 JEI 用于响应查询的核心列表,因此它之前在线程外执行是不安全的。该选项仍保持避开阻塞式启动路径,这正是该选项的设计目的。
性能
通过在 Forge 1.20.1 和 NeoForge 1.21.1 上分别以禁用和启用模组的状态进入同一世界进行验证。构建原料搜索索引仍然是主要的收益来源:
| 指标 | Forge 1.20.1 | NeoForge 1.21.1 |
|---|---|---|
| 构建原料过滤器 | 413 ms 降至 143 ms (-65%) | 528 ms 降至 258 ms (-51%) |
| 注册运行时 | 705 ms 降至 579 ms (-18%) | 1016 ms 降至 734 ms (-28%) |
| 启动 JEI(总计) | 1918 ms 降至 1800 ms (-6%) | 2260 ms 降至 1913 ms (-15%) |
以上数据基于小型测试整合包测量。节省的时间随整合包规模扩大而成比例增加,因此大型整合包能获得更显著的绝对时间减少。在所有测试运行中,启用或禁用模组时的原料数量完全一致,且没有丢失任何配方。
在此整合包规模下,parallelVanillaRecipes 未显示出可测量的收益:预先解析所有原料耗时不到 15 毫秒,且配方注册时间在误差范围内保持不变。如果您偏好关闭此选项,可以将其关闭;原料搜索索引优化不受影响。
0.5.0
新增
- JEI 运行时状态跟踪,以便后台任务可以与当前活动的 JEI 运行时关联。
更改
- JEI 运行时卸载后,原版配方验证回退为顺序执行,以避免在游戏内重建期间发生死锁。
0.4.0
新增
- 与 Advanced Loot Info 兼容:当它在主线程上等待服务器数据时,客户端现在会继续处理其任务队列,而不是完全阻塞。
更改
searchPreheat现在默认为关闭。它会构建第二个近似搜索索引,可用于覆盖前缀查询的 JEI 自身结果,但它与asyncIngredientFilter功能冗余,后者会在后台重新构建 JEI 的真实搜索索引。
0.3.0
修复
- 后台原料过滤器构建现在复用过滤器自身的
ElementPrefixParser。使用新的解析器构建会导致生成的搜索索引中,前缀存储(如@表示模组、$表示标签等)无法被过滤器的实时查询匹配到,从而静默破坏前缀搜索功能,而纯文本搜索则继续正常工作。
0.2.0
新增
- Just Enough Threads 首次发布:提供后台 JEI 原料搜索索引、并行原版配方验证、延迟配方列表压缩以及按功能配置切换支持。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
评论 0
登录后参与评分
还没有评论,来抢沙发吧