VR Jester API

Играете в Minecraft через Vivecraft или QuestCraft и чувствуете, что моды будто созданы для клавиатуры, а не для VR? Тогда VR Jester API — именно то, что вам нужно. Это библиотека распознавания жестов, которая позволяет разработчикам модов легко добавить поддержку виртуальной реальности, а игрокам — управлять игрой собственным телом, а не кнопками на геймпаде.

По сути, VR Jester API убирает необходимость вручную привязывать кнопки контроллеров к клавишам клавиатуры. Вместо этого вы описываете жест, а API сопоставляет его с нужным действием. Хотите зарядить удар, взмахнуть рукой или сделать замах для способности из мода — всё это становится реальностью.

Что умеет VR Jester API для Minecraft

Библиотека работает как прослойка между вашим VR-оборудованием и логикой мода. Разработчики подключаются к событийной шине (Forge) или регистрируют колбэк-интерфейс (Fabric) и получают уведомления, когда распознан жест. Игроки же получают гибкую систему настройки, где каждый жест описывается в конфиге.

Распознавание жестов любой сложности — от простого взмаха до многосоставных движений.
Привязка жестов к любым клавишам и действиям, включая комбинации вроде «снек + слот хотбара».
Поддержка одиночного нажатия (click) и удержания (hold) для заряжаемых способностей.
Работа с несколькими VR-устройствами: правый и левый контроллер, шлем.
Учёт времени, скорости и направления движения для точного распознавания.

Поддерживаемые версии и загрузчики

VR Jester API ориентирован на актуальные сборки Minecraft с модами. Основные загрузчики — Forge и Fabric, причём для каждого предусмотрен свой способ обработки событий жестов. Для владельцев QuestCraft дополнительно требуется мод Questbind, а пользователям Vivecraft нужно настроить привязку кнопок через меню SteamVR. Версии Minecraft стоит уточнять на странице проекта, так как библиотека развивается вместе с игрой.

Кстати, если не хочется возиться с ручной установкой зависимостей, лаунчер foxygame.net умеет ставить VR Jester API в один клик вместе со всеми нужными библиотеками. А ещё в его каталоге дополнений удобно держать под рукой совместимые версии модов, чтобы ничего не сломалось после очередного обновления.

Как установить VR Jester API

Установка не требует глубоких технических знаний. Главное — не пропустить шаг с зависимостями, иначе мод просто не запустится.

Пошаговая инструкция

Установите необходимые зависимые моды. Questbind нужен только для QuestCraft.
Скачайте VR Jester API и поместите файл в папку mods.
Запустите Minecraft — при инициализации автоматически создадутся конфигурационные файлы.
В VR привяжите кнопку контроллера к «Gesture Listener Trigger» (удобно использовать кнопку захвата).
Для Vivecraft настройте привязку через SteamVR, для QuestCraft — через QuestBind.

Создание и настройка жестов

Есть два пути: использовать команду /gesture или редактировать файл config/gesture_store.json напрямую. Внутри хранилища каждый жест состоит из набора компонентов, описывающих движение.

Параметры компонентов жеста

movement — направление: forward, back, left, right, up, down. Отсчёт идёт от направления взгляда в момент активации триггера.
vrDevice — устройство: RIGHT_CONTROLLER, LEFT_CONTROLLER, HEAD_MOUNTED_DISPLAY. Можно объединять через вертикальную черту для логического «или».
elapsedTime — длительность в миллисекундах. Значение 2000 означает две секунды, что удобно для заряжаемых приёмов.
speed — скорость движения. Для удара подойдёт порог около 1500.0–2000.0.
direction — нормализованный вектор x, y, z. Например, {0.0, 1.0, 0.0} ловит момент, когда рука смотрит вверх.
devicesInProximity — требование близости к другому устройству на заданное число тиков.

Чем сложнее жест, тем труднее его воспроизвести точно, поэтому начинайте с простых движений и постепенно усложняйте. После создания жестов их нужно связать с клавишами в config/VRJesterAPI.cfg, добавив объекты в поле GESTURE_KEY_MAPPINGS. Имена привязок ищите в options.txt, а поле KEY_ACTION определяет, будет это одиночное нажатие или удержание.

Для разработчиков

В Forge вы подписываетесь на событийную шину и обрабатываете GestureEvent, получая имя распознанного жеста через getGestureName(). В Fabric регистрируете колбэк через GestureEventCallback.EVENT. Этого достаточно, чтобы связать жест с любой механикой вашего мода — от активации способности до переключения режимов.

Автор планирует добавить непрерывное распознавание жестов, больше параметров конфигурации и оптимизации. Проект жив, несмотря на паузы в обновлениях, так что стоит следить за новостями.

Итог

VR Jester API — это мост между миром модов Minecraft и виртуальной реальностью. Он даёт разработчикам простой инструмент для VR-поддержки, а игрокам — возможность управлять жестами вместо кнопок. Если вы играете в Vivecraft или QuestCraft и хотите, чтобы тело стало контроллером, скачать VR Jester API стоит уже сегодня. Установите зависимости, настройте пару жестов — и Minecraft в VR заиграет новыми красками.

VR Jester API — жесты в Minecraft VR