Експорт — це крок, після якого ваші ручки керування працюють у грі. JoyPro записує ваші зв'язки й прив'язки у файли налаштувань керування кожної гри — ті самі файли, які зберігає власне меню керування гри. Під час польоту у фоні нічого не працює: після експорту гра, як завжди, читає власні файли.
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: профіль key mapping «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: «Елементи керування» показують прив'язки літаків; керування танками й кораблями не змінюється.
- 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 робить для кожної гри