Auto Minimize on Focus Loss

Auto Minimize on Focus Loss

Auto Minimize on Focus Loss makes Minecraft minimize a fullscreen window when the game loses focus. It is a tiny client-side utility mod for Minecraft versions using the SDL3 window backend.

This project is the SDL-era counterpart to Stop Minimizing on Focus Loss. That older mod disables GLFW/SDL auto-minimization; this mod explicitly enables SDL’s behavior instead.

Behavior

Minecraft switched from GLFW to SDL3 in 26.3-snapshot-4. After Minecraft creates its SDL-backed window, this mod sets SDL’s global fullscreen focus-loss hint to enabled:

SDL_SetHint(SDL_HINT_VIDEO_MINIMIZE_ON_FOCUS_LOSS, "1");

With that value, SDL minimizes fullscreen windows when they lose focus. The hint does not force the game to lose focus, change Minecraft’s pause-on-lost-focus setting, or minimize ordinary windowed windows.

Supported targets

• Fabric: Minecraft 26.3-snapshot-4 and later (26.3-alpha.4 in Fabric Loader’s normalized version format)
• Java 25 or later

Versions before 26.3-snapshot-4 are intentionally unsupported because they use the old GLFW window backend. Use Stop Minimizing on Focus Loss for the opposite behavior on those versions.