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.).
About this Mod
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.
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.
Available Versions
How to Install WindowFix on Your Client
Install the Mod Loader Locally
Install fabric for your local Minecraft version.
Download the Matching File
Choose the WindowFix file for fabric and Minecraft 26.2.
Install Mod
Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.2-rc-2, 26.2-rc-1 (+35 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Does WindowFix need to be installed on the Minecraft server?
No. Modrinth marks WindowFix as unsupported on the server side. Install it only in your local Minecraft mods folder. Your server can remain unchanged unless the mod page lists an additional dependency.
Which version and loader does WindowFix require?
Use a file for fabric, forge, neoforge and your exact Minecraft version. Supported versions include 26.2, 26.2-rc-2, 26.2-rc-1. Files for different loaders are not interchangeable.
WindowFix is not working – what should I check?
First check the Minecraft version, loader version and required dependencies. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.
Similar Mods
![[ETF] Entity Texture Features](https://cdn.modrinth.com/data/BVzZfTc1/af683d206d50b05258d865b0d6e4aa2f2cee12f2_96.webp){kind=small}
Minecraft Server for Your Group
WindowFix stays on your client. Host a compatible world for your group.