Wayland Fix

Run Minecraft natively using Wayland

71.8K Downloads

fabricoptimization

Configure a Compatible Minecraft Server

About this Mod

Note: if you do not use Linux, this mod is not for you

"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 Linux desktop experience all the better.

While Minecraft does run under XWayland, features like per-monitor HiDPI scaling do not function. If you experience problems related to XWayland, this mod is for you.

Requirements

A Wayland-supported system GLFW installation and the following JVM flag is required:

-Dorg.lwjgl.glfw.libname=/usr/lib/libglfw.so

To install the proper GLFW on Arch Linux, run:

sudo pacman -S glfw-wayland

Motivation

I wrote this mod after using Sway WM with a HiDPI display. All XWayland applications look blurry, so it is not an option. The community solution was to patch the system glfw, but I'd rather not do that.

Bug Reports

If you continue to experience problems with Minecraft on Wayland after installing this mod, file a bug report on the issue tracker if it hasn't already been reported.

Available Versions

Wayland Fix 1.1release

MC 1.0, 1.1, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3.1, 1.3.2, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5.1, 1.5.2, 1.6.1, 1.6.2, 1.6.4, 1.7.2, 1.7.3, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9, 1.7.10, 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21fabric

June 18, 2024

Wayland Fix 1.0release

MC 1.18.2fabric

December 3, 2023

How to Install Wayland Fix on Your Client

Install the Mod Loader Locally

Install fabric for your local Minecraft version.

Download the Matching File

Choose the Wayland Fix file for fabric and Minecraft 1.21.

Install Mod

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

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21, 1.20.6, 1.20.5 (+84 more)

Server-side

✗ Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Does Wayland Fix need to be installed on the Minecraft server?

No. Modrinth marks Wayland Fix 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 Wayland Fix require?

Use a file for fabric and your exact Minecraft version. Supported versions include 1.21, 1.20.6, 1.20.5. Files for different loaders are not interchangeable.

Wayland Fix 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.