Skip to content

WayFix

Fixes multiple issues regarding Wayland compatibility for Minecraft.

FabricNeoForgeForgeQuilt
Loaders
FabricNeoForgeForgeQuilt
Downloads on Modrinth
31.5K
Followers on Modrinth
45
versions
105
Updated
February 21, 2026Feb 21
Published
in 2024

At a glance

Runs on Fabric, NeoForge, Forge and Quilt
For Minecraft 1.16–1.21.11
Client only — no need to install it on the server
Latest version — 1.1.1+1.16-1.18.2-fabric from February 21, 2026
Requires Cloth Config API
License LGPL-2.1-only — free
Where it's needed
In gamerequiredOn servernot needed

Install in the game only; not needed on the server

Game versions1.16–1.21.11
WayFix Logo

WayFix

Supports minecraft versions from 1.16 Cloth Config API

Fixes multiple issues regarding Wayland compatibility for Minecraft.

Recommended to be used with glfw-wayland.
With the Cursor Fix.
And kdotool *(only if on KDE Plasma)*.

Features

  • Auto Scale GUI

    • Auto-scales the GUI scale depending on your display's scaling. (e.g. 2 GUI Scale on 1920x1080 at 100% → 4 GUI Scale on 3840x2160 at 200%)
  • Inject Minecraft Icon at Startup

    • Injects the Minecraft Icon at Startup instead of defaulting to the normal Wayland icon.
  • Key Modifiers Fix

    • Fixes issues where keyboard combinations like 'CTRL + A' or 'CTRL + C' are sent as characters in chat instead of being recognized as key combinations.
  • Fullscreen

    • Select Monitor
    • Select which monitor you want to fullscreen Minecraft to.

Note

By default Minecraft sometimes full-screens on the wrong monitor due to Wayland window limitations (unable to get X and Y position). This is automatically fixed only on KDE Plasma without specifying the monitor by installing kdotool.

FAQ

How to install WayFix?

Install Fabric for your Minecraft version, download WayFix for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does WayFix support?

WayFix has builds for Minecraft 1.16–1.21.11.

Is WayFix needed on the server?

Client only — no need to install it on the server

License and source
GNU Lesser General Public License v2.1 onlyfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More