Hyprland Input Fix
Java mod listed for Minecraft 1.20. Downloads from the MC Java Mods app on Android.
⬇ Download on CurseForgeThe author built this one for Minecraft 1.20.1 on Forge. On other versions it may install and then do nothing.
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 248andInvalid 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 rangeKeyboardHandler.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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.20.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on CurseForge — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as hyprland-input-fix-1.0.0.jar — drop this file into the mods folder
- Download size: 4 KB
- Download link checked 12 Nov 2026 — working
These come from our own check of the pack file, not from the source page.