QuestBridge

QuestBridge — это клиентский мод для Fabric, который напрямую подключает контроллеры Meta Quest 3 к Minecraft Java Edition, запущенному нативно на самом шлеме. Мод разворачивает локальную веб-страницу WebXR, которая перехватывает ввод с контроллеров и передаёт его в запущенный экземпляр игры через низколатентный WebSocket-сервер, обеспечивая консольный иммерсивный опыт полностью автономно, без ПК. > ### 📖 Ищете полное руководство по установке? > Пошаговую инструкцию, кастомные раскладки контроллеров Amethyst (для игры с ESC/T), а также расширенное решение проблем читайте в нашем полном руководстве по установке на GitHub! --- ### Демонстрационное видео: --- ## Возможности - Поддержка автономного VR - Иммерсивное окружение - Встроенная отдача контроллеров ⭐ - Сохранение настроек --- ## Требования Перед началом убедитесь, что выполнены все следующие требования: - Meta Quest 3 (протестировано) | Quest 3S и 2 (поддерживаются). - Режим разработчика включён на шлеме. Инструкцию по настройке смотрите в официальном руководстве Meta для разработчиков. - «Seamless Multitasking» включён на шлеме. - Установлен лаунчер Amethyst-Android. - В папке mods установлены Controlify и Fabric API. --- ## Как использовать 1. Запустите Minecraft: откройте Amethyst и запустите игру с настроенным профилем Fabric. 2. Откройте браузер Quest: откройте нативный браузер Meta Quest и перейдите по адресу: > http://localhost:7373 --- ## Решение проблем | Проблема | Возможная причина | Решение | | :--- | :--- | :--- | | Ввод не регистрируется | Отключён Seamless Multitasking | Убедитесь, что Seamless Multitasking включён в экспериментальных настройках Quest. | | Контроллеры отключаются | Смена фокуса | Убедитесь, что вы не направляете контроллеры прямо на панель Minecraft. | | Страница не загружается | Конфликт портов сервера или мод не запущен | Проверьте, что Minecraft полностью загрузил Amethyst, и что браузер открыт по адресу http://localhost:7373. | | Режим сквозного обзора чёрный | Блокировка разрешений или проблема с типом сессии | Убедитесь, что вы выбрали карточку Pass до нажатия Enter VR, чтобы система корректно инициализировала сессию immersive-ar. | | Нет отдачи | Интенсивность установлена на 0% | Установите ползунок Haptic Intensity на значение больше 0% в веб-интерфейсе. | --- ## Лицензия Этот проект распространяется под лицензией MIT — подробности смотрите в файле LICENSE.