keybindjs - управление клавишами через KubeJS

keybindjs - мод-расширение для популярного инструмента KubeJS, которое даёт создателям сборок модов полный контроль над привязкой клавиш (key bindings) в Minecraft. Если вы когда-нибудь сталкивались с конфликтами клавиш в сборке - когда несколько модов пытаются использовать одну и ту же кнопку - то знаете, как это бесит. Ванильный Майнкрафт позволяет менять только базовые клавиши, а в сборках с десятками модов настройка превращается в ад. keybindjs решает эту проблему раз и навсегда.

Зачем это нужно

В любой крупной сборке модов рано или поздно возникает необходимость:

• переназначить стандартную клавишу мода, чтобы избежать конфликта;
• убрать клавишу, которая мешает (например, случайное нажатие прыжка в режиме полёта);
• переместить группу клавиш в другую категорию в меню управления;
• добавить собственную комбинацию для кастомных механик.

Без keybindjs всё это приходится делать через правку конфигов модов или с помощью специальных модов вроде Keybinds Galore. Но ни один из них не даёт гибкости скриптового подхода. keybindjs интегрируется напрямую с KubeJS, а значит - вы пишете логику на JavaScript, и она работает сразу.

Как это работает

Всё управление происходит через событие KeyBindEvents.modify. Внутри вы можете:

• изменить клавишу (modifyKey), указав её GLFM-код;
• сменить модификатор (modifyModifier) - ALT, SHIFT, CTRL или NONE;
• перенести в другую категорию (modifyCategory) - например, из "Curios" в "Misc";
• полностью удалить (remove) любую привязку, даже ванильную.

Пример из документации:

KeyBindEvents.modify(event => {
    event.modifyKey('key.curios.open.desc', GLFM.GLFM_KEY_X)
    event.modifyModifier('key.curios.open.desc', KeyModifier.ALT)
    event.modifyCategory('key.curios.open.desc', 'key.categories.misc')
    
    event.remove('key.jump')
})

Здесь клавиша открытия меню Curios переназначается на ALT+X и перемещается в категорию "Разное" (Misc), а клавиша прыжка - удаляется. Комментарии в коде переводить не нужно, всё и так понятно.

Важно знать

Не устанавливайте этот мод на сервер. keybindjs работает только на клиенте, так как управление клавишами - локальная фича Minecraft. Если закинуть его на сервер, он просто не будет ничего делать, но может вызвать ошибки совместимости. Ставьте только в папку mods клиента.

Совместимость

Мод требует KubeJS (обычно для Forge, но есть и версии под Fabric). Работает на Minecraft 1.18-1.21 (точные версии смотрите на странице загрузки). Названия модов и их привязок берутся из их ресурсов - вы можете узнать ID любой клавиши через команду /keybindjs list или по документации конкретного мода.

Для кого этот мод

Если вы собираете свою сборку модов - keybindjs обязателен. Он позволяет избежать типичных головных болей с настройкой управления и делает сборку дружелюбной для игрока. При этом всё настраивается через KubeJS-скрипты, а не через тяжёлые моды-конфигураторы.

Скачайте keybindjs и забудьте о конфликтах клавиш раз и навсегда. А если вам нужно больше фич - обратите внимание на другие аддоны KubeJS, например, KubeJS Create или KubeJS Thermal.

Примечание: Все внутренние ссылки (если есть) оставлены без изменений. Внешние ссылки и реклама удалены.