Wiki 9Minecraft Wiki 9Minecraft

WayGL Mod Wiki & Guide

Java EditionModGuides 4FAQ 10Related mods 48

Adds waypoint or navigation markers for easier travel and orientation.

DownloadWayGL Mod

Get the files on 9Minecraft

Contents (4)
  1. Guides
  2. Frequently asked questions
  3. Gallery
  4. You May Also Like

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.

See all 10 WayGL questions ›