Back to mods
StutterFix project artwork

Modrinth · Minecraft mod

StutterFix

Reduce stuttering when generating new chunks

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which StutterFix release should I use?

Updated 2 years ago
Latest stable file mc1.21-0.2.3
Game version 1.21
Loader Fabric

StutterFix mc1.21-0.2.3 targets 1.21 with Fabric. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is StutterFix required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does StutterFix mc1.21-0.2.3 need?

mc1.21-0.2.3. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add StutterFix without breaking your instance.

Built for StutterFix mc1.21-0.2.3. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use mc1.21-0.2.3. It targets 1.21 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside mc1.21-0.2.3. It opens that exact file at the source.

About this project

What does StutterFix add?

StutterFix

StutterFix is a mod that allows you to configure the main threads of the game, allowing you to control stuttering. By default, the mod already comes with an approximate configuration to reduce stuttering.

The new version 0.1.8 allows you to configure threads, I added a new option in the menu.

Option Menu

There are five options available for configuration, with N being the number of threads your processor supports:

  • Worker threads count
    Vanilla default N - 1, StutterFix default N - 5, is the number of threads running to perform tasks like generating chunks. The smaller the value, the less CPU overhead, reducing stuttering, and the slower the chunk generation speed.

  • Priority cutoff point
    Indicates the cutoff point for the priority of worker threads. The higher the value, the higher the first part of the threads will be with normal priority and the lower the last part will be with minimum priority. The value must be less than the number of worker threads to have the cutoff point, otherwise all threads will have normal priority. Threads with minimum priority help reduce stuttering.

  • Render thread priority
    The rendering thread is where the client runs, such as the player, sound, inputs, and rendering.

  • Server thread priority
    In singleplayer mode, the game starts the integrated server that runs the entire world, such as ticks, entities and initializing the generation of chunks (which will be executed in the worker threads). This option only appears when playing in a world in singleplayer mode.

  • Remove Yield()
    The rendering thread has a call made in each loop, called yield(), with the function of informing the “scheduler” that the current thread is willing to abandon the current use of the processor to other threads. Removing yield() can make fps more stable.

The Worker Threads Count, Priority cutoff point setting has little effect in multiplayer because the world is generated by the server and therefore there are no stuttering issues for the client caused by the generation in the world.

Disabling GUI - Version >= -0.2.3

In the config folder in the .minecraft directory there is the stutterfix-config.json configuration file, where there is the "hide_gui" option, set it to true to disable the game interface, if you want the interface again, set it to false. It is worth remembering that it is necessary to start the game with the updated mod at least once to have the configuration in the file.

Other mods I recommend

I recommend using this mod with the Sodium mod and Concurrent Chunk Management Engine (C2ME).

Changelog

In versions 0.1.5 and earlier, all these worker threads have minimum priority, due to the low responsiveness in chunk generation I decided to release 0.1.6 with the worker threads in normal priority.

In version 0.1.7 I had the idea of leaving the first half of the worker threads with normal priority and the last half with minimum priority to better reduce stuttering and better responsiveness when generating chunks.

In version 0.1.8, I created the option in the menu to configure threads and also removed the removal of Thread.yield() as it was conflicting with other mods like VulkanMod.

In version 0.1.9, the remove yield() option was added, if you use VulkanMod, this option will not appear in the menu. The tooltip has been improved.

In version 0.2.0, changes were made to the gui, to resolve compatibility issues with some mods, such as bedrockify.

Warnings

The mod does not affect the stuttering problem that occurs due to the garbage collector, I reduced the problem by using -XX:+UseShenandoahGC and allocating more memory in jvm arguments, do a search for jvm arguments for minecraft to get more information.

If you encounter any issues, please report the issue on Github.

Project description from Modrinth.

Pick your setup

StutterFix by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

10 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

StutterFix versions and loaders

33 of 33 releases match

Looking for an older file? The official Modrinth project page is in Resources.