К чёрту! Слишком много клавиш - Keybind Wheel
Исходный код и полное руководство: github.com/teamdemivfxfish-dev/keybind-wheel-wiki
В модпаках клавиши заканчиваются задолго до того, как заканчиваются возможности. Карта на F9, добыча на Numpad 3, а какая-то способность живёт на Right-Ctrl-Shift-G. KeyWheel возвращает вам всю клавиатуру: зажмите одну клавишу (по умолчанию V), откроется сегментированное радиальное колесо, наведите курсор на слот, отпустите клавишу, и оно активирует назначенное сочетание клавиш, как если бы вы нажали его вручную.
Любое сочетание клавиш из любого мода может быть помещено на колесо, включая те, которые никогда не были назначены на физическую клавишу. Мод добавляет ровно одно сочетание клавиш в ваше управление; всё остальное происходит внутри колеса.
Одно колесо для всех назначений
Зажмите клавишу, и колесо откроется в виде сегментированного кольца: центральная ступица, по одному сектору на слот и яркий зелёный клин на секторе, на который указывает курсор, чтобы прицеливание было безошибочным. Наведите мышь на слот, отпустите клавишу, и действие сработает.
- Назначайте любое сочетание клавиш, ванильное или модифицированное, через поиск.
- Определение попадания основано на угле, поэтому прицеливание ощущается одинаково, независимо от размера колеса.
- Колесо закрывается до активации действия, поэтому сочетание клавиш, открывающее собственный экран (карту, книгу заданий), открывается без помех.
Нет клавиши? Не проблема
Это основная причина существования мода. Поместите сочетание клавиш, для которого не осталось свободной клавиши, в слот, а затем активируйте его движением мыши; физическая клавиша не требуется. KeyWheel управляет реальным конвейером ввода клавиш Minecraft, поэтому моды, считывающие необработанное событие клавиши, реагируют корректно, и даже неназначенное действие срабатывает.
- Спасите все действия «(Не назначено)» из переполненного меню управления.
- Идеально подходит для модов на заклинания, квесты и всего, что поставляется с десятью назначениями, которые невозможно разместить.
- Одно колесо вмещает гораздо больше действий, чем клавиатура.
Горячие клавиши для страниц
Слоты находятся на именованных Страницах, между которыми вы переключаетесь прокруткой. Каждая страница имеет своё количество слотов (от 1 до 36, по умолчанию 6) и свои назначения, поэтому одно и то же движение мыши активирует разные действия в зависимости от активной страницы. Можно хранить до 32 страниц.
- Назначьте прямую горячую клавишу любой странице и переходите к ней мгновенно, минуя прокрутку.
- В режиме активации прокручивайте колесо для переключения страниц; в ступице отображается текущая
Страница i/n: имя. - В режиме редактирования доступны поле переименования, стрелки навигации и кнопки добавления или удаления страниц.
Командные слоты
Слот может содержать чат-команду вместо сочетания клавиш. Введите её в командное поле поиска, и она сработает при отпускании клавиши, повторяя ванильный чат: ведущий / выполняет её как команду (например, /home, /spawn), всё остальное отправляется как сообщение в чат. Командные слоты принимают собственное имя и иконку, как и любой другой слот.
Настройте под себя
- Пользовательские иконки: любой слот может использовать иконку предмета или блока через поиск; страницы также могут иметь иконку в ступице.
- Переименование: дайте каждому слоту отображаемое имя, которое читается так, как вы думаете, а не как ключ перевода.
- Динамический размер: прокручивайте колесо в режиме редактирования, чтобы установить от 1 до 36 слотов на страницу; колесо расширяется наружу, сохраняя читаемость меток.
- Передача движения: клавиши W, A, S и D (и бег, где позволяет версия) продолжают работать, пока колесо открыто, поэтому его открытие не обездвиживает вас в бою.
Отключение на сервере
Новинка для серверов: оператор в режиме творчества может отключить любое сочетание клавиш для всех.
- Отключённое назначение снимается с клавиши в памяти на каждом клиенте, скрывается из стандартного экрана управления и удаляется из всех слотов колеса, где оно было.
- Красный означает отключено, зелёный — активно. Включите его обратно в любой момент или просто покиньте сервер, и ваше реальное назначение вернётся; мод никогда не изменяет ваш файл параметров на диске.
- Управление тремя способами: внутриигровой менеджер, команды
/keywheel(list,disable,enable,reload) или вручную отредактированный серверный конфиг, который синхронизируется со всеми клиентами при изменении.
Это серверная функция: сервер повторно проверяет статус оператора и режима творчества при каждом переключении, поэтому модифицированный клиент не сможет ничего отключить.
Управление
Мод добавляет ровно одно сочетание клавиш, которое можно переназначить в стандартном меню управления. Всё остальное происходит внутри колеса.
| Действие | Способ |
|---|---|
| Открыть колесо | Зажмите V (по умолчанию key.keywheel.open) |
| Активировать слот | Удерживая V, наведите курсор на слот и отпустите |
| Переключить страницы | Прокрутите колесо (режим активации) |
| Войти в режим редактирования | Нажмите левой кнопкой мыши в любом месте открытого колеса |
| Назначить слот | В режиме редактирования нажмите левой кнопкой мыши на слот, чтобы открыть поиск |
| Очистить слот | В режиме редактирования нажмите правой кнопкой мыши на слот |
| Изменить количество слотов | Прокрутите колесо в режиме редактирования (от 1 до 36 на страницу) |
| Установить пользовательскую иконку | «Выбрать иконку…», затем найдите любой предмет или блок |
| Завершить редактирование | Нажмите Esc |
Без зависимостей
- Нет обязательных зависимостей. Колесо работает на стороне клиента и функционирует на любом сервере, независимо от того, установлен ли мод на сервере.
- Создан для heavily-modded сборок, где стандартное меню управления перестаёт справляться.
- Функция отключения на сервере — единственная часть, требующая установки мода на каждом клиенте для работы; при его отсутствии она остаётся неактивной и не вызывает ошибок.
Поддерживаемые версии
KeyWheel доступен для широкого диапазона версий Minecraft на обоих основных загрузчиках. Все варианты используют modid keywheel. Minecraft 1.21.1 доступен на обоих загрузчиках.
| Загрузчик | Minecraft | Java |
|---|---|---|
| Forge (основной) | 1.21.1 | 21 |
| NeoForge | 1.21.1 | 21 |
| NeoForge | 1.21.8 | 21 |
| Forge | 1.20.1 | 17 |
| Forge | 1.19.2 | 17 |
| Forge | 1.18.2 | 17 |
| Forge | 1.16.5 | 8 |
Существует также ранний бэкпорт для Forge 1.12.2 для ознакомления. Он предшествует функциям страниц, команд, иконок и отключения на сервере, поэтому поддерживается как устаревшая сборка, а не как актуальный релиз.
Конфигурация
Назначения хранятся на стороне клиента в config/keywheel.json. Мод использует атомарные записи и протокол самовосстановления, поэтому обновление модпака, которое удаляет или заменяет файл, не стирает ваше колесо: резервная копия восстанавливается только при отсутствии или повреждении основного файла, но никогда не перезаписывает корректный пустой файл.