ScrollFix Wayland

ScrollFix Wayland

Stops the hotbar from skipping every other slot when you scroll the mouse wheel on Linux under Wayland.

The problem

On Wayland desktops or Linux systems Minecraft and Wayland duplicate scroll events causing the hot Bower to jump every other slot.

The fix

When a second scroll event in the same direction arrives within a few milliseconds of the first, it’s treated as a duplicate and dropped. Real scrolling is much slower than that, so the hotbar, inventories, and menus all scroll as normal.

Client-side only, no server install needed
No dependencies
If a future Minecraft update renames the scroll method, i made it where mod does nothing instead of crashing

Is it working?

Check your game log for:

[ScrollFix Wayland] Dropped a duplicate scroll event (fix is working)

Configuration

After the first launch, edit config/scrollfix-wayland.properties:

thresholdMs (default 25): raise it to 40–50 if the hotbar still skips sometimes lower it to ~15 if fast scrolling feels like it drops notches.

Source

Open source (MIT) on GitHub: https://github.com/RayRayBornAgain/scrollfix-wayland

Tested on Bazzite (KDE Plasma, Wayland) useing Prism Launcher. It should be harmless on X11, Windows, and macOS, but you don’t need it there.