CurseForge · Minecraft mod
WayFix
Fixes multiple issues regarding Wayland compatibility for Minecraft.
Quick answer
Which WayFix release should I use?
WayFix Forge | 1.17.x [v1.1.1] targets 1.17.1, 1.17 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.
Where it goes
Is WayFix required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does WayFix Forge | 1.17.x [v1.1.1] need?
Forge | 1.17.x [v1.1.1]. Change the file and its required mods may change too.
Install Cloth Config API (Fabric/Forge/NeoForge) first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add WayFix without breaking your instance.
Built for WayFix Forge | 1.17.x [v1.1.1]. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use Forge | 1.17.x [v1.1.1]. It targets 1.17.1, 1.17 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Cloth Config API (Fabric/Forge/NeoForge) first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside Forge | 1.17.x [v1.1.1]. It opens that exact file at the source.
About this project
What does WayFix add?
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.
Project description from CurseForge.
Pick your setup
WayFix by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.11
4 loader builds1.21.10
4 loader builds1.21.9
4 loader builds1.21.8
4 loader builds1.21.7
4 loader builds1.21.6
4 loader builds1.21.5
4 loader builds1.21.4
4 loader builds1.21.3
4 loader builds1.21.2
4 loader builds1.21.1
4 loader builds1.21
4 loader buildsShowing the newest 12 of 35 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
WayFix versions and loaders
Forge | 1.17.x [v1.1.1]
wayfix-1.1.1+1.17.x-forge.jar
21 Feb 2026
Fabric | 1.16-1.18.2 [v1.1.1]
wayfix-1.1.1+1.16-1.18.2-fabric.jar
21 Feb 2026
Forge | 1.19 [v1.1.1]
wayfix-1.1.1+1.19-forge.jar
21 Feb 2026
Fabric | 1.19.3-1.19.4 [v1.1.1]
wayfix-1.1.1+1.19.3-1.19.4-fabric.jar
21 Feb 2026
Neoforge | 1.20.5-1.20.6 [v1.1.1]
wayfix-1.1.1+1.20.5-1.20.6-neoforge.jar
21 Feb 2026
Forge | 1.20-1.20.4 [v1.1.1]
wayfix-1.1.1+1.20-1.20.4-forge.jar
21 Feb 2026
Forge | 1.16.x [v1.1.1]
wayfix-1.1.1+1.16.x-forge.jar
21 Feb 2026
Fabric | 1.20 [v1.1.1]
wayfix-1.1.1+1.20-fabric.jar
21 Feb 2026
Forge | 1.19.1-1.19.2 [v1.1.1]
wayfix-1.1.1+1.19.1-1.19.2-forge.jar
21 Feb 2026
Fabric | 1.19-1.19.2 [v1.1.1]
wayfix-1.1.1+1.19-1.19.2-fabric.jar
21 Feb 2026
Forge | 1.18.x [v1.1.1]
wayfix-1.1.1+1.18.x-forge.jar
21 Feb 2026
Neoforge | 1.21 [v1.1.1]
wayfix-1.1.1+1.21-neoforge.jar
21 Feb 2026
Looking for an older file? The official CurseForge project page is in Resources.