Back to mods
WindowFix project artwork

CurseForge · Minecraft mod

WindowFix

Used to fix the issue of main loop hang/freeze that may occur in Minecraft under Windows after operating the system menu of the window title bar (right-clicking the title bar, minimizing, restoring, etc.).

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

Quick answer

Which WindowFix release should I use?

Updated 8 days ago
Latest stable file windowfix-neoforge-1.0.1+mc26.1.jar
Game version 26.1, 26.1.1, 26.1.2
Loader NeoForge

windowfix-neoforge-1.0.1+mc26.1.jar targets 26.1, 26.1.1, 26.1.2 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

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

The project page does not say whether this file belongs on the client, dedicated server, or both.

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

The source does not explicitly classify this release as client-only or server-only.

What else does windowfix-neoforge-1.0.1+mc26.1.jar need?

windowfix-neoforge-1.0.1+mc26.1.jar. 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 WindowFix without breaking your instance.

Built for windowfix-neoforge-1.0.1+mc26.1.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use windowfix-neoforge-1.0.1+mc26.1.jar. It targets 26.1, 26.1.1, 26.1.2 with NeoForge; 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

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside windowfix-neoforge-1.0.1+mc26.1.jar. It opens that exact file at the source.

About this project

What does WindowFix add?

WindowFix

WindowFix addresses a Windows-specific Minecraft issue where interacting with the title-bar system menu (right-click title bar, minimize, restore, etc.) may cause the game loop to hang or stutter.

Environment

  • Windows client

Configuration

Config file is generated after first launch:

config/windowfix-client.toml

Example:

blockTitleBarSystemMenu = false

Restart the game after changing config values.

  • blockTitleBarSystemMenu
    • true: Block the title-bar system menu for maximum stability.
    • false: Keep the system menu and enable native MNS_MODELESS compatibility handling.

Usage

  1. Put the built JAR into your client mods directory.
  2. Launch the game and adjust config/windowfix-client.toml as needed.

Log Keywords

Search these in latest.log:

  • Installed Win32 window hook for system menu freeze workaround.
  • Enabled MNS_MODELESS on system menu.

Known Limitations

  • Windows-only behavior.
  • In native compatibility mode, brief hitching may still happen depending on system window management behavior.

Project description from CurseForge.

Pick your setup

WindowFix by Minecraft version and loader

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

71 available setups

Showing the newest 12 of 38 game versions. Older files are in the list below.

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

Recent files

WindowFix versions and loaders

19 of 19 releases match

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