How do I install WayFix?

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. Opens on Modrinth — not every file is mirrored on our own servers.

What Minecraft version does WayFix work with?

The listing gives Minecraft 1.16, 1.16.1, 1.16.2, among others. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›WayFix

ModsJava

WayFix

by NotCoded · on Modrinth

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Mod loader Fabric1 build
Mod loader Forge1 build
Mod loader NeoForge1 build
Mod loader Quilt1 build

Minecraft version

Minecraft 1.21.2–1.21.11Newest

Minecraft 1.21.2–1.21.11Newest

Minecraft 1.21.2–1.21.11Newest

Minecraft 1.21.2–1.21.11Newest

⬇ Download for 1.21.2–1.21.11 · Fabric ⬇ Download for 1.21.2–1.21.11 · Forge ⬇ Download for 1.21.2–1.21.11 · NeoForge ⬇ Download for 1.21.2–1.21.11 · Quilt

I don't know my version or loader

Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.

No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

Open in MC Java Mods Get it on Google Play →

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.

Quick facts

Edition: Minecraft Java
File type: .jar
Minecraft versions listed: 1.16, 1.16.1, 1.16.2
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.

Verified by MCModsHub

Ships as wayfix-1.1.1+1.16-1.18.2-fabric.jar — drop this file into the mods folder
Download size: 44 KB
Download link checked 30 Aug 2026 — working

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.16 Java mods for 1.17 Java mods for 1.18