WayKeyFix

Исправляет ошибки "Invalid scancode 248" и "Invalid mouse button 99" на Linux с Hyprland.

Проблема

На Hyprland иногда отправляются фальшивые события отпускания с scancode 248 или кнопкой мыши 99 — либо при переключении рабочих пространств, либо будто бы случайно. Minecraft не знает, что это не настоящий ввод, и пропускает их дальше. Результат: кнопки перестают отвечать, инвентарь зависает, поля поиска JEI не принимают текст, а лог забивается этими ошибками.

Решение

WayKeyFix проверяет каждое событие ввода до того, как его увидит Minecraft, и отбрасывает те, которые не может произвести ни одна настоящая клавиатура или мышь. Больше ничего не меняется.

• Без настроек, просто установите
• Работает только на Wayland. На X11 или Windows ничего не делает
• Только клиентская сторона
• Не трогает игровую логику, поэтому работает с любым модом или модпаком

FAQ

Это сломает мои привязки клавиш?

Нет. Настоящие нажатия клавиш не затрагиваются. Отфильтровываются только невозможные значения.

Нужен ли этот мод на сервере?

Нет. Только клиентская сторона, устанавливайте в локальную папку mods.

Это снижает производительность?

На X11 или Windows вообще ничего не запускается. На Wayland каждое событие проверяется двумя сравнениями целых чисел — доли наносекунды. Вы этого никогда не заметите.

Установка

Поместите jar в папку mods/ вашего инстанса NeoForge 1.21.1. Требуется NeoForge 21.1.233 или новее.

Примечание

Вы всё ещё можете видеть "Invalid scancode 248" в логе. Это сообщение исходит от самого GLFW и логируется до запуска миксина. Сообщение остаётся, но вызываемое им повреждение ввода исчезло.

Лицензия

MIT