JoyPro2 Discord GitHub
Ігри

VTOL VR

Показати:

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 кроки

  1. Налаштувати все за мене
    на сторінці «Початок»
  2. Використати ці кнопки
    спершу перегляньте список
  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 (один раз)

  1. Відкрийте Початок і натисніть Встановити BYOJoystick на картці VTOL VR. Панель показує, що це за мод, його офіційне джерело (Steam Workshop, вихідний код на GitHub), його розмір і чи є на цьому ПК VTOL VR Mod Loader та сам мод.
  2. Позначте прапорець, що ви прочитали, що таке BYOJoystick, і хочете встановити його зі Steam Workshop, потім натисніть Встановити BYOJoystick. JoyPro робить резервну копію ваших файлів BYOJ і відкриває Steam: встановіть Mod Loader, якщо Steam попросить, потім натисніть Subscribe на сторінці BYO Joystick. Steam завантажує мод; JoyPro нічого з нього не копіює.
  3. Натисніть Перевірити знову: JoyPro знаходить мод і створює з нього свій список команд VTOL VR.

#Імпорт ваших прив'язок

Натисніть Імпорт на картці VTOL VR (BYOJoystick) або на картці нативної частини, потім Імпортувати зараз. Для BYOJoystick Брати також клавіші клавіатури додає й ваші прив'язки клавіатури.

Сторінка «Початок» з вашими іграмиСторінка «Початок» з вашими іграми
Сторінка «Початок» з вашими іграми (Зображення показують застосунок англійською.)

#Створення й перевірка зв'язків

Створюйте зв'язки так само, як для будь-якої гри (процес роботи зі зв'язками); майстер налаштування й автопризначення знають цілі BYOJoystick. Потім запустіть перевірку на сторінці «Експорт».

#Експорт у VTOL VR

  1. Закрийте VTOL VR. JoyPro відмовляється записувати, поки гра працює (процес VTOLVR).
  2. Відкрийте Експорт і залиште Замінити на моїх пристроях разом із Очистити й інші мої пристрої, якщо ви налаштовуєте свої пристрої саме в JoyPro.
  3. Натисніть Експортувати зараз на картці VTOL VR (BYOJoystick) і, для педалей, на нативній картці.
У грі: Що ви побачите у VTOL VR

У грі Налаштування показує 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"]
Дві гри в JoyPro: файли моду BYOJoystick (по одному BYOJ_seat.xml на кожне місце в SaveData гри) і власне кермо напрямку та носкові гальма гри (inputbindings.cfg, а також Hardware Control Rudder у gameSettings.cfg).

Код: 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.