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

Off-thread 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 builds it on worker threads after you enter the world, then swaps the finished index into JEI. The result is identical to JEI's own, and if the off-thread build runs into trouble it falls back to JEI's normal build.

What you will see: the JEI item list appears a moment after you spawn, instead of holding up world load.

Parallel vanilla recipe validation

JEI validates its built-in recipes (crafting, smelting, stonecutting, and more) one at a time. Just Enough Threads runs that validation across CPU cores and produces an identical result.

Performance

Measured 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:

The biggest single cost — the ingredient index — no longer blocks loading; it builds in the background once you are already in the world. Numbers vary with hardware and pack size.

Configuration

Config file: config/jei_optimize-client.toml. Every optimization can be toggled independently.

• enabled — master switch for the whole mod.
• asyncIngredientFilter — build the ingredient search index off-thread after world entry.
• parallelVanillaRecipes — validate vanilla recipes across CPU cores.

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

Just Enough Threads

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

功能

离主线程构建物品搜索索引

JEI 默认在主线程上构建物品筛选器——也就是覆盖所有物品与流体的搜索索引——而你只能在加载界面干等。在大型整合包里,这一步要好几秒。Just Enough Threads 会在你进入世界之后用工作线程构建它,完成后再把成品索引原子替换进 JEI。结果与 JEI 原生完全一致;如果离主线程的构建出现问题,会自动回退到 JEI 的常规构建。

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

并行校验原版配方

JEI 会逐条校验其内置配方(合成、熔炼、切石等)。Just Enough Threads 把这一步分散到多个 CPU 核心并行完成,结果完全一致。

性能

在一个大型整合包(约 21,000 个物品/流体、34,000 条原版类配方)中,于同一台机器进入同一世界,关闭 vs 开启优化:

最大的单项开销——物品索引——不再阻塞加载;它会在你已经进入世界之后于后台构建。具体数字随硬件与整合包规模而变化。

配置

配置文件:config/jei_optimize-client.toml。每一项优化都可以单独开关。

• enabled — 整个 mod 的总开关。
• asyncIngredientFilter — 进入世界后离主线程构建物品搜索索引。
• parallelVanillaRecipes — 多核并行校验原版配方。

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

需求