Wayland Fix

Mod

Run Minecraft natively using Wayland

Type

Mod

Modrinth Downloads

72,348

Modrinth ID

sENq4ge0

Last Updated

Aug 30, 2026

Description

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.