Vivecraft Spigot Extension, или VSE, — серверный плагин-компаньон для Vivecraft, VR-мода Java-версии Minecraft. Он добавляет обработку VR-возможностей на серверах Spigot, Paper, Folia и Purpur. JAR устанавливается на сервер: клиентская сторона для самого плагина не поддерживается. Лицензия проекта — LGPL-3.0-or-later.
VSE не превращает обычный клиент в VR-клиент и не заменяет Vivecraft. Он обрабатывает данные Vivecraft, корректирует отдельные взаимодействия и предоставляет метаданные и API. Категории проекта — библиотека и утилита.
Обычный сервер Minecraft не обязан понимать все особенности положения головы, рук и тела игрока в VR. Vivecraft Spigot Extension создаёт серверный слой поддержки: он принимает связанные данные, делает движения видимыми другим пользователям Vivecraft и адаптирует ряд игровых действий.
Плагин применим на смешанных VR-серверах, специализированных Vivecraft-проектах, сетях за прокси и в сборках, где сторонним дополнениям нужны сведения о VR-состоянии. Само наличие VSE не добавляет клиенту виртуальную реальность.
Подтверждена передача движений головы, рук и ног между игроками Vivecraft. Это позволяет VR-пользователям видеть более полное положение тела друг друга, чем стандартная модель Minecraft.
Функция зависит от данных, которые предоставляет Vivecraft. Исходная основа не обещает, что обычные клиенты будут отображать все VR-движения в том же виде, и не описывает визуальные особенности для каждой версии. Поэтому проверять результат нужно с реальными клиентами Vivecraft, соответствующими выбранной версии сервера и плагина.
Для проверки достаточно подключить двух VR-игроков, сопоставить движения контроллеров и головы, затем повторить тест после перехода между мирами и переподключения.
VSE заявляет поддержку стрельбы из лука двумя руками. Также плагин исправляет обработку снарядов и выброшенных предметов от VR-игроков. Эти функции нужны потому, что положение рук и направление действия в Vivecraft могут отличаться от стандартного поведения клиента.
Также подтверждены попадания стрелой в голову, двойное владение, ускоренное разрушение блоков, инструменты Climbey и блокирование в масштабе комнаты. Часть функций переключается, а попадания в голову настраиваются; конкретные ключи в основе не приведены.
Разработчик указывает две отдельные корректировки. Радиус взрыва крипера для VR-игроков может уменьшаться с 3 до 1,75 метра. Радиус ближней атаки мобов для них может сокращаться на 0,4 метра. Обе функции описаны как настраиваемые.
Корректировки относятся к VR-контексту, а не ко всем игрокам. Их нужно проверить вместе с выбранной сложностью, защитными и боевыми плагинами.
VSE позволяет назначать отдельные группы разрешений VR-игрокам. Это даёт возможность различать пользователей Vivecraft и остальных участников средствами серверной системы прав.
Также заявлена опция ограничения сервера только игроками Vivecraft. В исходной основе нет точных узлов разрешений, сообщений об отказе и правил исключений, поэтому их нельзя воспроизводить по предположению.
Перед включением ограничения нужно проверить вход VR-клиента, отказ обычному клиенту, повторное подключение и работу сети за прокси.
Полный набор параметров создаётся после первого запуска. Переключаемыми названы Roomscale Blocking, Dual Wielding, Climbey Tools и ускоренное разрушение; отдельно настраиваются взрывы, дистанция атак и попадания в голову.
Названия полей не приведены. Практический порядок — сохранить исходный файл, менять по одной функции и сравнивать поведение VR- и обычного игрока. Одинаковая структура во всех выпусках не подтверждена.
При использовании прокси данные Vivecraft могут потребовать дополнительной совместимости, чтобы корректно пройти до Spigot-, Paper- или Folia-сервера. Официально упомянуты отдельные расширения для BungeeCord и Velocity.
Это не означает, что прокси-компонент обязателен в любой установке: речь идёт о сетях, где передача данных иначе не достигает конечного сервера. Схема должна проверяться целиком — клиент, прокси, серверное ядро и VSE.
Для диагностики стоит сравнить прямое подключение и вход через прокси, проверить переход между внутренними серверами и изучить журналы всех узлов при потере VR-данных.
VSE добавляет Spigot-метаданные к объектам Player, чтобы сторонние плагины могли учитывать VR-состояние и особенности взаимодействий. Официальный текст предупреждает, что один ключ метаданных может использоваться несколькими плагинами, поэтому разработчику нужно фильтровать значения по конкретному владельцу Vivecraft-Spigot-Extension.
API также предоставляет дополнительные данные, включая историю частей тела. Классы и методы в основе не приведены, поэтому разработчику нужна документация именно установленной версии.
Перечень совместимости охватывает Minecraft от 1.8.8 и 1.8.9, все перечисленные ветки от 1.9 до 1.20.6, версии 1.21–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2. Платформы: Spigot, Paper, Folia и Purpur.
Один JAR не обязательно охватывает весь диапазон. В номере VSE первая часть соответствует возможностям Vivecraft, вторая — выпуску расширения с исправлениями или новой совместимостью. Например, 1.3.3-0 обозначает первый выпуск для Vivecraft 1.3.3. Выбор требует сопоставить Minecraft, ядро, Vivecraft и VSE.
JAR помещается в папку plugins совместимого сервера. Рекомендуемая последовательность:
• остановить сервер и создать резервную копию;
• выбрать файл под нужную версию;
• поместить JAR в plugins;
• запустить тестовый экземпляр и проверить журнал;
• подключить VR- и обычного игрока;
• протестировать движения, предметы и передачу через прокси.
В выбранных метаданных обязательные project dependencies не указаны. Это не исключает отдельного Vivecraft на VR-клиенте и возможного прокси-расширения в сетевой схеме.
Vivecraft-Spigot-Extension-1.3.15-1.jar имеет версию 1.3.15-1 и размер 1 752 116 байт. SHA-512: 96c617fd370c119424c6a1c3b8a5fce6526c52c0bf2d984cc830f8ac69057f0aaaa8d6b5c4ab65a1b8c203573279650ad8ac6de556af24080511d4f9eb3bc871; SHA-1: 53070b10a98747499601c6335f45db548080c122.
Vivecraft-Spigot-Extension-1.3.7-1.jar имеет версию 1.3.7-1 и размер 1 709 710 байт. SHA-512: 0ec903bb3a833ee172e10c45bfc33e721727390307c32f327baf223fc0dd61c4580c4aeab273251a8eeb821754124815216f07ff950cfbfcebbcdd232f28b9fb; SHA-1: 5f117b5be6e67d92700012c1b83a5d8effbe0f18.
Файлы получены по официальному HTTPS, сверены с опубликованными хешами и статически проверены по структуре и путям. Динамический запуск не выполнялся; целостность файла не равна подтверждению его поведения в конкретной сборке.
Данные не описывают все параметры, точные разрешения, API-контракт и совместимость с каждым античитом. До публикации нужно проверить движения, стрельбу, предметы, дистанции атак, права VR-группы, вход обычных клиентов и передачу через прокси.
Безопаснее проверять ресурс в отдельном тестовом профиле или на копии сервера и мира. Перед установкой сохраните резервную копию конфигурации и пользовательских данных, зафиксируйте текущие версии Minecraft и загрузчика, а после запуска проверьте журнал ошибок и только затем переносите изменение в основное окружение.
Нет. Сам VSE устанавливается как серверный плагин. Для игры в VR пользователь применяет отдельный Vivecraft-клиент.
Да, если администратор не включил заявленное ограничение только для пользователей Vivecraft.
Не для одиночного сервера. В сети за BungeeCord или Velocity он может понадобиться для корректной передачи данных Vivecraft.
Да. Folia входит в подтверждённые платформы вместе со Spigot, Paper и Purpur.
VSE не превращает обычный клиент в VR-клиент и не заменяет Vivecraft. Он обрабатывает данные Vivecraft, корректирует отдельные взаимодействия и предоставляет метаданные и API. Категории проекта — библиотека и утилита.
Назначение расширения
Обычный сервер Minecraft не обязан понимать все особенности положения головы, рук и тела игрока в VR. Vivecraft Spigot Extension создаёт серверный слой поддержки: он принимает связанные данные, делает движения видимыми другим пользователям Vivecraft и адаптирует ряд игровых действий.
Плагин применим на смешанных VR-серверах, специализированных Vivecraft-проектах, сетях за прокси и в сборках, где сторонним дополнениям нужны сведения о VR-состоянии. Само наличие VSE не добавляет клиенту виртуальную реальность.
Скриншоты и внешний вид
Отображение движений игроков
Подтверждена передача движений головы, рук и ног между игроками Vivecraft. Это позволяет VR-пользователям видеть более полное положение тела друг друга, чем стандартная модель Minecraft.
Функция зависит от данных, которые предоставляет Vivecraft. Исходная основа не обещает, что обычные клиенты будут отображать все VR-движения в том же виде, и не описывает визуальные особенности для каждой версии. Поэтому проверять результат нужно с реальными клиентами Vivecraft, соответствующими выбранной версии сервера и плагина.
Для проверки достаточно подключить двух VR-игроков, сопоставить движения контроллеров и головы, затем повторить тест после перехода между мирами и переподключения.
Боевые и предметные взаимодействия
VSE заявляет поддержку стрельбы из лука двумя руками. Также плагин исправляет обработку снарядов и выброшенных предметов от VR-игроков. Эти функции нужны потому, что положение рук и направление действия в Vivecraft могут отличаться от стандартного поведения клиента.
Также подтверждены попадания стрелой в голову, двойное владение, ускоренное разрушение блоков, инструменты Climbey и блокирование в масштабе комнаты. Часть функций переключается, а попадания в голову настраиваются; конкретные ключи в основе не приведены.
Коррекция дистанций для VR
Разработчик указывает две отдельные корректировки. Радиус взрыва крипера для VR-игроков может уменьшаться с 3 до 1,75 метра. Радиус ближней атаки мобов для них может сокращаться на 0,4 метра. Обе функции описаны как настраиваемые.
Корректировки относятся к VR-контексту, а не ко всем игрокам. Их нужно проверить вместе с выбранной сложностью, защитными и боевыми плагинами.
Права и режим доступа
VSE позволяет назначать отдельные группы разрешений VR-игрокам. Это даёт возможность различать пользователей Vivecraft и остальных участников средствами серверной системы прав.
Также заявлена опция ограничения сервера только игроками Vivecraft. В исходной основе нет точных узлов разрешений, сообщений об отказе и правил исключений, поэтому их нельзя воспроизводить по предположению.
Перед включением ограничения нужно проверить вход VR-клиента, отказ обычному клиенту, повторное подключение и работу сети за прокси.
Конфигурация функций
Полный набор параметров создаётся после первого запуска. Переключаемыми названы Roomscale Blocking, Dual Wielding, Climbey Tools и ускоренное разрушение; отдельно настраиваются взрывы, дистанция атак и попадания в голову.
Названия полей не приведены. Практический порядок — сохранить исходный файл, менять по одной функции и сравнивать поведение VR- и обычного игрока. Одинаковая структура во всех выпусках не подтверждена.
Прокси-сети
При использовании прокси данные Vivecraft могут потребовать дополнительной совместимости, чтобы корректно пройти до Spigot-, Paper- или Folia-сервера. Официально упомянуты отдельные расширения для BungeeCord и Velocity.
Это не означает, что прокси-компонент обязателен в любой установке: речь идёт о сетях, где передача данных иначе не достигает конечного сервера. Схема должна проверяться целиком — клиент, прокси, серверное ядро и VSE.
Для диагностики стоит сравнить прямое подключение и вход через прокси, проверить переход между внутренними серверами и изучить журналы всех узлов при потере VR-данных.
Метаданные и API для других плагинов
VSE добавляет Spigot-метаданные к объектам Player, чтобы сторонние плагины могли учитывать VR-состояние и особенности взаимодействий. Официальный текст предупреждает, что один ключ метаданных может использоваться несколькими плагинами, поэтому разработчику нужно фильтровать значения по конкретному владельцу Vivecraft-Spigot-Extension.
API также предоставляет дополнительные данные, включая историю частей тела. Классы и методы в основе не приведены, поэтому разработчику нужна документация именно установленной версии.
Версии и платформы
Перечень совместимости охватывает Minecraft от 1.8.8 и 1.8.9, все перечисленные ветки от 1.9 до 1.20.6, версии 1.21–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2. Платформы: Spigot, Paper, Folia и Purpur.
Один JAR не обязательно охватывает весь диапазон. В номере VSE первая часть соответствует возможностям Vivecraft, вторая — выпуску расширения с исправлениями или новой совместимостью. Например, 1.3.3-0 обозначает первый выпуск для Vivecraft 1.3.3. Выбор требует сопоставить Minecraft, ядро, Vivecraft и VSE.
Установка
JAR помещается в папку plugins совместимого сервера. Рекомендуемая последовательность:
• остановить сервер и создать резервную копию;
• выбрать файл под нужную версию;
• поместить JAR в plugins;
• запустить тестовый экземпляр и проверить журнал;
• подключить VR- и обычного игрока;
• протестировать движения, предметы и передачу через прокси.
В выбранных метаданных обязательные project dependencies не указаны. Это не исключает отдельного Vivecraft на VR-клиенте и возможного прокси-расширения в сетевой схеме.
Файлы и проверка целостности
Vivecraft-Spigot-Extension-1.3.15-1.jar имеет версию 1.3.15-1 и размер 1 752 116 байт. SHA-512: 96c617fd370c119424c6a1c3b8a5fce6526c52c0bf2d984cc830f8ac69057f0aaaa8d6b5c4ab65a1b8c203573279650ad8ac6de556af24080511d4f9eb3bc871; SHA-1: 53070b10a98747499601c6335f45db548080c122.
Vivecraft-Spigot-Extension-1.3.7-1.jar имеет версию 1.3.7-1 и размер 1 709 710 байт. SHA-512: 0ec903bb3a833ee172e10c45bfc33e721727390307c32f327baf223fc0dd61c4580c4aeab273251a8eeb821754124815216f07ff950cfbfcebbcdd232f28b9fb; SHA-1: 5f117b5be6e67d92700012c1b83a5d8effbe0f18.
Файлы получены по официальному HTTPS, сверены с опубликованными хешами и статически проверены по структуре и путям. Динамический запуск не выполнялся; целостность файла не равна подтверждению его поведения в конкретной сборке.
Ограничения
Данные не описывают все параметры, точные разрешения, API-контракт и совместимость с каждым античитом. До публикации нужно проверить движения, стрельбу, предметы, дистанции атак, права VR-группы, вход обычных клиентов и передачу через прокси.
Безопасная проверка
Безопаснее проверять ресурс в отдельном тестовом профиле или на копии сервера и мира. Перед установкой сохраните резервную копию конфигурации и пользовательских данных, зафиксируйте текущие версии Minecraft и загрузчика, а после запуска проверьте журнал ошибок и только затем переносите изменение в основное окружение.
FAQ
Нужен ли VSE на клиенте?
Нет. Сам VSE устанавливается как серверный плагин. Для игры в VR пользователь применяет отдельный Vivecraft-клиент.
Могут ли обычные игроки заходить на сервер?
Да, если администратор не включил заявленное ограничение только для пользователей Vivecraft.
Обязателен ли прокси-плагин?
Не для одиночного сервера. В сети за BungeeCord или Velocity он может понадобиться для корректной передачи данных Vivecraft.
Поддерживает ли VSE Folia?
Да. Folia входит в подтверждённые платформы вместе со Spigot, Paper и Purpur.
