Hotbar Cycle

Hotbar Cycle

Клиентский мод для Fabric, который позволяет прокручивать ряды инвентаря в хотбар с помощью клавиши-модификатора + прокрутки. Вдохновлён Shifty Hotbar от Kir-Antipov (заброшен с 2023 года, последняя доступная версия для 1.20.4) — это самостоятельный мод для смены хотбара для современных версий, а не форк. Планов реализовывать дополнительный функционал из Shifty Hotbar сейчас нет.

Поведение

Удерживайте Left Alt (переназначается) и прокручивайте во время игры (без открытого экрана):

4 ряда инвентаря (хотбар + 3 ряда, всего 36 слотов) вращаются как колесо. Предметы остаются в своих столбцах — слот 0 всегда соответствует крайнему левому столбцу.

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

Minecraft >=1.21.1 до 1.21.4. Только клиент — работает на любом сервере (ванильном или с модами) без необходимости устанавливать мод на сервер.

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

Миксин перехватывает Mouse.onMouseScroll и отправляет 27 пакетов SWAP за один тик прокрутки (9 столбцов × 3 смены рядов), имитируя смену хотбара цифровыми клавишами. Сервер обрабатывает их как обычные взаимодействия с инвентарём.

Удерживайте Alt + прокрутка
  → MouseMixin перехватывает onMouseScroll
  → 27 вызовов clickSlot(SWAP) вращают все ряды
  → ci.cancel() предотвращает ванильный выбор слота

Структура проекта

├── build.gradle                     ← Fabric Loom, зависимости
├── gradle.properties                ← версия MC, маппинги, информация о моде
├── settings.gradle                  ← имя проекта
└── src/main/
    ├── java/com/hotbarcycle/
    │   ├── HotbarCycle.java         ← ClientModInitializer, привязка клавиш
    │   └── mixin/
    │       ├── KeyBindingAccessor.java ← открывает доступ к KeyBinding.boundKey
    │       └── MouseMixin.java         ← перехватывает прокрутку мыши
    └── resources/
        ├── fabric.mod.json          ← метаданные мода
        ├── hotbar-cycle.mixins.json ← конфигурация миксинов
        └── assets/hotbar-cycle/
            └── lang/en_us.json      ← надписи в меню управления

Сборка

./gradlew build

Результат: build/libs/hotbar-cycle-1.0.0.jar

Участие в разработке

Pull requests для новых версий Minecraft приветствуются.

1. Создайте ветку от master с именем mc-<версия> (например, mc-26.2)
2. Обновите minecraft_version и yarn_mappings в gradle.properties
3. Исправьте ошибки компиляции, пересоберите с помощью ./gradlew build
4. Откройте PR обратно в репозиторий Лицензия MIT — форки и порты явно разрешены.