Back to 9Minecraft
Wiki 9Minecraft Wiki 9Minecraft
Waygl Wiki › Guides › Preserve Your Taskbar Icon on Linux

Preserve Your Taskbar Icon on Linux

Why Icons Break on Wayland

When Minecraft runs through Xwayland compatibility mode on modern Linux desktops, the taskbar icon often becomes corrupted, blurry, or fails to display correctly. This happens because the X11 protocol doesn't properly communicate window metadata to Wayland compositors.

How WayGL Keeps Your Icon Clean

By forcing native Wayland rendering, WayGL Mod ensures your window manager receives proper icon data directly. The game window identifies itself correctly to your desktop environment, so the taskbar displays the standard Minecraft icon without distortion.

What to Expect

After installing the mod, your taskbar icon should appear sharp and properly themed. It will match your system's icon style and respond normally to clicks and window previews. The icon won't flicker or disappear when you minimize or restore the window.

This works automatically—simply install the mod and launch the game. No settings to adjust.