WayFix

Fixes multiple issues regarding Wayland compatibility for Minecraft.

28.3K Downloads

fabricforgeneoforgequiltoptimizationutility

Configure a Compatible Minecraft Server

About this Mod

WayFix

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.

Available Versions

Fabric | 1.16-1.18.2 [v1.1.1]release

MC 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.2fabric, quilt

February 21, 2026

Forge | 1.16.x [v1.1.1]release

MC 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5forge

February 21, 2026

Forge | 1.17.x [v1.1.1]release

MC 1.17, 1.17.1forge

February 21, 2026

Forge | 1.18.x [v1.1.1]release

MC 1.18, 1.18.1, 1.18.2forge

February 21, 2026

Fabric | 1.19-1.19.2 [v1.1.1]release

MC 1.19, 1.19.1, 1.19.2fabric, quilt

February 21, 2026

How to Install WayFix on Your Client

Install the Mod Loader Locally

Install fabric for your local Minecraft version.

Download the Matching File

Choose the WayFix file for fabric and Minecraft 1.21.11.

Install Mod

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

Compatibility

Mod Loaders

fabricforgeneoforgequilt

Minecraft Versions

1.21.11, 1.21.10, 1.21.9 (+32 more)

Server-side

✗ Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Does WayFix need to be installed on the Minecraft server?

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

Use a file for fabric, forge, neoforge, quilt and your exact Minecraft version. Supported versions include 1.21.11, 1.21.10, 1.21.9. Files for different loaders are not interchangeable.

WayFix 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.