*Note: if you do not use Linux, this mod is not for you*<\/p>\n
“Wayland is a replacement for the X11 window system protocol and architecture with the aim to be easier to develop, extend, and maintain.”<\/p>\n
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.<\/p>\n
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.<\/p>\n
# Requirements<\/p>\n
A Wayland-supported system GLFW installation and the following JVM flag is required:
\n“`
\n-Dorg.lwjgl.glfw.libname=\/usr\/lib\/libglfw.so
\n“`<\/p>\n
To install the proper GLFW on Arch Linux, run:
\n“`sh
\nsudo pacman -S glfw-wayland
\n“`<\/p>\n
# Motivation<\/p>\n
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.<\/p>\n
# Bug Reports<\/p>\n
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.<\/p>\n","protected":false},"excerpt":{"rendered":"
Run Minecraft natively using Wayland<\/p>\n","protected":false},"featured_media":169067,"template":"","meta":{"_minecraft_slug":"wayland-fix","_minecraft_project_id":"sENq4ge0","_minecraft_author":"stackdoubleflow","_minecraft_license":"MIT","_minecraft_downloads":62101,"_minecraft_follows":38,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"wayland-fix.zip","_minecraft_size_bytes":20590,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T04:36:11.285463Z","_minecraft_date_created":"2023-12-07T13:48:31.893717Z","_minecraft_date_modified":"2024-06-18T04:45:10.507604Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wayland-fix","_minecraft_icon_attachment_id":169067,"_minecraft_imported_at":"2026-06-09T20:01:47+00:00","_minecraft_import_hash":"9e050a651ee0d70c00b334efce364114","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,90],"mod_loader":[99],"minecraft_version":[850,851,339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,845,846,847,848,849,59,36,60,93,94,101,102,62,852,853,854,855,856,857,858,859,166,10,11,12,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-169066","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-optimization","mod_loader-fabric","minecraft_version-1-0","minecraft_version-1-1","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-3-1","minecraft_version-1-3-2","minecraft_version-1-4-2","minecraft_version-1-4-4","minecraft_version-1-4-5","minecraft_version-1-4-6","minecraft_version-1-4-7","minecraft_version-1-5-1","minecraft_version-1-5-2","minecraft_version-1-6-1","minecraft_version-1-6-2","minecraft_version-1-6-4","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n