WayGL

Forces GLFW to use Wayland on supported systems

172.8K Downloads

fabricneoforgequiltoptimization

Configure a Compatible Minecraft Server

About this Mod

WayGL

Tired of all those pesky X11/Xorg bugs happening because you're using wayland? Well fear no more, I have quite the solution for you.

WayGL will force GLFW to create a wayland window ~~(at the cost of sacrificing your window icon)~~ (NO LONGER AT THE COST OF YOUR ICON!!!) on supported systems (Linux using wayland display server).

WayGL makes use of runtime GLFW platform switching, if your on a supported platform, GLFW will be set to use Wayland. Like this, you don’t have to worry about compiling GLFW specifically for wayland.

Say goodbye to those Xwayland bugs/compatability issues!

1.17.x - 1.18.x - 1.19.x Support tested on LWJGL 3.3.2 compatibility not guaranteed on other versions

LWJGL version can be changed in instance settings in prism launcher

Instance > Edit > Version > LWJGL 3 > Change Version > 3.3.2 > Ok

Icons courtesy of moehreag

Available Versions

1.2.1release

MC 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6fabric

May 9, 2026

1.2.1release

MC 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8neoforge

May 9, 2026

1.2.1release

MC 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8fabric

May 9, 2026

1.2.1release

MC 1.21.9, 1.21.10, 1.21.11neoforge

May 9, 2026

1.2.1release

MC 1.21.9, 1.21.10, 1.21.11fabric

May 9, 2026

How to Install WayGL on Your Client

Install the Mod Loader Locally

Install fabric for your local Minecraft version.

Download the Matching File

Choose the WayGL file for fabric and Minecraft 26.1.2.

Install Mod

Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.

Compatibility

Mod Loaders

fabricneoforgequilt

Minecraft Versions

26.1.2, 26.1.1, 26.1 (+29 more)

Server-side

✗ Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Does WayGL need to be installed on the Minecraft server?

No. Modrinth marks WayGL as unsupported on the server side. Install it only in your local Minecraft mods folder. Your server can remain unchanged unless the mod page lists an additional dependency.

Which version and loader does WayGL require?

Use a file for fabric, neoforge, quilt and your exact Minecraft version. Supported versions include 26.1.2, 26.1.1, 26.1. Files for different loaders are not interchangeable.

WayGL is not working – what should I check?

First check the Minecraft version, loader version and required dependencies. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.