CraftHub
WindowFix

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

27 665 downloads
5 followers

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.

No gallery available for this project.