ThreadTweak Bootstrap and Main Worker Thread Count Settings Explained

guide

ThreadTweak exposes several thread-related settings that shape how quickly Minecraft starts up and how smoothly it runs once you are in a world. Two of the most consequential are Bootstrap Worker Thread Count and Main Worker Thread Count, and understanding what each one controls helps you tune the game to your hardware instead of guessing.

Bootstrap Worker Thread Count

Bootstrap Worker Thread Count governs the pool of worker threads used during the early bootstrap phase of startup. This is the stage where the game assembles the pieces it needs before you ever reach a menu.

The setting carries a warning: raising it is known to reduce performance rather than improve it. In other words, more threads here is not better. If you are chasing faster startup, adding threads to this pool works against you. Leaving it at a conservative value, or lowering it if you have experimented upward, is the safer approach.

Main Worker Thread Count

Main Worker Thread Count controls the primary pool of worker threads the game relies on. Its tooltip states that this value has a large effect on load times. That makes it the first setting to look at when startup feels slow.

The same tooltip notes that it may also influence performance while you are actually playing. So this is not purely a startup knob — changing it can carry over into your in-game experience. Because the effect on load times is described as significant, adjust it in small steps and observe the result rather than making a large jump in either direction.

Priority Settings

Alongside thread counts, ThreadTweak lets you adjust the priority assigned to several thread groups. Priority determines how much attention the operating system gives a thread relative to others competing for processor time.

Game Thread Priority — the priority of the main game thread.
Bootstrap Worker Priority — the priority of the threads handling the bootstrap phase.
Main Worker Priority — the priority of the main worker thread pool.
IO Worker Priority — the priority of threads handling input and output work.
integratedServer — the priority of the Integrated Server Thread.

Each of these is adjusted through its own control in the mod's interface. Raising a priority tells the system to favor that group; lowering it does the opposite. Since these settings interact with whatever else is running on your machine, change one at a time and check the effect before moving on.

How to Operate These Settings

Open the ThreadTweak interface to reach the thread count and priority options. Each setting has its own control, and the tooltips described above appear alongside them to explain what the value does.

Some actions in the mod are bound to hotkeys rather than interface controls. For any such action, use the corresponding hotkey and set it in the controls menu if you have not assigned one yet.

Practical Guidance

Start with Main Worker Thread Count, since its effect on load times is the most pronounced. Nudge it and time your startup. Treat Bootstrap Worker Thread Count with caution — the mod itself warns that increasing it hurts performance, so there is little reason to push it higher. Priority settings are best left near their defaults unless you have a specific reason to shift them, and even then, one change at a time keeps cause and effect clear.