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

  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 уласныя прывязкі гульні: карты джойсціка 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"]
Дзве гульні ў 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: 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.