JEIOptimizer
If you play heavily modded Minecraft, you know the pain. You click "Join Server," and then you wait. And wait. The "Joining world…" screen taunts you while your friends are already deep underground, mining diamonds without you. On a large modpack, that wait can stretch to 40 seconds or more. JEIOptimizer is a client-side mod that attacks the root cause of this delay, shaving off up to 17 seconds from your total connect time.
Why Is Joining a Modded Server So Slow?
The culprit is often JEI (Just Enough Items). When you connect to a modded server, JEI rebuilds its entire item search index from scratch. This is because the server might ship custom recipes that your client needs to know about. On a 250-mod pack with around 50,000 items, this index rebuild takes over 12 seconds on the main thread. During that time, your client is completely frozen, doing nothing but staring at a loading screen.
JEIOptimizer changes how this index is built. Instead of doing all the work on a single thread, it distributes the task across multiple worker threads. Each search prefix—like item name, mod ID, or tag—owns its own independent data structure. This means they can be built simultaneously without any conflicts or race conditions.
Real-World Performance Gains
Testing on a 250+ mod pack (including AE2, Mekanism, Create, and Cobblemon) with a Ryzen 5600X and 8 GB RAM allocated showed dramatic results. The ingredient filter build time dropped from 12.00 seconds to just 0.79 seconds—a 94% reduction. Total JEI startup time fell by 45%, and the overall server connect time dropped from roughly 40 seconds to about 23 seconds. That is a consistent 17-second saving every single time you join.
How It Works Under the Hood
JEI's search index is split into "prefixes"—name, mod ID, tag, tooltip, creative tab, colour, and resource ID. Each prefix has its own suffix tree, making them safe to build independently. Vanilla JEI walks every ingredient for every prefix in sequence on one thread. JEIOptimizer builds these prefixes at the same time, one per worker thread.
The tooltip prefix is deliberately kept on the main thread because building it calls ItemStack.getTooltipLines(), which runs arbitrary mod code that may touch main-thread-only state. It still runs concurrently with the worker pool, so no wall-clock time is lost, but nothing gets called off-thread that shouldn't be.
Configuration Options for JEIOptimizer for Minecraft
The mod comes with sensible defaults, so you can just drop the jar in and go. But if you want to tweak things, the config file jeioptimizer-client.toml offers several filter modes:
- OFF — Vanilla JEI behavior
- BATCH — A small cache-friendly improvement, single-threaded
- PARALLEL_PREFIX — Parallel per-prefix build (safe)
- PARALLEL_FULL — Also parallelizes tokenization within a prefix (default, fastest)
Recipe Generation Optimizations
JEI builds synthetic entries at startup by driving a hidden menu for each combination—like every enchantable item times every enchantment level. JEIOptimizer skips redundant recalculations that used to happen when writing each input slot. This is transparent; you get the same entries and values with less work.
There is also an optional setting to skip generated enchantment and repair recipes entirely. This is off by default because it changes what you see in JEI, but it can be a large startup win on packs with hundreds of enchantments. Real recipes are never affected either way.
An Extra Manual Tweak for 8 More Seconds
In config/jei/jei-client.ini, you can change tooltipSearchMode = DISABLED. JEI indexes the tooltip text of every item on every connect, and some mods do heavy work in tooltip rendering. Players almost always search by name, not tooltip text. If you still want tooltip search via the $ prefix, use REQUIRE_PREFIX instead. Combined with JEIOptimizer, this tweak helps push your connect time down to that ~23-second mark.
Compatibility and How to Install
JEIOptimizer supports Minecraft versions 1.19.2, 1.20.1, 1.21.1, 26.1.2, and 26.2. It runs on Forge for 1.19.2 and 1.20.1, and NeoForge for 1.21.1 and newer. It is client-only, so a server installation is not needed—putting it in a server's mods folder is a no-op. Each build targets a specific JEI range, so grab the file that matches your pack.
To learn how to install, the process is straightforward: download JEIOptimizer from its official source and place the jar file into your mods folder. That's it. No configuration touching is required for the default win.
If you are using the foxygame.net launcher, you can find JEIOptimizer directly in its add-on catalog, which handles the version compatibility checks for you and offers a one-click install that saves you from manually hunting down the right build for your modpack.
What JEIOptimizer Won't Speed Up
It is important to be honest about scope. JEIOptimizer does not speed up game launch, model baking, or resource pack reloads. It does not accelerate server data sync, which is network and mod serialization bound. And it does not fix per-mod runtime data regen—like Create generating 2,124 recipes every connect or Cobblemon resyncing all fossils. The mod removes JEI from the bottleneck, making it no longer the long pole in your join time.
Experimental Features
There are opt-in experimental features, but they are off by default because they can break things on real mod packs. plugins.parallel_phases parallelizes plugin recipe registration, but many JEI plugins like Theurgy and Ars Nouveau are not thread-safe and will crash. plugins.parallel_creative_tabs parallelizes the creative tab build, but many mods cache tab state non-thread-safely, which can result in lost items. Leave these off unless you know exactly what you are doing.
Frequently Asked Questions
Will this break JEI search? No. Default settings change how the index is built, not what is built. Same items, same recipes, same search results.
I have a smaller modpack. Will I see less benefit? Yes. Below ~10,000 items, the gain is marginal. This mod is designed for 30k+ item packs.
Does it work with EMI or REI? No. This targets JEI specifically. EMI has its own architecture and is already fast.
JEIOptimizer is a focused, well-tested solution to a specific problem. If you play large modpacks on servers, it is one of the most impactful quality-of-life mods you can add. The time you save on every reconnect adds up quickly, letting you spend more time playing and less time staring at a loading screen. For those who want the smoothest experience, using the foxygame.net launcher ensures your JEIOptimizer installation stays up to date automatically, so you always get the best performance without manual file management.
--- **Update Sep 18, 2026:** Added 2 files for version 1.21.1, 1.20.1 (NeoForge, Forge).