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 Hat (4 кірункі) на joystick (праверана)
- Спіс каманд з
BYOJoystick.dllусталяванага мода (Steam Workshop; у праграме: «Усталяваць BYOJoystick» на картцы VTOL VR), інакш вашы ўласныяBYOJ_*.xml
- ✓ Імпарт
- ✓ Экспарт
- ✓ Прывязкі клавіятуры
- ◐ МадыфікатарыBYOJoystick: адзін мадыфікатар на прывязку (кнопка joystick для прывязак joystick, клавіша для прывязак клавіятуры).
- ◐ Спіс каманд, пабудаваны на вашым ПКVTOL VR (BYOJoystick): спіс будуецца, толькі калі ўсталяваны мод BYOJoystick.
- ✓ Назіральнік за гульнямі
- ◐ Крывыя восяў і мёртвыя зоныBYOJoystick: адно значэнне мёртвай зоны на прывязку (парог перахопу або адсячэнне для slew і нахілу); без крывых.
- ✓ Налады кіравання ў гульні
- ✗ Налады зваротнай сувязі па сіле ў гульні
- ✗ Зваротная сувязь па сіле з тэлеметрыі
- ✗ Запіс тэлеметрыі
- ✓ Віртуальны 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 убудавана: толькі інверсія і дыяпазон восі, без крывой і мёртвай зоны.
- ✓ Налады кіравання ў гульні
- ✗ Налады зваротнай сувязі па сіле ў гульні
- ✗ Зваротная сувязь па сіле з тэлеметрыі
- ✗ Запіс тэлеметрыі
- ✓ Віртуальны 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 |
уласныя прывязкі гульні: карты джойсціка 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 ведае адну кнопку мадыфікатара на файл месца (прывязкі, якім яна патрэбна, дзейнічаюць толькі, пакуль яна націснута); прывязка клавіятуры можа мець адну клавішу мадыфікатара. Уласная частка гульні іх не мае.
- Налады кіравання: Налады > Налады зваротнай сувязі па сіле гульняў, гульня 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, нават калі ў профілі няма ўласных прывязак гульні. - Зваротная сувязь па сіле: у VTOL VR няма зваротнай сувязі па сіле для джойсціка; вібрацыя — гэта вібрацыя кантролераў 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: дыяганалі Hat, кнопка на мэце-восі і вось на мэце-кнопцы прапускаюцца з папярэджаннем.
- JoyPro не пастаўляе ніякай часткі BYOJoystick; яго спіс каманд існуе толькі з усталяваным модам.
- Тэсты:
engine\tests\smoke\vtolvr.ps1(поўныя цыклы імпарту, уласныя значэнні, налады для ўсёй гульні, экспарт толькі налад).
Усе тэхнічныя нататкі пра гэту гульню (створаны з рэпазіторыя): vtol-vr.md.