WayGL Mod Wiki › FAQ
WayGL Mod FAQ
10 questions players actually ask, answered.
Why do I need WayGL Mod if I'm on Linux?
If you're using a modern Linux desktop with Wayland, Minecraft normally runs through a compatibility layer called Xwayland that can cause graphical glitches, window bugs, and performance issues. WayGL Mod forces the game to run natively on Wayland instead, eliminating these problems.
Does WayGL Mod work on X11 or only Wayland?
WayGL Mod is designed specifically for Wayland systems and automatically detects your platform. If you're using X11, the mod will not interfere with your setup, though it also won't provide any benefit.
My taskbar icon looks broken after installing the mod. How do I fix it?
WayGL Mod includes a feature to preserve your taskbar icon on Wayland. If your icon still appears broken, verify that you've installed the correct LWJGL version (3.3.2) as shown in the installation guide, as older versions may not support proper icon rendering.
What's the difference between Wayland and Xwayland?
Wayland is a modern Linux display protocol that handles graphics natively. Xwayland is a compatibility layer that lets older X11 applications run on Wayland, but it can introduce graphical bugs. WayGL Mod bypasses Xwayland entirely by running Minecraft directly on Wayland.
Do I need to change any game settings after installing WayGL Mod?
No—WayGL Mod automatically detects and switches your platform settings while the game runs, so you don't need to manually edit configuration files or launcher settings beyond updating your LWJGL version.
Will WayGL Mod improve my FPS?
WayGL Mod's primary purpose is to fix graphical glitches and window bugs rather than boost performance, but by eliminating Xwayland overhead, some players may see modest FPS improvements depending on their system.
What graphical glitches does WayGL Mod actually fix?
Common Xwayland bugs include screen tearing, window flickering, input lag, cursor issues, and rendering artifacts. WayGL Mod stops these by running the game natively on Wayland instead of through the compatibility layer.
Is WayGL Mod compatible with other client mods?
Yes, WayGL Mod is a lightweight compatibility mod that works alongside other client mods. It only affects how the game window communicates with your Linux display server, not game mechanics or other mod features.
My Linux system still uses X11. Should I install WayGL Mod anyway?
No—WayGL Mod is designed for Wayland systems and won't help on X11. Installing it on X11 won't cause problems, but it also won't provide any benefit since X11 doesn't have the Xwayland compatibility issues the mod addresses.
How do I know if my Linux system is using Wayland or X11?
Check your system settings or run a command in your terminal to check your display server type. Most modern Linux distributions default to Wayland, but some still use X11 depending on your desktop environment and version.