Adaptive Keybinds

Big modpacks run out of keys. Adaptive Keybinds lets you bind several actions to the same key and choose which one is active right in the game: with a quick priority wheel, automatically by context, or by switching between profiles. No more digging through the Controls menu every time you want to change what a key does.

FEATURES

- Priority wheel: hold the mod key and press any key that has two or more actions bound to it, and a wheel with all of those actions opens on the spot.
- Quick swap: pressing the same key again cycles to the next action, so Mod Key + Key, Key, Key switches in a blink.
- Context rules: let the mod pick the action for you. For example, "F attacks when I hold a sword and uses an item when I hold a shovel". Conditions: item in main hand, item in off hand, dimension, riding, underwater, gliding with elytra. Wildcards are supported (minecraft:*_sword, *_pickaxe).
- Profiles: keep separate sets of choices and rules (building, combat, mining...) and switch between them with a key or from the Profiles screen.
- Reset in game: choose the "All actions" sector in the wheel or press Del to bring a key back to the default behavior.
- Export / Import: copy your profiles, rules and wheel appearance to the clipboard or a file to back them up or share them with friends or your modpack players.
- Mod key priority: while the mod key (Right Ctrl by default) is held, other mods' keybinds that use the same modifier are suppressed. Left Ctrl keeps working normally, so combinations like Ctrl+T from other mods are still available. Rebind the mod key to Shift or Alt and the priority moves with it.
- Customizable wheel: colors, size, center size, gap, opacity, animations, text shadow, hint and more, with a live preview.
- Works with other mods: actions registered by other mods through the standard keybind system show up in the wheel just like vanilla ones.
- Safe by default: until you pick an action or create a rule, a key behaves exactly like vanilla, so installing the mod changes nothing on its own.
- Client-side only: no need to install it on servers.
- English and Russian translations.

HOW TO USE

1. Open Options > Controls > Key Binds and assign several actions to the same key. The game will highlight the conflict in red, which is fine here.
2. In a world, hold the mod key (Right Ctrl by default) and press that key. The wheel opens.
3. Pick an action by moving the mouse, scrolling the mouse wheel, or pressing the key again.
4. Release the mod key (or click / press Enter) to apply. Press Del to reset the key to all actions. Press Esc to cancel.
5. From now on, only the chosen action works on that key, and the others are suppressed until you change the selection.

CONTEXT RULES AND PROFILES

Open the Profiles & Rules screen from Mods > Adaptive Keybinds > Config > Options, or bind the "Profiles & rules" key in the Controls menu.

- To add a rule, pick a key, one of its actions, a condition (and a value such as minecraft:*_sword), then press Add rule. Rules are checked from top to bottom and the first match wins. Press "Fill" to copy the item in your hand or your current dimension into the value field.
- Priority order for each key: first matching rule, then your manual choice from the wheel, then vanilla behavior (all actions at once).
- If you pick an action in the wheel while a rule is active, the choice is temporary and lasts until the context changes.
- Use the arrows next to the profile name or the Next / Previous profile keys to switch profiles. Each profile has its own choices and rules.

EXPORT AND IMPORT

Press Export in the Profiles screen to copy everything to the clipboard and save it to config/adaptivekeybinds-export.json. Press Import to read it back (from the clipboard first, then from the file). Imported profiles are added next to your own and never overwrite them. The imported wheel appearance replaces your current one.

CONTROLS

All keys can be changed in Options > Controls under the "Adaptive Keybinds" category:
- Open priority wheel (hold + key): Right Ctrl by default
- Next profile / Previous profile: unbound by default
- Profiles & rules: unbound by default

COMPATIBILITY AND KNOWN LIMITATIONS

- Requires NeoForge for Minecraft 1.21.1.
- Works with actions registered through the standard KeyMapping system. Mods that read keyboard input directly with their own handlers cannot always be detected or suppressed.
- Keybinds that already use a modifier (Shift/Alt/Ctrl + key) and menu-only keybinds are currently not shown in the wheel.
- Imported profiles refer to actions by name. Actions from mods you do not have installed are simply ignored.
- If another mod already uses Right Ctrl, change the mod key in the Controls menu.

Your data is stored in config/adaptivekeybinds-profiles.json. To start over, delete this file and restart the game.

This is an early release. If you run into a bug or a conflict with another mod, please leave a comment and include the mod name and your latest.log.

FAQ

Does it work on servers?
It is client-side only, so you can use it on any server without installing anything server-side. Whether a server allows a specific action is up to the server and the other mods as usual.

Can I use it in my modpack?
Yes, feel free to include it in any modpack. The mod is released under the MIT license.

Adaptive Keybinds

В больших сборках клавиши заканчиваются. Adaptive Keybinds позволяет назначать несколько действий на одну клавишу и выбирать, какое из них активно, прямо в игре: через быстрое колесо приоритета, автоматически по контексту или переключением профилей. Больше не нужно каждый раз лезть в меню управления, чтобы поменять действие клавиши.

ВОЗМОЖНОСТИ

- Колесо приоритета: зажмите клавишу мода и нажмите любую клавишу, на которую назначено два или больше действий, и сразу откроется колесо со всеми этими действиями.
- Быстрое переключение: повторное нажатие той же клавиши переключает на следующее действие, поэтому Клавиша мода + Клавиша, Клавиша, Клавиша переключает мгновенно.
- Правила по контексту: пусть мод выбирает действие за вас. Например: «F атакует, когда в руке меч, и использует предмет, когда в руке лопата». Условия: предмет в основной руке, предмет во второй руке, измерение, езда верхом, под водой, полёт на элитрах. Поддерживаются маски (minecraft:*_sword, *_pickaxe).
- Профили: храните отдельные наборы выбора и правил (строительство, бой, шахта...) и переключайтесь между ними клавишей или в окне профилей.
- Сброс в игре: выберите в колесе сектор «Все действия» или нажмите Del, чтобы вернуть клавишу к поведению по умолчанию.
- Экспорт / импорт: копируйте профили, правила и внешний вид колеса в буфер обмена или файл, чтобы сделать резервную копию или поделиться с друзьями и игроками вашей сборки.
- Приоритет клавиши мода: пока зажата клавиша мода (по умолчанию правый Ctrl), привязки других модов с тем же модификатором подавляются. Левый Ctrl продолжает работать как обычно, поэтому комбинации вроде Ctrl+T из других модов остаются доступными. Переназначьте клавишу мода на Shift или Alt, и приоритет перейдёт вместе с ней.
- Настраиваемое колесо: цвета, размер, размер центра, зазор, прозрачность, анимации, тень текста, подсказка и другое, с предпросмотром вживую.
- Работает с другими модами: действия, зарегистрированные другими модами через стандартную систему клавиш, появляются в колесе так же, как ванильные.
- Безопасно по умолчанию: пока вы не выбрали действие или не создали правило, клавиша работает точно как в ванильной игре, поэтому сама установка мода ничего не меняет.
- Только клиентская сторона: на серверы ставить не нужно.
- Английский и русский переводы.

КАК ПОЛЬЗОВАТЬСЯ

1. Откройте Options > Controls > Key Binds и назначьте несколько действий на одну клавишу. Игра подсветит конфликт красным, здесь это нормально.
2. В мире зажмите клавишу мода (по умолчанию правый Ctrl) и нажмите эту клавишу. Откроется колесо.
3. Выберите действие: двигайте мышь, крутите колёсико или нажмите клавишу ещё раз.
4. Отпустите клавишу мода (или щёлкните / нажмите Enter), чтобы применить. Нажмите Del, чтобы сбросить клавишу до «Все действия». Esc отменяет.
5. С этого момента на клавише работает только выбранное действие, остальные подавляются, пока вы не смените выбор.

ПРАВИЛА ПО КОНТЕКСТУ И ПРОФИЛИ

Окно «Профили и правила» открывается через Mods > Adaptive Keybinds > Config > Опции, либо назначьте клавишу «Профили и правила» в меню управления.

- Чтобы добавить правило, выберите клавишу, одно из её действий, условие (и значение, например minecraft:*_sword), затем нажмите «Добавить правило». Правила проверяются сверху вниз, срабатывает первое подходящее. Кнопка «Взять» подставляет в поле значения предмет из вашей руки или текущее измерение.
- Порядок приоритета для каждой клавиши: первое подходящее правило, затем ваш ручной выбор из колеса, затем ванильное поведение (все действия сразу).
- Если вы выберете действие в колесе, пока активно правило, выбор будет временным и продлится до смены контекста.
- Используйте стрелки рядом с названием профиля или клавиши «Следующий / Предыдущий профиль» для смены профиля. У каждого профиля свои выборы и правила.

ЭКСПОРТ И ИМПОРТ

Нажмите «Экспорт» в окне профилей, чтобы скопировать всё в буфер обмена и сохранить в config/adaptivekeybinds-export.json. Нажмите «Импорт», чтобы прочитать данные обратно (сначала из буфера обмена, затем из файла). Импортированные профили добавляются рядом с вашими и никогда не перезаписывают их. Импортированный внешний вид колеса заменяет текущий.

УПРАВЛЕНИЕ

Все клавиши можно изменить в Options > Controls в категории "Adaptive Keybinds":
- Открыть колесо приоритета (зажать + клавиша): по умолчанию правый Ctrl
- Следующий профиль / Предыдущий профиль: по умолчанию не назначены
- Профили и правила: по умолчанию не назначена

СОВМЕСТИМОСТЬ И ИЗВЕСТНЫЕ ОГРАНИЧЕНИЯ

- Требуется NeoForge для Minecraft 1.21.1.
- Работает с действиями, зарегистрированными через стандартную систему KeyMapping. Моды, которые читают ввод с клавиатуры напрямую своими обработчиками, не всегда удаётся обнаружить и подавить.
- Клавиши, которые уже используют модификатор (Shift/Alt/Ctrl + клавиша), и клавиши только для меню пока не показываются в колесе.
- Импортированные профили ссылаются на действия по названиям. Действия из модов, которых у вас нет, просто игнорируются.
- Если правый Ctrl уже занят другим модом, поменяйте клавишу мода в меню управления.

Ваши данные хранятся в config/adaptivekeybinds-profiles.json. Чтобы начать с нуля, удалите этот файл и перезапустите игру.

Это ранний релиз. Если вы столкнулись с багом или конфликтом с другим модом, оставьте комментарий, указав название мода и ваш latest.log.

FAQ

Работает ли на серверах?
Мод только клиентский, поэтому его можно использовать на любом сервере, ничего не устанавливая на серверной стороне. Разрешено ли конкретное действие, решает сервер и другие моды, как обычно.

Можно ли использовать его в моей сборке?
Да, смело включайте его в любые сборки. Мод распространяется под лицензией MIT.