ThreadTweak is a performance optimization mod that lets you improve and tweak Minecraft's CPU thread scheduling for Fabric and Quilt mod loaders. As a maintained fork of the original Smooth Boot mod, ThreadTweak gives players control over thread priorities to reduce CPU contention during startup and gameplay on Minecraft 1.20 and newer.
If you have ever watched Minecraft hog your entire CPU during launch — freezing your desktop, stalling Discord, or making your browser crawl — you know the frustration of poor thread scheduling. Mojang partially addressed this in version 1.19.4, but many players still report that adjusting thread priorities makes a real difference on their hardware. That is exactly the gap ThreadTweak fills. Originally created by getchoo as a continuation of UltimateBoomer's Smooth Boot, this mod has earned over 8 million downloads on Modrinth, proving that CPU-level tweaks remain valuable even after Mojang's official fix. ThreadTweak keeps the thread priority adjustment feature alive for modern Minecraft versions, giving you the knobs that vanilla took away.
Key Features of ThreadTweak
- CPU Thread Priority Control — ThreadTweak lets you adjust the priority level of Minecraft's worker threads directly from the game. This means you can lower Minecraft's thread priority so it stops starving your other applications of CPU time, or raise it when you want maximum performance dedicated to the game.
- Smoother Startup Experience — By tweaking how aggressively Minecraft claims CPU resources during launch, ThreadTweak can reduce the system-wide slowdown that happens when the game loads chunks, assets, and mods simultaneously. Players on older or budget hardware often notice the biggest improvement here.
- Maintained Fork of Smooth Boot — The original Smooth Boot mod stopped receiving updates, but ThreadTweak carries that project forward with the original author's blessing. You get the same core functionality, updated and compatible with Minecraft 1.20 through 1.21.11, so you do not have to rely on an abandoned mod.
- Fabric and Quilt Support — ThreadTweak works with both Fabric and Quilt mod loaders, covering the two most popular lightweight modding platforms. You do not need to choose between loaders or maintain separate mod setups — one jar file handles both.
- Lightweight and Non-Invasive — The mod focuses specifically on thread scheduling without touching rendering, chunk loading algorithms, or other game systems. This targeted approach means it appears to be lightweight and plays well alongside other optimization mods like Sodium or Lithium without conflicts.
- Open Source Under MIT License — ThreadTweak is fully open source, hosted on GitHub. You can inspect the code, verify exactly what it changes, and even contribute fixes. The MIT license means there are no restrictions on how you use or distribute it in modpacks.
- In-Game Configuration — Rather than requiring you to edit config files manually, ThreadTweak provides options you can adjust without leaving the game. This makes it easy to experiment with different thread priority settings until you find what works best for your specific hardware.
Screenshots
How to Install ThreadTweak
- Install Fabric Loader or Quilt Loader for your Minecraft version (1.20 through 1.21.11 supported).
- Download the correct ThreadTweak .jar file for your Minecraft version from the download section below.
- Open your Minecraft installation folder — press Win + R, type
%appdata%.minecraft, and hit Enter. - Drop the downloaded .jar file into the
modsfolder. Create this folder if it does not exist. - Launch Minecraft using your Fabric or Quilt profile. ThreadTweak will apply default thread priority tweaks automatically — no extra configuration required to get started.
Requirements & Compatibility
| Requirement | Details |
|---|---|
| Mod Loaders | Fabric, Quilt |
| Minecraft Versions | 1.21.11, 1.21.10, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21, 1.20.6, 1.20.5, 1.20.4, 1.20.2, 1.20.1, 1.20 |
| License | MIT (open source) |
| Author | getchoo |
| Total Downloads | 8,192,235+ |
What's New
- Updated to Minecraft 1.21.11 with community contribution from groundbreakingmc.
- Added support for Minecraft 1.21.9 via contributor uku3lig.
- New mod icon designed by intergrav for a refreshed look in mod menus.
- Added Brazilian Portuguese (pt_br) translation by seriousfreezing.
- Multiple new contributors joined the project, keeping development active and community-driven.
Pros and Cons
Pros
- Actively maintained with regular updates for new Minecraft versions
- Over 8 million downloads — well-tested by a massive player base
- Works with both Fabric and Quilt from a single jar
- Open source under a permissive MIT license
- Does not conflict with other popular optimization mods
- Endorsed by the original Smooth Boot author
Cons
- No Forge or NeoForge support — Fabric and Quilt only
- Benefits vary by hardware — some systems may see minimal improvement
- Mojang's 1.19.4 fix reduced the core need, so gains are less dramatic than original Smooth Boot on older versions
- Limited configuration options compared to full performance mod suites
Alternatives to ThreadTweak
- Sodium — A comprehensive rendering optimization mod that dramatically improves FPS and reduces GPU load. Pairs well with ThreadTweak since they target different systems.
- Lithium — Optimizes game logic, world generation, and entity processing on the server side. Complements ThreadTweak by tackling performance bottlenecks beyond thread scheduling.
- ModernFix — A broad performance mod that addresses memory usage, loading times, and various inefficiencies across the game. Covers some overlapping ground with ThreadTweak's startup improvements.
Download ThreadTweak
| Minecraft Version | Fabric | Quilt |
|---|---|---|
| For Minecraft 1.21.11 | Download | Download |
| For Minecraft 1.21.10 | Download | Download |
| For Minecraft 1.21.9 | Download | Download |
| For Minecraft 1.21.8 | Download | Download |
| For Minecraft 1.21.7 | Download | Download |
| For Minecraft 1.21.6 | Download | Download |
| For Minecraft 1.21.5 | Download | Download |
| For Minecraft 1.21.4 | Download | Download |
| For Minecraft 1.21.3 | Download | Download |
| For Minecraft 1.21.1 | Download | Download |
| For Minecraft 1.21 | Download | Download |
| For Minecraft 1.20.6 | Download | Download |
Always download mods from official sources to stay safe.
Frequently Asked Questions
Is ThreadTweak the same as Smooth Boot?
Yes — ThreadTweak is a direct fork of Smooth Boot, maintained for Minecraft 1.20 and newer. The original Smooth Boot author gave explicit permission for this continuation. ThreadTweak carries forward the same thread priority adjustment features, updated for modern Minecraft versions that the original mod no longer supports.
Does ThreadTweak actually improve performance after Minecraft 1.19.4?
It depends on your hardware. Mojang fixed the core thread scheduling issue in 1.19.4, but adjusting thread priorities can still help on systems where Minecraft competes heavily with other programs for CPU time. Players have reported noticeable improvements particularly on lower-end machines or systems running many background applications.
Can I use ThreadTweak with Sodium and Lithium?
Yes — ThreadTweak is compatible with both Sodium and Lithium. Since ThreadTweak only modifies CPU thread priorities while Sodium handles rendering and Lithium handles game logic, they target completely different parts of the game and work well together without conflicts.
Does ThreadTweak work with Forge or NeoForge?
No — ThreadTweak only supports Fabric and Quilt mod loaders. There is no Forge or NeoForge version available. If you use Forge, you would need to look for alternative optimization mods that offer similar thread management features on that platform.
Do I need to configure ThreadTweak after installing it?
No — ThreadTweak works out of the box with sensible default settings. However, you can adjust thread priority values in-game if you want to fine-tune how aggressively Minecraft uses your CPU. Most players find the defaults work well, but experimenting with settings can yield better results on specific hardware configurations.
