# 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.

StutterFix

External resources

Project members

Technical information