KeybindsGalore (HVB007)

KeybindsGalore

Открывает меню выбора, когда на одну клавишу назначено несколько действий, чтобы вы сами выбрали, какое из них сработает.

По умолчанию Minecraft выбирает одно назначение и молча игнорирует остальные. Обычно вы узнаёте об этом, впечатавшись в стену, потому что какой-то мод украл Space. KeybindsGalore перехватывает конфликт вместо того, чтобы угадывать.

Доступно как для Fabric, так и для NeoForge.

Возможности

Выбор при конфликте — нажмите спорную клавишу, и откроется меню со списком всех действий, назначенных на неё. Укажите нужное, а остальные будут отпущены для этого нажатия.

Круговое меню и меню-список — по умолчанию используется круг. Также доступно обычное меню-список, если вам привычнее что-то традиционное; переключается в конфиге.

Круг с GPU-рендерингом — сектора рисуются через отложенный конвейер отрисовки GUI Minecraft с помощью собственного RingRenderer, поэтому круг корректно смешивается с остальным интерфейсом. Внешняя библиотека рендеринга не встроена и не требуется.

Система приоритетов — для клавиш, о которых вы никогда не хотите получать вопрос. Назначьте Space всегда прыгать, и он будет прыгать, даже если на нём висит что-то ещё.

Захват приоритета клавишей K — нажмите K, нажмите клавишу, которую хотите закрепить, выберите действие. Без редактирования файлов.

Обнаружение конфликтов в реальном времени — конфликты пересканируются при запуске, при входе в мир, при закрытии ванильного экрана «Управление», при сохранении конфига и при изменении приоритетов.

Фильтры категорий — исключайте целые категории из обнаружения, если никогда не хотите получать о них вопрос.

Поддержка мыши — работает с конфликтующими назначениями кнопок мыши, а не только клавиатуры.

Настройка в игре — полноценный экран настроек через Cloth Config, со слайдерами, полями цвета с альфой и подсказками у каждого пункта.

Публичный API — небольшой версионируемый API позволяет другим модам регистрировать свои действия, чтобы их назначения участвовали в обнаружении конфликтов.

Что нового в 1.8.0

Теперь доступно на NeoForge, а также на Fabric. Сборка 26.2 для NeoForge — это тот же мод на загрузчике NeoForge: те же меню, та же система приоритетов, тот же экран конфига. Ему не нужны ни Fabric Loader, ни Fabric API, ни ModMenu.

Поддержка Minecraft 26.3 на Fabric. Сборка 26.3 портирует мод на 26.3, где клиент перешёл с GLFW на SDL3, а рендеринг — на новый API RenderPipeline.

Экран конфига работает на 26.2. Предыдущая сборка 26.2 вышла с известной проблемой, из-за которой экран конфига не работал, потому что доступная на тот момент версия Cloth Config ссылалась на класс Minecraft, которого больше не существует. Это исправлено.

Помимо этого, в этом релизе переработано обнаружение конфликтов и отрисовка круга:

• Градация секторов — каждый сектор затеняется от более светлого внутреннего края к цвету внешнего, со слайдером интенсивности. Рисуется бесплатно, так как рендерер и так принимал отдельные цвета для внутреннего и внешнего края.
• Анимация открытия — короткая сглаженная анимация при появлении круга, со слайдером длительности. Поставьте 0 для мгновенного меню. Подписи появляются после её завершения.
• Геометрия круга наконец работает — масштаб, отступ и размер зоны отмены теперь задействованы. Они были в экране конфига, но молча игнорировались.
• Расширение выбранного сектора теперь применяется при наведении на сектор.
• Слайдер силы затемнения для фона круга.
• Тень текста подписей следует своей настройке, а не включена постоянно.
• Исправлено размещение подписей — подписи располагаются радиально и ограничиваются экраном. Раньше подпись на нижнем секторе выталкивалась вверх в круг.
• Исправлена плавность круга — уменьшение количества вершин теперь равномерно ухудшает весь круг, а не делает гранёным только круг отмены.
• Надёжный захват клавишей K — прямой путь по фронту сигнала работает параллельно с прежним на основе опроса, поэтому первое нажатие больше не проглатывается.
• Отдельная вкладка настроек меню-списка — цвета и прозрачность меню-списка были на вкладке круга, где не действовали и выглядели сломанными.
• Типизированная конфигурация — конфиг читается и записывается через проверенный снимок с атомарной заменой файла, а не через рефлексию по статическим полям.
• Устаревшие опции удаляются автоматически — девять настроек, которые не читались, были избыточными или остались от 1.21.x, вырезаются из вашего файла конфига при загрузке, а замена отмечается в файле. Обновление больше не выдаёт сообщения об ошибках из-за неизвестных ключей.

Требования

Выберите строку, соответствующую вашему загрузчику.

Fabric

• Minecraft 26.2 или 26.3
• Fabric Loader >= 0.19.3
• Fabric API >= 0.152.1+26.2
• Cloth Config >= 26.2.155
• ModMenu (опционально, только для экрана настроек)

NeoForge

• Minecraft 26.2
• NeoForge >= 26.2.0.88
• Cloth Config >= 26.2.155

Java 25 или новее в обоих случаях. Только клиентская сторона: не для выделенных серверов.

Настройка

Экран настроек в игре — рекомендуемый способ настройки мода, и он редактирует тот же файл config/keybindsgalore.properties, который можно править вручную, так что можно использовать любой из них. На Fabric экран появляется в ModMenu; на NeoForge он появляется в списке модов.

Четыре вкладки:

• General — логирование отладки, длительность импульса, обход атаки, затемнение фона.
• Behaviour — круговое или списочное меню, предупреждения о конфликтах, фильтры категорий, приоритетные действия.
• Visual (Pie Menu) — геометрия, цвета, градиент, анимация, подписи.
• Visual (List Menu) — цвета и прозрачность списка. Влияют только на списочное меню.

Цвета вводятся как шестнадцатеричные значения ARGB, например C0606060. В выпуске Cloth Config, который использует этот мод, есть поле для hex, а не виджет ползунка RGB.

Установка приоритета вручную выглядит так:

PRIORITY_KEYBINDS=[key.jump:key.keyboard.space]
PRIORITY_CATEGORIES=[Movement]

Приоритет действия всегда важнее приоритета категории.

Известные ограничения

• Круговое меню управляется только мышью. Навигации с клавиатуры пока нет, и это самый большой пробел в доступности.
• Длинные названия действий на соседних секторах могут перекрываться. Подписи обрезаются так, чтобы их никогда не срезал край экрана, но переносить их нельзя.
• Круговое меню намеренно не ставит игру на паузу, чтобы вы видели мир за ним.
• Ввод цвета — это текстовые поля для hex, а не палитры.
• Привязки, изменённые другим модом во время работы, не обнаруживаются. Повторное сканирование вызывают только перечисленные триггеры.

История и благодарности

• Оригинальный проект и оригинальный автор: Cael
• KeybindsGalore Plus: AV306
• Обновления и переписывания для 1.20.x, 1.21.x и 26.x: HVB007
• Участники, перечисленные в метаданных мода и репозитории GitHub

Заявление об ИИ

Части кода этого мода были написаны с помощью инструментов ИИ. Весь сгенерированный ИИ код был проверен, протестирован и подтверждён на работоспособность разработчиком.

Ссылки

• Сообщить о проблеме
• Посмотреть исходный код