Back to mods
WayFix project artwork

CurseForge · Minecraft mod

WayFix

Fixes multiple issues regarding Wayland compatibility for Minecraft.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which WayFix release should I use?

Updated 8 months ago
Latest stable file Forge | 1.17.x [v1.1.1]
Game version 1.17.1, 1.17
Loader Forge

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 1 required mods have matching files

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.

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

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

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

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

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.

122 available setups

Showing 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

104 of 104 releases match

Looking for an older file? The official CurseForge project page is in Resources.