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.).
- Loaders
- FabricNeoForgeForge
- Downloads on Modrinth
- 41.4K
- Followers on Modrinth
- 6
- versions
- 23
- Updated
- October 11, 2026Oct 11
- Published
- in 2026
At a glance
Install in the game only; not needed on the server
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 = falseRestart the game after changing config values.
blockTitleBarSystemMenutrue: Block the title-bar system menu for maximum stability.false: Keep the system menu and enable nativeMNS_MODELESScompatibility handling.
Usage
- Put the built JAR into your client
modsdirectory. - Launch the game and adjust
config/windowfix-client.tomlas 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.
FAQ
How to install WindowFix?
Install Fabric for your Minecraft version, download WindowFix for the same version and loader, put the file into the mods folder and launch the game with the loader profile.
Which Minecraft versions does WindowFix support?
WindowFix has builds for Minecraft 1.20–26.3.
Is WindowFix needed on the server?
Client only — no need to install it on the server
Similar mods
All utility mods →
More mods by this author
Bacterium↓ 58.5K