JoyPro2 Discord GitHub
Галоўныя працэсы

Экспарт у вашы гульні

Паказаць:

Экспарт — гэта крок, які прымушае вашы ручкі кіравання працаваць у гульні. JoyPro запісвае вашы сувязі і прывязкі ў файлы налад кіравання кожнай гульні, тыя самыя файлы, якія захоўвае ўласнае меню Controls гульні. Падчас палёту ў фоне нічога не працуе: пасля экспарту гульня, як заўсёды, чытае свае ўласныя файлы.

flowchart LR
  C["1 Праверка<br/>(неабавязкова)"] --> M["2 Выберыце спосаб<br/>(4 варыянты)"]
  M --> G["3 Адзначце гульні,<br/>Экспартаваць адзначаныя гульні"]
  G --> W["Спачатку рэзервовая копія,<br/>потым запісваюцца<br/>файлы гульні"]
Крок 1 толькі глядзіць; ён ніколі не спыняе экспарт. «Адмяніць апошні экспарт» на картцы гульні вяртае яе файлы. Для гульняў толькі для Xbox нічога не запісваецца: яны выкарыстоўваюць «Пачаць» на старонцы «Віртуальны joystick».
Для пачаткоўцаў

#Экспарт у тры крокі

Адкрыйце Экспарт на панэлі ўнізе. Старонка складаецца з трох пранумараваных картак зверху ўніз:

Старонка «Экспарт»: праверка, спосаб, гульніСтаронка «Экспарт»: праверка, спосаб, гульні
Старонка «Экспарт»: праверка, спосаб, гульні (На малюнках праграма па-англійску.)
  1. Праверце свой профіль. Націсніце Праверыць зараз. JoyPro шукае тое, што пайшло б не так у гульні, напрыклад кнопку, якая робіць дзве рэчы ў адным лятальным апараце. Выпраўце знойдзенае (адна пстрычка на праблему) або пакіньце як ёсць; праверка ніколі не блакуе экспарт. Гл. Праверка.
  2. Як JoyPro запісвае ў гульні. Выберыце адзін з чатырох варыянтаў. Калі не ўпэўнены, пакіньце першы: Замяніць на маіх прыладах з адзначаным Ачысціць і іншыя мае прылады. Тады вашы ручкі кіравання робяць дакладна тое, што кажа ваш профіль, і нічога больш.
  3. Экспарт у гульні. Кожная гульня, для якой у вашым профілі ёсць прывязкі, атрымлівае картку з малюнкам. Адзначце гульні і націсніце Экспартаваць адзначаныя гульні або націсніце Экспартаваць зараз на адной картцы.

Спачатку закрыйце гульню. Гульні запісваюць свае файлы кіравання пры выхадзе, таму JoyPro адмаўляецца экспартаваць у гульню, якая працуе, і паведамляе вам пра гэта.

#Які варыянт падыходзіць мне?

Выбар Выбірайце, калі Што адбываецца з уласнымі прывязкамі гульні
Замяніць на маіх прыладах Вы наладжваеце свае ручкі кіравання менавіта ў JoyPro На прыладах з вашага профілю застаюцца толькі вашы прывязкі (для лятальных апаратаў, якія вы экспартуеце).
Абнавіць, пакінуць прывязкі гульні Вы таксама прывязваеце нешта ў самой гульні і хочаце гэта захаваць Вашы прывязкі дадаюцца; прывязка гульні выдаляецца толькі там, дзе яна стаіць на кнопцы, якую вы выкарыстоўваеце для чагосьці іншага.
Абнавіць, мой профіль мацнейшы Як і папярэдні, але вы перанеслі дзеянні на іншыя кнопкі ў JoyPro Як вышэй, і кожнае дзеянне, якое вы прывязваеце, губляе ў гульні свае іншыя кнопкі, каб перанос сапраўды пераносіў.
Толькі дадаць Вы спрабуеце JoyPro ўпершыню Нічога не выдаляецца. Калі гульня ўжо выкарыстоўвае кнопку для чагосьці іншага, ваша прывязка прапускаецца, і праверка вам пра гэта паведамляе.

Ачысціць і іншыя мае прылады (сцяжок пад варыянтамі): падключаныя прылады, у якіх няма прывязак у вашым профілі, губляюць свае прывязкі ў экспартаваных лятальных апаратах. Пакіньце сцяжок, калі хочаце пачаць з чыстага ліста, і зніміце яго, калі карыстаецеся другой прыладай толькі ўнутры гульні.

#Бяспечна па задуме

  • Перш чым JoyPro зменіць файл гульні, ён капіруе яго ў рэзервовую копію. На кожнай картцы ёсць Адмяніць апошні экспарт: гэта вяртае файлы дакладна такімі, якімі яны былі, байт у байт.
  • Першы экспарт у гульню, у якой ужо ёсць свае прывязкі, адзін раз пытаецца: «Спачатку імпартаваць?». Выберыце Спачатку імпартаваць, калі хочаце захаваць тое, што зрабілі ў гульні, або Усё роўна экспартаваць, каб гэта замяніць.
  • Прылады, якія не падключаны, захоўваюць свае прывязкі. Прывязкі вашай мышы і геймпада ніколі не змяняюцца.

#Што вы заўважыце ў гульні

Запусціце гульню і адкрыйце яе меню кіравання: вашы прывязкі там, у слупку кожнай прылады, пад назвамі, якія выкарыстоўвае гульня. У DCS яны паказваюцца для кожнага лятальнага апарата; у Star Citizen — для кожнага дзеяння карабля; у IL-2 — у Key mapping. Раздзел У гульні ніжэй пералічвае ўсе тыпы гульняў.

#Іншыя спосабы, якімі вашы прывязкі трапляюць у гульню

Спосаб Што ён робіць
Запісаць у маю гульню (хуткая налада) Экспарт хуткай налады. Ён запісвае гульні, якія наладзіў, з той жа рэзервовай копіяй. Гл. Хуткі старт.
Імітаваны кантролер (віртуальны геймпад Xbox) Для ACE COMBAT 8 і Hell Let Loose: Vietnam нічога не запісваецца. Іх экспарт пра гэта паведамляе. Ваша ручка кіравання кіруе імітаваным кантролерам, пакуль уключаны Пачаць. Гл. Гульні толькі для Xbox.
Планшэт DCS Не экспарт прывязак: старонка для кожнага лятальнага апарата, якая паказвае ў кабіне, што робяць вашы кнопкі. Гл. планшэт.
Дадаткова

#Рэжымы падрабязна

«Той жа ўваход» азначае тую ж прыладу, тую ж кнопку або вось і тыя ж мадыфікатары ў тым жа лятальным апараце (або караблі, тэхніцы), калі гульня захоўвае прывязкі для кожнага апарата асобна. Кожны рэжым працуе толькі ў лятальных апаратах экспарту.

Толькі дадаць Абнавіць, пакінуць Абнавіць, профіль мацнейшы Замяніць
Вашы прывязкі запісваюцца там, дзе ўваход вольны апісана апісана апісана
Прывязка гульні на ўваходзе, які вы выкарыстоўваеце для іншага дзеяння застаецца; ваша прывязка не запісваецца і пазначаецца выдаляецца выдаляецца выдаляецца
Прывязка гульні таго ж дзеяння на іншым уваходзе (пасля пераносу) захавана застаецца (дзеянне на абодвух уваходах) выдаляецца выдаляецца на запісаных прыладах
Іншыя прывязкі гульні на вашых прыладах захавана захавана захавана выдаляюцца
Прывязкі гульні па змаўчанні на вашых прыладах захавана захавана застаюцца, калі не займаюць аднаго з вашых дзеянняў выдаляюцца
Падключаныя прылады без прывязак у профілі захавана захавана вашы дзеянні з іх выдаляюцца застаюцца, калі не ўключана Ачысціць і іншыя мае прылады
Прылады, якія не падключаны, мыш, пульт ніколі не закранаюцца ніколі не закранаюцца ніколі не закранаюцца ніколі не закранаюцца
Клавіятура толькі з параметрам клавіятуры толькі з параметрам клавіятуры толькі з параметрам клавіятуры толькі з параметрам клавіятуры
Лятальныя апараты, якіх няма ў экспарце ніколі не закранаюцца ніколі не закранаюцца ніколі не закранаюцца ніколі не закранаюцца (DCS: калі не ўключаны параметр «губляць прывязкі DCS па змаўчанні і ў астатніх лятальных апаратах»)

Ачысціць і іншыя мае прылады не выкарыстоўваецца з «Толькі дадаць». З іншымі рэжымамі яно ачышчае падключаныя прылады, якія профіль не выкарыстоўвае, у экспартаваных лятальных апаратах (DCS: і іх прывязкі DCS па змаўчанні). Прылады, якія ігнаруе імпарт, і прылада vJoy, у якую JoyPro перадае ўвод, ніколі не ачышчаюцца.

З версіі 2.5.0 па змаўчанні выбрана Замяніць на маіх прыладах + Ачысціць і іншыя мае прылады (як у JoyPro 1). Рэжым, які вы выбралі самі, запамінаецца.

#Коратка: адна ваша прывязка, чатыры рэжымы

Рэжым Гульня выкарыстоўвае вашу кнопку для чагосьці іншага Ваша дзеянне мае ў гульні іншыя кнопкі Іншыя падключаныя прылады
Замяніць на маіх прыладах Тая прывязка выдаляецца; ваша запісваецца Выдаляюцца на запісаных прыладах Застаюцца, калі не ўключана Ачысціць і іншыя мае прылады
Абнавіць, мой профіль мацнейшы Тая прывязка выдаляецца; ваша запісваецца Выдалена Вашы дзеянні з іх выдаляюцца
Абнавіць, пакінуць прывязкі гульні Тая прывязка выдаляецца; ваша запісваецца Застаюцца: дзеянне на абодвух Захавана
Толькі дадаць Застаецца; ваша не запісваецца і пазначаецца Захавана Захавана

#Параметры для кожнай гульні

У раздзеле Параметры і шляхі (для экспертаў):

  • DCS: спіс Лятальныя апараты... на картцы DCS (запісваюцца толькі адзначаныя лятальныя апараты); DCS: пакінуць прывязкі клавіятуры па змаўчанні (уключана); мае прылады губляюць прывязкі DCS па змаўчанні і ў астатніх лятальных апаратах (выключана).
  • Star Citizen: SC: пакінуць прывязкі клавіятуры па змаўчанні, аддаваць перавагу лакальнаму парадку.
  • Іншыя гульні: поле Праверка без запісу, якое паказвае, што змянілася б, нічога не запісваючы.
  • Шляхі: іншая папка Saved Games або канфігурацыі для кожнай гульні; Свае шляхі і ігнараваныя прылады для гэтага профілю дае адкрытаму профілю ўласныя замест агульных для ПК.

#Пазнакі: «Не запісана ў гульню»

«Толькі дадаць» (і любы рэжым, калі ў гульні няма вольнага месца для яшчэ аднаго ўваходу, напрыклад Elite Dangerous з двума ўваходамі на дзеянне) прапускае некаторыя прывязкі. Профіль запамінае кожную з іх разам з дзеяннем гульні, якое займае ўваход, і датай; Праверка паказвае на кожную пазнаку картку з Экспартаваць з 'Абнавіць', каб замяніць, Перанесці на іншую кнопку і Пакінуць як ёсць. Кожны экспарт замяняе пазнакі сваёй гульні і лятальных апаратаў, таму пазнака знікае, калі пазнейшы экспарт запіша прывязку.

#Запомненыя налады

Рэжым, птушка Ачысціць і іншыя, параметры для кожнай гульні і шляхі захоўваюцца ў наладах JoyPro; гульні і лятальныя апараты DCS, якія вы адзначылі самі, захоўваюцца для кожнага профілю. «Замяніць» і «Ачысціць і іншыя» пытаюцца перад кожным экспартам (у «Налады > Пацвярджэнні» пытанне можна выключыць).

#Пасля экспарту

  • Адмяніць апошні экспарт на картцы аднаўляе самую новую рэзервовую копію гэтай гульні. Поўны спіс знаходзіцца ў Рэзервовыя копіі канфігурацый гульняў унізе старонкі «Экспарт».
  • Экспарт запамінае файлы гульні для назіральніка за гульнямі: пасля ўласнага экспарту JoyPro ніколі не спытае «пераняць змены?»; а пасля змены, якую вы потым зробіце ў гульні, спытае (назіральнік).
  • JoyPro захоўвае свае ўласныя даныя побач з файлам гульні, таму пазнейшы імпарт вяртае назвы сувязей, групы, мадыфікатары і крывыя (паўторны імпарт).

#У гульні

Тое, што гулец бачыць пасля экспарту, залежыць ад тыпу гульні. Усе гульні ніжэй падпарадкоўваюцца аднолькавым правілам: JoyPro запісвае толькі дзеянні са свайго спіса каманд, адмаўляецца запісваць, пакуль гульня працуе, спачатку робіць рэзервовую копію файлаў і ніколі не адгадвае прыладу або дзеянне, якое не можа супаставіць (ён прапускае іх з папярэджаннем).

У гульні: Лётныя сімулятары: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro бярэ на сябе прылады, у якія запісвае. З Замяніць усе іншыя прывязкі гэтых прылад знікаюць у экспартаваных лятальных апаратах, з Ачысціць і іншыя ачышчаюцца і іншыя падключаныя прылады (у DCS — таксама іх прывязкі DCS па змаўчанні).

  • DCS World: у Options > Controls выберыце лятальны апарат: вашы прывязкі знаходзяцца ў слупку прылады, выдаленыя прывязкі па змаўчанні паказваюцца пустымі ячэйкамі, вашы мадыфікатары — у спісе мадыфікатараў. Змяняюцца толькі адзначаныя лятальныя апараты. JoyPro запісвае толькі адрозненні ад прывязак DCS па змаўчанні, як гэта робіць сам DCS.
  • IL-2 Great Battles: Settings > Key mapping паказвае вашы прывязкі і водгукі восяў. Радкі мышы і радкі, якіх JoyPro не ведае, застаюцца.
  • IL-2 Korea: профіль раскладкі клавіш «General».
  • Falcon BMS: лаўнчар стварае файл клавіш і раскладку восяў пры наступным Launch, таму запускайце BMS праз лаўнчар.
  • MSFS 2024 / 2020: у Controls прылада паказвае прэсет JoyPro.
  • X-Plane 11 / 12: Settings > Joystick паказвае прызначэнні.
У гульні: Гульні з пяхотай, тэхнікай або меню: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro змяняе толькі лётныя дзеянні (самалёт, верталёт, касмічны карабель). Вашы прывязкі для пешага рэжыму, тэхнікі і меню застаюцца байт у байт. Замяніць і Ачысціць і іншыя вызваляюць толькі тыя лётныя дзеянні, якія ведае JoyPro.

  • Star Citizen: Options > Keybindings паказвае дзеянні карабля на вашых джойсціках (js1, js2, ...). З Замяніць або Ачысціць і іншыя уласныя прывязкі джойсціка гульні па змаўчанні на js1 выключаюцца, калі js1 запісваецца або не выкарыстоўваецца.
  • War Thunder: Controls паказваюць прывязкі лятальных апаратаў; элементы кіравання танкаў і караблёў не змяняюцца.
  • Arma 3 / Arma 2: налады клавіш профілю; змяняюцца толькі дзеянні самалётаў і верталётаў.
У гульні: Касмічныя гульні: Elite Dangerous, X4: Foundations
  • Elite Dangerous захоўвае два ўваходы на дзеянне (Primary і Secondary). Прывязка, для якой няма вольнага месца, атрымлівае пазнаку «Не запісана» з «Перанесці на іншую кнопку» або «Пакінуць як ёсць». Прывязкі для пешага рэжыму і SRV застаюцца.
  • X4: налады ўводу гульні; змяняюцца толькі дзеянні карабля з каталога.
У гульні: Гульні, якія чытаюць адну прыладу або толькі кантролер Xbox
  • Гульні, пастаўленыя на vJoy (гульні, якія чытаюць толькі некалькі прылад): экспарт запісвае прывязкі на прыладу vJoy. Падчас гульні JoyPro капіруе на яе вашы ручкі кіравання, а HidHide хавае вашы рэальныя прылады толькі ад гэтай гульні. Гульня бачыць адну прыладу, на якой ёсць усё. Гл. Віртуальны joystick.
  • Гульні толькі для Xbox (ACE COMBAT 8, Hell Let Loose: Vietnam): нічога не запісваецца, і экспарт пра гэта паведамляе. Ваша ручка кіравання кіруе імітаваным кантролерам (віртуальным геймпадам Xbox), пакуль уключаны Пачаць. HidHide не патрэбны. Гл. Гуляць у гульню толькі для Xbox з HOTAS.
Тэхнічныя падрабязнасці

#Як гэта працуе ўнутры

Адзін экспарт ад пстрычкі да запісаных файлаў:

# Хто Што адбываецца
1 Вы Націсніце Экспартаваць адзначаныя гульні на старонцы «Экспарт».
2 JoyPro Пытае рухавік пра гульню (profile game-state --game <id>): імпартавана, экспартавана, ёсць прывязкі.
3 JoyPro Пытае вас, калі трэба: першы экспарт («Спачатку імпартаваць?») або рэжым, які выдаляе прывязкі (Налады > Пацвярджэнні).
4 Рухавік Запускае <game> export --mode <m> --nuke-untouched-devices <b> ...: адмаўляецца, пакуль гульня працуе, робіць рэзервовую копію кожнага файла (GameBackups і .jpbak) і запісвае толькі дзеянні з каталога.
5 Рухавік Захоўвае запіс сінхранізацыі (адбітак і базавы стан) і пазнакі экспарту, потым адказвае: запісана, прапушчана, SkippedTakenInputs.
6 JoyPro Картка гульні паказвае «Экспартавана: 14:02», і кнопка Адмяніць апошні экспарт гатовая.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) выклікаюць AskAboutFirstExportAsync (engine profile game-state) і ConfirmRiskyExportAsync, потым ExportGameAsync выбірае экспарцёр карткі: dcs, il2, starcitizen або гульню з рэестра гульняў. Каманда будуецца з налад старонкі, напрыклад RunDcsExportAsync: engine dcs export --mode clean --keep-keyboard-defaults true --nuke-untouched-devices true --clean-all-aircraft false --ignore-device <d> --planes F-16C_50|FA-18C_hornet. Кожны выклік рухавіка праходзіць праз адно месца, RunEngineAsync, з --profile і --status true (прагрэс і «Скасаваць» у вобласці занятасці), паслядоўна, каб дзве каманды ніколі не запісвалі адначасова.
  2. Рухавік. engine\Program.cs накіроўвае dcs / il2 / starcitizen да іх экспарцёраў, а кожную іншую гульню — да Games.GameRegistry (адна GameIntegration на гульню). DCS: EngineDcsExport.Modes.cs вылічвае для кожнага файла прылады прывязкі, якія ў DCS актыўныя (чысты профіль мінус removed, плюс added і changed), вырашае, якія павінны быць актыўнымі, і запісвае толькі сапраўдныя адрозненні ад значэнняў па змаўчанні.
  3. Бяспека. GameExportSafety.BackupBeforeOverwrite капіюе кожны файл у <file>.jpbak і ў сховішча рэзервовых копій з версіямі (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ з manifest.json; для кожнай гульні захоўваюцца 30 самых новых набораў). Гульні, якія трымаюць кіраванне ў рэестры (Nuclear Option), атрымліваюць здымак значэнняў, якія яны могуць змяніць. Файл, які стварае экспарт, запісваецца як «не існаваў», таму аднаўленне зноў яго выдаляе.
  4. Пасля. Запіс сінхранізацыі (<data>\Sync\<game>.json: памер, час і SHA-256 для кожнага файла і хэш кожнай прывязкі) не дае назіральніку рэагаваць на ўласную змену JoyPro. ExportSkippedBinds.cs запаўняе SkippedTakenInputs; каманда экспарту ператварае іх у пазнакі профілю. Гісторыя профілю захоўвае кантрольную кропку перад кожным экспартам.

#Файлы, якія атрымлівае кожная гульня

Гульня Файлы
DCS World для кожнага лятальнага апарата і прылады Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, .jp побач з ім, modifiers.lua лятальнага апарата
IL-2 Great Battles data\input\global.actions (новыя радкі ў канцы, парадак захоўваецца), водгукі восей, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS User\Config\Setup.v100.* {GUID}.xml лаўнчара для кожнай прылады
MSFS 2024 / 2020 профілі ўводу (2024: пакет прэсэтаў joypro-input-profiles у папцы Community і профілі Steam)
X-Plane 11 / 12 налады джойсціка ў Output\preferences
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml і actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
Гульні з рэестра гульняў іх файл канфігурацыі і <config>.joypro-meta.json

Пазнакі незапісаных прывязак: engine export-marks list, engine export-marks dismiss. Налады: export-settings.json (ModeChosenByUser); без --mode рухавік па змаўчанні выкарыстоўвае merge-overwrite.

#Кожны рэжым у камандным радку

Выбар у GUI Параметры рухавіка
Замяніць на маіх прыладах + Ачысціць і іншыя мае прылады (па змаўчанні) --mode clean --nuke-untouched-devices true
Замяніць на маіх прыладах --mode clean --nuke-untouched-devices false
Абнавіць, мой профіль мацнейшы (+ Ачысціць і іншыя) --mode merge-overwrite --nuke-untouched-devices true|false
Абнавіць, пакінуць прывязкі гульні (+ Ачысціць і іншыя) --mode merge --nuke-untouched-devices true|false
Толькі дадаць --mode add (nuke не выкарыстоўваецца)

Для кожнай гульні: engine dcs export, engine il2 export, engine starcitizen export і engine <game> export для кожнай гульні з рэестра гульняў (напрыклад engine warthunder export, engine msfs2024 export, engine xplane12 export; кожная прымае --mode, --dry-run, --include-keyboard і --nuke-untouched-devices). Адмена: engine backups restore. Тэсты: engine\tests\smoke\dcsexportmodes.ps1 (кожны рэжым, поўны цыкл, адмена байт у байт) і engine\tests\smoke\roundtrip.ps1 (імпарт, clean + nuke, паўторны імпарт пакідае гульню такой, якой яна была).