VTOL VR — боевой авиасимулятор только для VR: вы летаете, держа VR-контроллерами виртуальную ручку и РУД. Сама игра привязывает только три оси физического устройства — руль направления и два носочных тормоза — и хранит их в одном файле для всех ЛА. Полную поддержку HOTAS (ручка, РУД, каждый переключатель, для каждого ЛА и места) даёт бесплатный мод BYOJoystick. JoyPro обрабатывает обе части как две игры: VTOL VR (BYOJoystick mod) записывает файлы привязок мода, VTOL VR (native rudder and brakes) записывает собственный файл игры и её настройки управления.
VTOL VR (мод BYOJoystick) напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine vtolvr- Файл привязок
<install>\SaveData\BYOJ_<seat>.xml(XmlSerializer)- Входы, которые читает игра
- читает 128 кнопок, 8 осей, 4 хатки (4 направления) на джойстик (проверено)
- Список команд из
BYOJoystick.dllустановленного мода (Steam Workshop; в программе: «Установить BYOJoystick» на карточке VTOL VR), иначе ваши собственныеBYOJ_*.xml
- ✓ Импорт
- ✓ Экспорт
- ✓ Привязки клавиатуры
- ◐ МодификаторыBYOJoystick: один модификатор на привязку (кнопка джойстика для привязок джойстика, клавиша для привязок клавиатуры).
- ◐ Список команд строится на вашем ПКVTOL VR (BYOJoystick): список строится, только если установлен мод BYOJoystick.
- ✓ Наблюдатель за играми
- ◐ Кривые осей и мёртвые зоныBYOJoystick: одно значение мёртвой зоны на привязку (порог перехвата или отсечка для slew и наклона); без кривых.
- ✓ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ✓ Мастер настройки / Автоназначение
- ✓ Кабины
- ✓ Шпаргалки
- ✗ Внутриигровой тест
VTOL VR (нативно: руль направления и тормоза) напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine vtolvr-native- Файл привязок
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg(ConfigNode + XML Rewired) +gameSettings.cfg- Список команд из
level0игры
- ✓ Импорт
- ✓ Экспорт
- ✗ Привязки клавиатуры
- ✗ Модификаторы
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ◐ Кривые осей и мёртвые зоныVTOL VR нативно: только инверсия и диапазон оси, без кривой и мёртвой зоны.
- ✓ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ✓ Мастер настройки / Автоназначение
- ✗ Кабины
- ✓ Шпаргалки
- ✗ Внутриигровой тест
Из матрицы поддержки, созданной по коду движка: все игры.
#Запуск за 3 шага
- Настроить всё за меня
на странице «Старт» - Использовать эти кнопки
сначала посмотрите список - Записать в мою игру
держите VTOL VR закрытой
До: нажмите Установить BYOJoystick на карточке VTOL VR (один раз, см. ниже). Один раз запустите VTOL VR с подключёнными педалями и выйдите из Настройки кнопкой OK.
Потом: включите Hardware Control Rudder в настройках игры, иначе игра проигнорирует ваш руль направления.
Вы уже назначали кнопки в VTOL VR? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить мою ручку работать.
#Что JoyPro делает для VTOL VR
- С BYOJoystick: каждая цель, которую предлагает мод (оси ручки и РУД, шасси, закрылки, оружие, средства противодействия, радар, огни, кнопки MFD и другое), для каждой машины и места — с ваших ручек, РУД и клавиатуры.
- Без мода: собственные Руль направления, Wheel Brake L и Wheel Brake R игры, а также настройки её меню Controls (Hardware Control Rudder, мёртвые зоны VR, тактильная отдача).
- Связки: одна связка — это одна функция; экспорт BYOJoystick записывает её в каждый файл места, у машины которого есть эта цель.
#Установка BYOJoystick (один раз)
- Откройте Старт и нажмите Установить BYOJoystick на карточке VTOL VR. Панель покажет, что это за мод, его официальный источник (Steam Workshop, исходный код на GitHub), его размер и есть ли на этом ПК VTOL VR Mod Loader и сам мод.
- Отметьте флажок, что вы прочитали, что такое BYOJoystick, и хотите установить его из Steam Workshop, затем нажмите Установить BYOJoystick. JoyPro сохранит резервную копию ваших файлов BYOJ и откроет Steam: установите Mod Loader, если Steam попросит, затем нажмите Subscribe на странице BYO Joystick. Steam скачает мод; JoyPro ничего из него не копирует.
- Нажмите Проверить снова: JoyPro найдёт мод и создаст по нему список команд VTOL VR.
#Импорт ваших привязок
Нажмите Импорт на карточке VTOL VR (BYOJoystick) или на карточке нативной части, затем Импортировать. Для BYOJoystick вариант Брать также клавиши клавиатуры переносит и ваши привязки клавиатуры.


#Создание и проверка связок
Создавайте связки так же, как для любой игры (порядок работы со связками); мастер настройки и автоназначение знают цели BYOJoystick. Затем запустите проверку на странице «Экспорт».
#Экспорт в VTOL VR
- Закройте VTOL VR. JoyPro отказывается записывать, пока игра работает (процесс
VTOLVR). - Откройте Экспорт и оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете свои устройства в JoyPro.
- Нажмите Экспортировать на карточке VTOL VR (BYOJoystick) и, для педалей, на нативной карточке.
В игре раздел Настройки показывает Hardware Control Rudder включённым, если это задано в вашем профиле, а Bindings перечисляет Руль направления, Wheel Brake L и Wheel Brake R с вашим устройством и его осью. Привязки BYOJoystick находятся в собственном окне мода, для каждого места в машине; его кнопка Загрузить заново читает файлы.
#Что вы делаете сами в VTOL VR
- Один раз запустите VTOL VR с подключёнными педалями и выйдите из Настройки кнопкой OK. Тогда игра перечислит ваши устройства и создаст
gameSettings.cfg; нативный экспорт записывает только устройства, которые игра перечислила, и никогда не создаёт файл настроек. - Hardware Control Rudder должен быть включён, иначе игра проигнорирует оси руля направления и тормозов. Включите его в игре или сохраните в JoyPro (Расширенные), чтобы его записал нативный экспорт.
- BYOJoystick нужен VTOL VR Mod Loader из Steam; JoyPro только открывает страницы Steam.
#Частые ошибки
- Руль направления не работает: Hardware Control Rudder выключен. Игра читает его при появлении машины.
- Работает только один носочный тормоз или оба следуют за курком РУД: игра берёт тормоза с педалей, только когда привязан Wheel Brake L. Привяжите оба.
- Носочный тормоз тормозит только на второй половине хода: игра читает тормоз в диапазоне от 0 до 1. Задайте диапазон оси этой связки как Positive (Расширенные); JoyPro предупреждает об этом случае.
- Две одинаковые педали: игра хранит одну карту на модель устройства, поэтому обе управляют одним и тем же действием.
- Привязка BYOJoystick пропала: при загрузке файла мод отбрасывает цели, которых нет у машины.
#Файлы, которые JoyPro читает и записывает
| Файл | Что это |
|---|---|
<install>\SaveData\BYOJ_<seat>.xml |
привязки BYOJoystick одного места в технике: AV42C, FA26B, F45A, AH94Front, AH94Rear, T55Front, T55Rear, EF24GFront, EF24GRear |
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\inputbindings.cfg |
собственные привязки игры: карты джойстика Rewired в текстовом файле; его синхронизирует Steam Cloud |
%APPDATA%\Boundless Dynamics, LLC\VTOLVR\SaveData\gameSettings.cfg |
значения Settings > Controls (HARDWARE_RUDDER, ...); его синхронизирует Steam Cloud |
<library>\steamapps\workshop\content\3018410\3276352374\BYOJoystick.dll |
установленный мод: только чтение, для его списка целей |
<install>\VTOLVR_Data\level0 |
список действий Rewired игры: только чтение, для собственного списка команд игры |
Устаревший файл <install>\SaveData\inputbindings.cfg никогда не записывается. Перед каждой записью делается резервная копия, а сама запись атомарна (временный файл, затем замена): игра заменяет повреждённый inputbindings.cfg пустым.
#Режимы экспорта в VTOL VR
| Режим | BYOJoystick (файл для каждого места) | Собственный (inputbindings.cfg) |
|---|---|---|
| Только добавить | Ничего поверх привязок места: привязка на входе, который использует другая цель (с тем же состоянием модификатора), попадает в список как незаписанная. | Только свободные оси; занятая ось попадает в список как незаписанная. |
| Обновить, привязки игры сохранить | Другая цель на вашем входе теряет его; всё остальное остаётся, в том числе старый вход перенесённой цели. | Действие на вашей оси заменяется; всё остальное остаётся. |
| Обновить, мой профиль важнее | Как выше, и ваши цели теряют свои другие входы на подключённых устройствах (клавиши — только с параметром клавиатуры). | Как выше, и ваши действия теряют свои другие оси на подключённых устройствах. |
| Заменить на моих устройствах | Устройства, в которые записывает JoyPro, сохраняют только ваши привязки. | Остальные действия записанных устройств очищаются. |
| + Очистить и другие мои устройства | Подключённые устройства без привязок очищаются. | Подключённые устройства без привязок очищаются. |
#Что никогда не затрагивается
- Неподключённые устройства, игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
- BYOJoystick: входы, которые JoyPro не может прочитать, и кнопка-модификатор места, если ваш профиль не задаёт свою.
- Собственная часть: карты кнопок, карты клавиатуры и мыши, поведение входов, карты калибровки, назначения контроллеров и игрок System. Экспорт BYOJoystick не записывает
gameSettings.cfg. - Клавиатура, если вы не экспортируете привязки клавиатуры (только BYOJoystick).
#Места, оси, настройки
- Детализация: BYOJoystick — для каждого места в технике (цель попадает в каждое место, где она есть); собственная часть игры глобальная.
- Оси BYOJoystick: инверсия и одно число мода Мёртвая зона на привязку. На Joystick Pitch, Roll, Yaw и на Throttle, Power, Collective это не мёртвая зона, а отклонение, которое нужно HOTAS, чтобы забрать управление у другого члена экипажа в мультиплеере; на SOI Slew X/Y и Articulate Tilt оно отсекает малые значения без масштабирования; в остальных местах мод его не использует. Кривых нет. См. axis-curves.
- Собственные оси игры: инверсия, а для носковых тормозов — диапазон оси (Full или Positive). Мёртвые зоны и кривые записать нельзя.
- Модификаторы: BYOJoystick знает одну кнопку-модификатор на файл места (привязки, которым она нужна, действуют только пока она удерживается); у привязки клавиатуры может быть одна клавиша-модификатор. В собственной части игры их нет.
- Настройки управления: Настройки > Настройки FFB игр, игра VTOL VR (control settings, VR haptics): Hardware Control Rudder, Thumb Control Rudder, Twist Rudder Deadzone, Thumbstick Deadzone, Thumbstick Mode, Toggle Grip, Flight Control Haptics, Overall Haptics. Собственный экспорт игры записывает их в
gameSettings.cfg, даже если в профиле нет собственных привязок игры. - Force Feedback: в VTOL VR нет Force Feedback для джойстика; тактильная отдача — у VR-контроллеров.
- Отслеживание: файлы BYOJ, а с собственной частью игры —
gameSettings.cfg(отслеживание).
#Внутри интеграции VTOL VR
flowchart LR P["Ваш профиль"] --> B["engine vtolvr export"] P --> N["engine vtolvr-native<br/>export"] B --> X["BYOJ_seat.xml"] N --> I["inputbindings.cfg"] N --> S["gameSettings.cfg"] X --> M["Мод BYOJoystick"] I --> G["VTOL VR:<br/>Bindings"]
Код: engine\Games\VtolVrIntegration.cs (BYOJoystick), VtolVrMod.cs (состояние установки, список целей), ClrMetadata.cs, VtolVrNativeIntegration.cs, engine\AxisModels\VtolVr.cs (byoj, vtolnative), engine\FfbModels\VtolVr.cs (настройки управления).
- Формат BYOJoystick: XML-сериализация .NET, корень
<Bindings>с<KeyboardBindings>(Target,Key,ModifierKeyв виде имён Unity KeyCode) и<JoystickBindings>(Target,JoystickId,Input,RequiresModifier,Invert,Deadzone,POVDirection).Input:X Y Z RX RY RZ,S1 S2,PoV1..PoV4,B1..B128. Устройства — по GUID экземпляра DirectInput (JoystickId). - Собственный формат игры: текстовый файл с корнем
RewiredSaveDataи строками{key} = {value}; карта джойстика — это Rewired XML (объявлен как UTF-16 внутри файла UTF-8). Действия: 0 Rudder, 5 Wheel Brake L, 6 Wheel Brake R. Ключ карты — модель устройства:hardwareIdentifier=WindowsRawInput+ строка продукта HID без пробелов + десятичный PID + GUID продукта,hardwareGuidнулевой для устройств, которых Rewired не знает. Элемент — это n-я ось устройства. - Списки команд:
engine vtolvr refresh-dbчитает цели из установленногоBYOJoystick.dll, не загружая и не запуская его (его метаданные и строковые литералы), затем ваши собственныеBYOJ_*.xml; без мода списка нет.engine vtolvr-native refresh-dbчитает список действий Rewired изlevel0. - Команды:
engine vtolvr mod(status,prepare --accept-license),engine vtolvr scan,engine vtolvr import,engine vtolvr export,engine vtolvr-native scan,engine vtolvr-native import,engine vtolvr-native export, настройки черезengine ffb set--device * --game VTOLVR.
#Известные ограничения
- Прогона в игре пока не было; BYOJoystick проверен с DLL-заменителем. Загружается ли мод в текущей версии игры, пока не подтверждено.
- Собственная часть: порядок осей устройств, которых Rewired не знает, и точный идентификатор устройства взяты из кода игры, а не из файла, записанного игрой.
- BYOJoystick: диагонали хаток, кнопка на цели-оси и ось на цели-кнопке пропускаются с предупреждением.
- JoyPro не поставляет никакой части BYOJoystick; его список команд существует, только если мод установлен.
- Тесты:
engine\tests\smoke\vtolvr.ps1(импорт туда и обратно, собственные значения, общие настройки игры, экспорт только настроек).
Все технические заметки по этой игре (созданы из репозитория): vtol-vr.md.