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 напрямки) на joystick (перевірено)
- Список команд з
BYOJoystick.dllвстановленого мода (Steam Workshop; у програмі: «Встановити BYOJoystick» на картці VTOL VR), інакше ваші власніBYOJ_*.xml
- ✓ Імпорт
- ✓ Експорт
- ✓ Прив'язки клавіатури
- ◐ МодифікаториBYOJoystick: один модифікатор на прив'язку (кнопка joystick для прив'язок joystick, клавіша для прив'язок клавіатури).
- ◐ Список команд, створений на вашому ПКVTOL VR (BYOJoystick): список будується, лише якщо встановлено мод BYOJoystick.
- ✓ Спостерігач за іграми
- ◐ Криві осей і мертві зониBYOJoystick: одне значення мертвої зони на прив'язку (поріг перехоплення або відсічка для slew і нахилу); без кривих.
- ✓ Налаштування керування гри
- ✗ Налаштування Force Feedback у грі
- ✗ Force Feedback з телеметрії
- ✗ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✗ Внутрішньоігровий тест
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 з телеметрії
- ✗ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✗ Кабіни
- ✓ Шпаргалки
- ✗ Внутрішньоігровий тест
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 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 |
власні прив'язки гри: карти joystick 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 знає одну кнопку модифікатора на файл місця (прив'язки, яким вона потрібна, діють лише поки її утримують); прив'язка клавіатури може мати одну клавішу-модифікатор. Власна частина гри їх не має.
- Налаштування керування: Налаштування > Налаштування force feedback ігор, гра 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 для joystick; тактильний відгук — у 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: серіалізація .NET XML, корінь
<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}; карта joystick — це 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.