
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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.0, 1.1, 1.2.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as WaylandFix-1.1.jar — drop this file into the mods folder
- Download size: 11 KB
- Download link checked 27 Aug 2026 — working
These come from our own check of the pack file, not from the source page.