wayland-fixes

Fix/work around wayland bugs on modern versions. Sibling mod to legacy-lwjgl3.

1.5K Downloads

fabricquiltutility

Rent Server with this Mod

About this Mod

Minecraft & Wayland

Other mods already promise to run the game on wayland natively, yet they also tell you that for example you are going to loose the window icon. This mod doesn't, you won't have to miss out on anything!

This is a sibling mod to legacy-lwjgl3 and more or less does the same things in terms of wayland compatibility, just on very different versions of the game. All sections in its description regarding this also apply to this mod.

If you are running the game inside a sandbox, e.g. by using a launcher packaged as a flatpak, make sure to allow the paths listed below to be accessed for this mod to function correctly!

Accesses Paths & Programs and why

This part is mostly copied from the previously mentioned mod since it also applies here.

Features

Injects a .desktop file and the icon in the correct locations for them to function correctly
Loads & Displays a virtual cursor on in-game screens to support setting the cursor position

Properties

virtual_mouse.export may be passed as true to export the loaded cursor to a cursors directory in the instance folder. It will contain all images contained in the cursor as well as all metadata. It will also create a human-readable metadata file for each image, and a cursor.cursor file in the cursor config format. This file may be used to generate a new X11 cursor out of the images with the xcursorgen program.

Accessed Paths

$HOME/.local/share/applications/com.mojang.minecraft.desktop (write)
$HOME/.local/share/icons/hicolor/apps/{16x16, 32x32}/minecraft.png (write)
$HOME/.local/share/icons/<theme>/cursors/left_ptr (read only)
$HOME/.icons/<theme>/cursors/left_ptr (read only)
/usr/share/icons/<theme>/cursors/left_ptr (read only)

Accessed Programs

xdg-icon-resource (to update the icon system)
gsettings (to query for cursor theme & size)

Credits

KDE visual design group (the fallback cursor file shipped with the mod is from KDE's breeze cursor theme)

Available Versions

1.0.1release

MC 1.20.2, 1.20.3, 1.20.4fabric, quilt

February 8, 2024

1.0.0release

MC 1.20.2, 1.20.3, 1.20.4fabric, quilt

January 3, 2024

How to Install wayland-fixes on Your Server

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.4).

Install Mod

Open the mod browser in the dashboard and search for "wayland-fixes". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricquilt

Minecraft Versions

1.20.4, 1.20.3, 1.20.2

Server-side

✗ Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

wayland-fixes server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.4). You can switch loaders with one click in the panel.

Is wayland-fixes compatible with fabric and quilt?

wayland-fixes officially supports fabric, quilt for Minecraft 1.20.4, 1.20.3, 1.20.2. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with wayland-fixes – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if wayland-fixes consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.