Hyprland Input Fix

Finally play Minecraft smoothly on Hyprland!

Fix frustrating input bugs that make GUI interactions impossible after switching workspaces on Hyprland (Wayland).

Does This Sound Familiar?

You're playing Minecraft on Linux with Hyprland, you switch to another workspace to check Discord or your browser, then when you come back:

Can't click anything in Minecraft - menus, inventory, buttons all broken
Logs filled with errors: GL ERROR: Invalid scancode 248 and Invalid mouse button 99
The only fix: Press a keyboard key

This mod fixes it completely, no need to move your hand to your keyboard every time you switch workspaces.

What This Mod Does

This lightweight client-side mod sits between Hyprland and Minecraft, catching and filtering out the invalid input events that break your game.

Before Installing:

[Switch workspace -> Return to Minecraft]
X Can't click inventory
X Can't open menus
X Spam of GL errors in console
? Press random keys to "unstick" input

After Installing:

[Switch workspace -> Return to Minecraft]
✓ Everything just works
✓ Click anything immediately
✓ No errors, no workarounds needed

Features

Feature	Description
Fix Mouse Input	Filters invalid mouse button events (button 99 → blocked)
Fix Keyboard Input	Filters invalid scancode events (scancode 248 → blocked)
Zero Config	Install and forget - works automatically
No Performance Hit	Lightweight mixin implementation
Client-Side Only	No server installation needed
Safe & Non-Intrusive	Only blocks invalid events, normal input unaffected

Compatibility


Minecraft	1.20.1
Mod Loader	Forge 47.2.0+
Side	Client Only
Environment	Hyprland on Wayland (Linux)

Works with all modpacks! This mod only touches input validation and is compatible with everything.

Technical Details

Click to expand technical explanation

The Problem

When you switch Hyprland workspaces, the compositor sends "release all keys/buttons" events to prevent stuck inputs. However, it sometimes sends events with invalid GLFW codes:

Mouse button 99 (valid range: 0-7)
Scancode 248 (valid range: 0-200)

Minecraft's GLFW integration doesn't validate these and they corrupt the internal input state, making GUIs unclickable.

The Solution

This mod uses Mixin to inject validation at the start of:

MouseHandler.onPress() - Validates mouse button range
KeyboardHandler.keyPress() - Validates scancode range

Invalid events are cancelled at HEAD before Minecraft processes them, keeping input state clean.

FAQ

Do I need this mod if I don't use Hyprland?

No, but it won't hurt anything. The mod only filters genuinely invalid input codes that would cause errors anyway.

Will this work on other Wayland compositors?

Possibly! If you experience similar issues on Sway, River, or other compositors, give it a try.

Does this affect normal gameplay?

Not at all. Valid inputs pass through unchanged - this only blocks invalid codes that would crash or corrupt input handling.

Can I use this on a server?

No need! This is client-side only. Input handling happens on your computer, not the server.

Will this slow down my game?

No. The validation check is trivial (two integer comparisons) and runs only on input events.