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


- Праверце свой профіль. Націсніце Праверыць зараз. JoyPro шукае тое, што пайшло б не так у гульні, напрыклад кнопку, якая робіць дзве рэчы ў адным лятальным апараце. Выпраўце знойдзенае (адна пстрычка на праблему) або пакіньце як ёсць; праверка ніколі не блакуе экспарт. Гл. Праверка.
- Як JoyPro запісвае ў гульні. Выберыце адзін з чатырох варыянтаў. Калі не ўпэўнены, пакіньце першы: Замяніць на маіх прыладах з адзначаным Ачысціць і іншыя мае прылады. Тады вашы ручкі кіравання робяць дакладна тое, што кажа ваш профіль, і нічога больш.
- Экспарт у гульні. Кожная гульня, для якой у вашым профілі ёсць прывязкі, атрымлівае картку з малюнкам. Адзначце гульні і націсніце Экспартаваць адзначаныя гульні або націсніце Экспартаваць зараз на адной картцы.
Спачатку закрыйце гульню. Гульні запісваюць свае файлы кіравання пры выхадзе, таму 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 запісвае толькі дзеянні са свайго спіса каманд, адмаўляецца запісваць, пакуль гульня працуе, спачатку робіць рэзервовую копію файлаў і ніколі не адгадвае прыладу або дзеянне, якое не можа супаставіць (ён прапускае іх з папярэджаннем).
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 паказвае прызначэнні.
JoyPro змяняе толькі лётныя дзеянні (самалёт, верталёт, касмічны карабель). Вашы прывязкі для пешага рэжыму, тэхнікі і меню застаюцца байт у байт. Замяніць і Ачысціць і іншыя вызваляюць толькі тыя лётныя дзеянні, якія ведае JoyPro.
- Star Citizen: Options > Keybindings паказвае дзеянні карабля на вашых джойсціках (js1, js2, ...). З Замяніць або Ачысціць і іншыя уласныя прывязкі джойсціка гульні па змаўчанні на js1 выключаюцца, калі js1 запісваецца або не выкарыстоўваецца.
- War Thunder: Controls паказваюць прывязкі лятальных апаратаў; элементы кіравання танкаў і караблёў не змяняюцца.
- Arma 3 / Arma 2: налады клавіш профілю; змяняюцца толькі дзеянні самалётаў і верталётаў.
- Elite Dangerous захоўвае два ўваходы на дзеянне (Primary і Secondary). Прывязка, для якой няма вольнага месца, атрымлівае пазнаку «Не запісана» з «Перанесці на іншую кнопку» або «Пакінуць як ёсць». Прывязкі для пешага рэжыму і SRV застаюцца.
- X4: налады ўводу гульні; змяняюцца толькі дзеянні карабля з каталога.
- Гульні, пастаўленыя на 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», і кнопка Адмяніць апошні экспарт гатовая. |
- 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(прагрэс і «Скасаваць» у вобласці занятасці), паслядоўна, каб дзве каманды ніколі не запісвалі адначасова. - Рухавік.
engine\Program.csнакіроўваеdcs/il2/starcitizenда іх экспарцёраў, а кожную іншую гульню — даGames.GameRegistry(аднаGameIntegrationна гульню). DCS:EngineDcsExport.Modes.csвылічвае для кожнага файла прылады прывязкі, якія ў DCS актыўныя (чысты профіль мінусremoved, плюсaddedіchanged), вырашае, якія павінны быць актыўнымі, і запісвае толькі сапраўдныя адрозненні ад значэнняў па змаўчанні. - Бяспека.
GameExportSafety.BackupBeforeOverwriteкапіюе кожны файл у<file>.jpbakі ў сховішча рэзервовых копій з версіямі (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\зmanifest.json; для кожнай гульні захоўваюцца 30 самых новых набораў). Гульні, якія трымаюць кіраванне ў рэестры (Nuclear Option), атрымліваюць здымак значэнняў, якія яны могуць змяніць. Файл, які стварае экспарт, запісваецца як «не існаваў», таму аднаўленне зноў яго выдаляе. - Пасля. Запіс сінхранізацыі (
<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, паўторны імпарт пакідае гульню такой, якой яна была).
#Звязанае
- Старонка «Экспарт», кожны элемент на ёй
- Праверка перад экспартам
- Даведнік па экспарце і Рэзервовыя копіі канфігурацый гульняў
- Падтрымка гульняў: што JoyPro робіць для кожнай гульні