WindowFix

WindowFix

WindowFix 解决了 Windows 系统下 Minecraft 的一个特定问题：与标题栏系统菜单交互（右键单击标题栏、最小化、还原等操作）可能导致游戏循环挂起或卡顿。

运行环境

• Windows 客户端

修复模式

WindowFix 通过客户端配置提供两种模式：

1. 禁用原生系统菜单（稳定性优先）
   完全阻止标题栏右键系统菜单，以避免进入 Win32 菜单模态循环。

2. 原生兼容模式
   保留原生右键系统菜单，并启用 MNS_MODELESS 以减少阻塞的可能性。

配置

配置文件在首次启动后生成：

config/windowfix-client.toml

示例：

blockTitleBarSystemMenu = false
keepActiveDuringSystemMenu = true

修改配置值后需要重启游戏。

• blockTitleBarSystemMenu
  • true：禁用标题栏右键原生系统菜单。
  • false：保留原生系统菜单行为。
• keepActiveDuringSystemMenu
  • 仅在 blockTitleBarSystemMenu = false 时生效。
  • true：在系统菜单操作期间抑制瞬时的焦点丢失消息，以减少短暂卡顿。
  • false：保留默认焦点行为。

使用方法

1. 将构建的 JAR 文件放入客户端的 mods 目录。
2. 启动游戏，并根据需要调整 config/windowfix-client.toml 文件。

日志关键字

在 latest.log 中搜索以下内容：

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

已知限制

• 仅适用于 Windows 系统。
• 在原生兼容模式下，根据系统窗口管理行为的不同，仍可能发生短暂卡顿。