WayGL Mod Wiki
WayGL Mod Wiki & Guide
wiki.9minecraft.net/waygl-mod/
Adds waypoint or navigation markers for easier travel and orientation.
Guides
Step-by-step, in-game.
Ensure Automatic Platform Detection WorksHow Automatic Detection Works WayGL Mod checks your system environment when Minecraft launches. It detects whether…Fix Graphical Glitches on Wayland LinuxIdentify Wayland-Related Issues If you're experiencing visual bugs like flickering windows, broken taskbar icons, or…Preserve Your Taskbar Icon on LinuxWhy Icons Break on Wayland When Minecraft runs through Xwayland compatibility mode on modern Linux desktops, the…Stop Common Xwayland Bugs During GameplayCommon Xwayland Problems Players on newer Linux systems often encounter bugs when Minecraft runs through Xwayland:…
Frequently asked questions
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.
Related mods
Other mod wikis on the site.
Wavey Capes Mod
Wawla
Waystones
Waystones Teleport Pets Mod