Minecraft Cursor
Заменяет стандартный системный курсор на тематические курсоры из Minecraft.
📌 Требования
- Minecraft 1.20.1 или 1.21.1+
- Для Fabric: Fabric API
✨ Адаптивный курсор
- Курсор автоматически меняется при взаимодействии с элементами интерфейса Minecraft или выполнении действий.
- Активируется через настройки Адаптивный курсор или ручное управление каждым типом курсора.
🔧 Настройка курсоров
- Через Mod Menu (для Fabric)
- Через Настройки → Управление → Настройки мыши… → Настройки курсора…
- Каждый курсор можно включить/отключить. При отключении используется Стандартный курсор.
🎨 Поддержка ресурс-паков
Ресурс-паки позволяют создавать пользовательские курсоры, в том числе анимированные, и определять их параметры.
Подробности в Wiki: https://fishstiz.github.io/minecraft-cursor-wiki/resource-pack/getting-started
Пример реализации:
🚀 Java API
API для разработчиков модов позволяет:
- Создавать новые курсоры.
- Сопоставлять элементы интерфейса с функциями курсора.
- Или объявлять тип курсора внутри элемента.
- Прямое изменение курсора без привязки к элементам.
Может быть опциональной зависимостью. Пример реализации здесь.
Документация: https://fishstiz.github.io/minecraft-cursor-wiki/java-api/introduction
🔗 Совместимость с модами
Моды, изменяющие размеры/позиции GUI, могут вызывать некорректное переключение курсоров. Для проблемных интерфейсов отключите адаптивный курсор в настройках.
Список элементов интерфейса с привязанными курсорами: здесь. Исходный код: GitHub.
Для проверки элементов используйте Инспектор элементов в Настройках отладки. Принципы обнаружения элементов описаны в Wiki.
Особенности совместимости для Fabric
Некоторые моды конфликтуют из-за используемых библиотек (например ImGui). Решения:
- При установке курсора другим модом через GLFW адаптивный курсор отключается.
- Системные курсоры GLFW преобразуются в аналоги Minecraft Cursor.
На Forge/NeoForge эти функции недоступны. Для Fabric модов с ранней загрузкой (например FTB Library) реализованы специальные обработчики.
