Wayland Fix
Wayland Fix lets Minecraft run natively under Wayland on Linux instead of through the XWayland compatibility layer.
What it does
Minecraft normally runs under XWayland on Wayland desktops, which can make the window look blurry and leave per-monitor HiDPI scaling unavailable. The mod switches the game to a native Wayland window, so the display is handled by the compositor directly. It is written for Fabric and used on the client only, so players install it and servers do not need it.
The mod requires a Wayland-supported system and a GLFW build with Wayland support, and a specific JVM flag has to be set to enable the native path. The author wrote it after using the Sway window manager with a HiDPI display, and notes that on Arch Linux a proper GLFW package must be installed first. A community patch to GLFW is an alternative route the author would rather avoid.
The code is open source under the MIT License, and the source and issue tracker are public. Files are published for Fabric only, with 1.1 as the latest file for 1.21, last updated 2024-06-18 and first released 2023-12-03. Build coverage spans 87 release versions, 1.0 – 1.21.
Key features
Native Wayland window
The game window is created through Wayland instead of being routed through XWayland.
Per-monitor HiDPI scaling
Scaling follows each monitor's density, which the XWayland path does not provide.
Sharp text on Wayland
Windows no longer look blurry, because the game renders at the compositor's native resolution.
Requires a GLFW build
A Wayland-capable GLFW library must be present, and a JVM flag enables the native path.
Compatibility
Latest build for each game version and loader.
1.21.x1 of 1 version with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
1.13.x3 of 3 versions with builds
1.12.x3 of 3 versions with builds
1.11.x3 of 3 versions with builds
1.10.x3 of 3 versions with builds
1.9.x4 of 4 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
39 older game versions (1.0 – 1.9) not shown. All files on Modrinth
Use cases
Who it’s for: Linux players running a Wayland session who notice blurry scaling under XWayland. It is a client mod and is not needed on servers.
How it compares
WayGL is also client-side only and open source under the MIT License, but it targets Fabric, NeoForge and Quilt for 1.17 – 26.1.2, so it covers loaders this mod does not. waylandcraft is client-side only, open source under the GNU General Public License v3.0 or later, and published for 26.1.2 only. BlazeSDL is open source under the GNU Lesser General Public License v3.0 or later, client-side only, for Fabric and NeoForge across 26.1 – 26.2.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Wayland Fix | Fabric | 1.0 – 1.21 | Client-side only | 2024-06-18 |
| WayGL | Fabric, NeoForge and Quilt | 1.17 – 26.1.2 | Client-side only | 2026-05-09 |
| waylandcraft | Fabric | 26.1.2 | Client-side only | 2026-09-24 |
| BlazeSDL | Fabric and NeoForge | 26.1 – 26.2 | Client-side only | 2026-08-01 |
Questions
Does Wayland Fix need Fabric API?
Do servers need Wayland Fix installed?
What does a Wayland system need to run the mod?
In the catalog
Wayland Fix is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 15,770 mods support Minecraft 1.21.
Similar mods
What the author says
"Wayland is a replacement for the X11 window system protocol and architecture with the aim to be easier to develop, extend, and maintain." With the increasing popularity of Wayland compositors on Linux, including several desktop environments switching to Wayland by default, application support for Wayland makes the…
Official listing
- Modrinth page
- modrinth.com/mod/wayland-fix
- Owner
- stackdoubleflow
- Published
- 2023-12-03
- Updated on Modrinth
- 2024-06-18
- Facts verified
- 2026-10-15