TurboBoost
A client-side Fabric utility mod: switchable performance profiles, an FPS/RAM
overlay, dynamic FPS, a manual benchmark, optional Iris shader toggling, and a
server-list switcher. An optional desktop companion app can connect to it.
TurboBoost adjusts Minecraft's own video options for you and shows what the game
is doing. It does not replace Sodium or
Lithium — it does not change the rendering or
tick engine. For the largest FPS improvements, install Sodium + Lithium; TurboBoost
runs alongside them and handles the settings automation, overlay, and tools.
Features
- Boost profiles — one key cycles Off → Quality → Balanced → Potato. Each
profile sets vanilla video options (graphics mode, clouds, particles, entity
shadows, vsync, render/entity distance). Your previous settings are restored on
"Off".
- FPS / RAM overlay — shows FPS, frame time, average and 1% low FPS, JVM heap
usage, current server, and companion-app link status. Toggle with a key.
- Dynamic FPS — lowers the framerate cap while the game window is unfocused or
minimized, which can reduce GPU load and power use.
- Auto-Boost (optional) — applies the boost profile if in-game FPS stays
below a configurable threshold for a few seconds.
- FPS benchmark — measures average FPS for 5s, applies the boost, measures 5s
more, and reports the before/after numbers.
- RAM clean — requests a JVM garbage collection and reports the heap freed.
- Server-list switcher — keep your servers grouped by category; one key
reconnects you to the one with the fewest players / lowest ping in a category
you choose. (It cannot detect player skill — it sorts by live player count and
ping only.)
- Iris shader toggling (optional) — if Iris
is installed, a key turns shaders on/off, and the heavier boost profiles turn
shaders off (and back on at "Off"). Does nothing if Iris is absent.
- Companion app link (optional) — connects to the desktop app over a
loopback-only socket (
127.0.0.1) so the app can apply a profile and read
FPS/RAM. The mod works fully without the app.
Default keybinds (rebindable in Controls)
| Key |
Action |
| F6 |
Toggle the FPS/RAM overlay |
| F7 |
Cycle boost profile (Off → Quality → Balanced → Potato) |
| F8 |
Request a RAM (heap) cleanup |
| F9 |
Run the before/after FPS benchmark |
| F10 |
Toggle Iris shaders (if Iris is installed) |
| K |
Switch to the lowest-population server in your category |
Requirements
- Minecraft 1.20.1, 1.20.4, 1.20.6, 1.21, 1.21.1, 1.21.4, 1.21.8, or 1.21.11
(Fabric) — download the file matching your version
- Fabric API — required
- Sodium + Lithium — recommended, not bundled
Optional companion app
A separate Windows desktop app can adjust RAM/JVM arguments, apply Windows
power/priority settings, and live-ping your server list. It is not required and
is not included here; the mod is fully functional on its own.
Client-side only. It changes your own video options and which server you connect
to — no server-side behavior and no gameplay automation.
