Експортирането е стъпката, която кара ръчките ви да работят в играта. 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. |
| Kneeboard в DCS | Не е експортиране на назначения: страница за всеки самолет, която изброява какво правят бутоните ви, в кабината. Вижте kneeboard. |
#Режимите в подробности
„Същият вход“ означава същото устройство, същия бутон или ос и същите модификатори, в същия самолет (или кораб, превозно средство), когато играта пази назначения за всеки самолет. Всеки режим работи само в самолетите на експортирането.
| Само добавяне | Актуализиране, запазване | Актуализиране, профилът печели | Замяна | |
|---|---|---|---|---|
| Вашите назначения | записват се там, където входът е свободен | описани | описани | описани |
| Назначение на играта на вход, който използвате за друго действие | запазва се; вашето назначение не се записва и се отбелязва | премахва се | премахва се | премахва се |
| Назначение на играта за същото действие на друг вход (след преместване) | запазено | запазва се (действието е и на двата входа) | премахва се | премахва се на записаните устройства |
| Други назначения на играта на вашите устройства | запазено | запазено | запазено | премахват се |
| Стойности по подразбиране на играта на вашите устройства | запазено | запазено | запазват се, освен ако не носят някое от вашите действия | премахват се |
| Свързани устройства без назначения в профила | запазено | запазено | вашите действия се премахват от тях | запазват се, освен при Изчистване и на другите ми устройства |
| Устройства, които не са свързани, мишка, геймпад | никога не се докосват | никога не се докосват | никога не се докосват | никога не се докосват |
| Клавиатура | само с опцията за клавиатура | само с опцията за клавиатура | само с опцията за клавиатура | само с опцията за клавиатура |
| Самолети, които не са в експортирането | никога не се докосват | никога не се докосват | никога не се докосват | никога не се докосват (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 показва действията на кораба на вашите joystick-и (js1, js2, ...). При Замяна или Изчистване и на другите собствените назначения по подразбиране на играта за joystick на 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 | предпочитанията за joystick в 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 за всяка игра